Skip to main content

GLPI

This Integration is part of the GLPI Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.2.0 and later.

GLPI open source ITSM solution This integration was integrated and tested with version 9.5.5 of GLPI

Configure GLPI on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for GLPI.

  3. Click Add instance to create and configure a new integration instance.

    ParameterRequired
    Server URL (e.g. https://example.net/apirest.php)True
    Application TokenTrue
    User TokenTrue
    Fetch incidentsFalse
    Incident typeFalse
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
    Incidents Fetch IntervalFalse
    Long running instanceFalse
    Maximum number of incidents to mirror each timeFalse
    Incident Mirror DirectionFalse
    Tag used for work note mirroringFalse
    Tag used for comment mirroringFalse
    Tag used for file mirroringFalse
    First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days)False
    Max incidents fetch at the same timeFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

glpi-create-user#


Create a new GLPI user

Base Command#

glpi-create-user

Input#

Argument NameDescriptionRequired
nameLogin.Required
firstnameFirstname.Optional
lastnameLastname.Optional
emailEmail address.Optional
passwordPassword.Required
profileProfile name.Optional
additional_fieldsAdditional fields in the format: fieldname1=value;fieldname2=value;.Optional

Context Output#

PathTypeDescription
GLPI.User.idunknownCreated user ID
GLPI.User.messageunknownUser creation message

glpi-delete-user#


Delete GLPI user

Base Command#

glpi-delete-user

Input#

Argument NameDescriptionRequired
nameUsername.Required
purgeDefault : False, will use the trash, use True to definitively remove the user from the system. Possible values are: True, False. Default is False.Optional

Context Output#

There is no context output for this command.

glpi-disable-user#


Disable GLPI user

Base Command#

glpi-disable-user

Input#

Argument NameDescriptionRequired
nameUsername.Required

Context Output#

There is no context output for this command.

glpi-enable-user#


Enable GLPI user

Base Command#

glpi-enable-user

Input#

Argument NameDescriptionRequired
nameUsername.Required

Context Output#

There is no context output for this command.

get-mapping-fields#


Return the list of fields for an incident type

Base Command#

get-mapping-fields

Input#

Argument NameDescriptionRequired

Context Output#

There is no context output for this command.

get-modified-remote-data#


Mirroring feature, use only for debug

Base Command#

get-modified-remote-data

Input#

Argument NameDescriptionRequired
lastUpdatelastUpdate parameter. Possible values are: .Optional

Context Output#

There is no context output for this command.

glpi-get-username#


Get username by user ID

Base Command#

glpi-get-username

Input#

Argument NameDescriptionRequired
idUser ID.Required

Context Output#

PathTypeDescription
GLPI.UserUnknownGLPI User details
GLPI.User.idunknownUser id
GLPI.User.usernameunknownUsername

glpi-delete-ticket#


Delete GLPI ticket

Base Command#

glpi-delete-ticket

Input#

Argument NameDescriptionRequired
ticket_idTicket ID.Required
purgeDefault : False, will use the trash, use True to definitively remove the ticket from the system. Possible values are: False, True. Default is False.Optional

Context Output#

There is no context output for this command.

glpi-get-ticket#


Get ticket details by ticket ID

Base Command#

glpi-get-ticket

Input#

Argument NameDescriptionRequired
ticket_idThe Ticket ID.Required
get_attachmentsIf "True" will retrieve ticket attachments. Default is "False". Possible values are: False, True. Default is False.Optional

Context Output#

PathTypeDescription
GLPI.Ticket.actiontimeUnknownTicket action time
GLPI.Ticket.begin_waiting_dateUnknownTicket begin waiting date
GLPI.Ticket.close_delay_statUnknownTicket close delay stat
GLPI.Ticket.closedateUnknownTocket closed date
GLPI.Ticket.contentUnknownTicket content
GLPI.Ticket.dateUnknownTicket date
GLPI.Ticket.date_creationUnknownTicket date creation
GLPI.Ticket.date_modUnknownTicket date modification
GLPI.Ticket.entities_idUnknownTicket entities ids
GLPI.Ticket.global_validationUnknownTicket global validation
GLPI.Ticket.idUnknownTicket ID
GLPI.Ticket.impactUnknownTicket Impact
GLPI.Ticket.internal_time_to_ownUnknownTicket internal time to own
GLPI.Ticket.internal_time_to_resolveUnknownTicket internal time to resolve
GLPI.Ticket.is_deletedUnknownTicket is_deleted?
GLPI.Ticket.itilcategories_idUnknownTicket ITIL categories id
GLPI.Ticket.linksUnknownTicket links
GLPI.Ticket.locations_idUnknownTickets locations id
GLPI.Ticket.nameUnknownTicket name
GLPI.Ticket.ola_ttr_begin_dateUnknownTicket ola ttr begin date
GLPI.Ticket.ola_waiting_durationUnknownTicket ola waiting duration
GLPI.Ticket.olalevels_id_ttrUnknownTicket ola levels id ttr
GLPI.Ticket.olas_id_ttoUnknownTicket olas id tto
GLPI.Ticket.olas_id_ttrUnknownTicket olas id ttr
GLPI.Ticket.priorityUnknownTicket priority
GLPI.Ticket.requesttypes_idUnknownTicket request types id
GLPI.Ticket.sla_waiting_durationUnknownTicket sla waiting duration
GLPI.Ticket.slalevels_id_ttrUnknownTicket slale levels id ttr
GLPI.Ticket.slas_id_ttoUnknownTicket slas id tto
GLPI.Ticket.slas_id_ttrUnknownTicket stats id ttr
GLPI.Ticket.solve_delay_statUnknownTicket solve delay stat
GLPI.Ticket.solvedateUnknownTicket solve date
GLPI.Ticket.statusUnknownTicket status
GLPI.Ticket.takeintoaccount_delay_statUnknownTicket take into account delay stat
GLPI.Ticket.time_to_ownUnknownTicket time to own
GLPI.Ticket.time_to_resolveUnknownTicket time to resolve
GLPI.Ticket.typeUnknownTicket type
GLPI.Ticket.urgencyUnknownTicket urgency
GLPI.Ticket.users_id_lastupdaterUnknownTicket users id last updater
GLPI.Ticket.users_id_recipientUnknownTicket users id recipient
GLPI.Ticket.validation_percentUnknownTicket validation percent
GLPI.Ticket.waiting_durationUnknownTicket waiting duration
File.InfostringAttachment file info.
File.NameunknownAttachment file name.
File.SizenumberAttachment file size.
File.SHA1stringAttachment file SHA1 hash.
File.SHA256stringAttachment file SHA256 hash.
File.EntryIDstringAttachment file entry ID.
File.TypestringAttachment file type.
File.MD5stringAttachment file MD5 hash.

glpi-create-ticket#


Create a GLPI ticket

Base Command#

glpi-create-ticket

Input#

Argument NameDescriptionRequired
nameTicket name.Required
contentTicket description.Required
typeTicket type. Possible values are: Incident, Request.Required
statusTicket status. Possible values are: New, Processing(assigned), Processing(planned), Pending, Solved, Closed.Optional
urgencyTicket urgency. Possible values are: Veryhigh, High, Medium, Low, Verylow.Optional
impactTicket impact. Possible values are: Veryhigh, High, Medium, Low, Verylow.Optional
priorityTicket priority. Possible values are: Major, Veryhigh, High, Medium, Low, Verylow.Optional
entryidFile EntryID to upload , multiple files supported.Optional
entities_idTicket entities ID.Optional
locations_idTicket locations ID.Optional
itilcategories_idTicket ITIL categories ID.Optional
time_to_resolveTicket time to resolve, in the format: YYYY-MM-DD HH:MM:SS.Optional
time_to_ownTicket time to own, in the format: YYYY-MM-DD HH:MM:SS.Optional
internal_time_to_resolveTicket internal time to resolve, in the format: YYYY-MM-DD HH:MM:SS.Optional
internal_time_to_ownTicket internal time to own, in the format: YYYY-MM-DD HH:MM:SS.Optional
requesttypes_idTicket Request source. Possible values are: Direct, E-Mail, Helpdesk, Other, Phone, Written.Optional
additional_fieldsAdditional fields in the format: fieldname1=value;fieldname2=value;.Optional

Context Output#

PathTypeDescription
GLPI.Ticket.idunknownThe created ticket ID
GLPI.Ticket.messageunknownResult message from ticket creation

glpi-search#


Search GLPI items

Base Command#

glpi-search

Input#

Argument NameDescriptionRequired
item_typeItem type to search (ex : Ticket).Required
queryThe search query, please visit https://github.com/glpi-project/glpi/blob/master/apirest.md#search-items.Optional
forcedisplayComa separated additional fields to display.Optional
srangeSearch range limit (ex : 0-50).Optional

Context Output#

PathTypeDescription
GLPI.SearchunknownSearch results
GLPI.Search.item_typeunknownThis varies depending on the input item_type (case sensitive)

glpi-add-comment#


Add comment to ticket ID

Base Command#

glpi-add-comment

Input#

Argument NameDescriptionRequired
ticket_idThe ticket ID.Required
commentticket comment. Possible values are: .Required

Context Output#

PathTypeDescription
GLPI.Comment.idunknownCreated comment ID
GLPI.Comment.messageunknownGLPI message

glpi-upload-file#


Upload document

Base Command#

glpi-upload-file

Input#

Argument NameDescriptionRequired
entryidFile EntryID. Possible values are: .Required
filenameFilename. Possible values are: .Optional
doc_nameDoc name. Possible values are: .Optional

Context Output#

PathTypeDescription
GLPI.DocumentUnknownDocument
GLPI.Document.idunknownCreated document ID
GLPI.Document.messageunknownGLPI upload message
GLPI.Document.upload_result.filename.sizeunknownUploaded file size
GLPI.Document.upload_result.filename.displayunknownFile display name
GLPI.Document.upload_result.filename.deleteUrlUnknownDocument deleteURL
GLPI.Document.upload_result.filename.deleteTypeUnknownDocument deleteType
GLPI.Document.upload_result.filename.nameunknownsystem file name
GLPI.Document.upload_result.filename.urlunknownDocument URL
GLPI.Document.upload_result.filename.idUnknownDocument filename id

glpi-get-item#


Get item details by item type and item ID

Base Command#

glpi-get-item

Input#

Argument NameDescriptionRequired
item_typeItem type. Possible values are: .Required
item_idItem ID. Possible values are: .Required

Context Output#

PathTypeDescription
GLPI.item_typeunknownThis varies depending on the input item_type (case sensitive)

glpi-update-ticket#


Update a GLPI ticket

Base Command#

glpi-update-ticket

Input#

Argument NameDescriptionRequired
idTicket id.Required
descriptionTicket description.Optional
typeTicket type. Possible values are: Incident, Request.Optional
statusTicket status. Possible values are: New, Processing(assigned), Processing(planned), Pending, Solved, Closed.Optional
urgencyTicket urgency. Possible values are: Veryhigh, High, Medium, Low, Verylow.Optional
impactTicket impact. Possible values are: Veryhigh, High, Medium, Low, Verylow.Optional
priorityTicket priority. Possible values are: Major, Veryhigh, High, Medium, Low, Verylow.Optional
entryidFile EntryID to upload , multiple files supported.Optional
entities_idTicket entities ID.Optional
locations_idTicket locations ID.Optional
itilcategories_idTicket ITIL categories ID.Optional
global_validationGlobal validation. Possible values are: .Optional
time_to_resolveTicket time to resolve, in the format: YYYY-MM-DD HH:MM:SS.Optional
time_to_ownTicket time to own, in the format: YYYY-MM-DD HH:MM:SS.Optional
internal_time_to_resolveTicket internal time to resolve, in the format: YYYY-MM-DD HH:MM:SS.Optional
internal_time_to_ownTicket internal time to own, in the format: YYYY-MM-DD HH:MM:SS.Optional
additional_fieldsAdditional fields in the format: fieldname1=value;fieldname2=value;.Optional

Context Output#

PathTypeDescription
GLPI.Ticket.idunknownThe updated ticket ID
GLPI.Ticket.messageunknownResult message from ticket update

get-remote-data#


get remote data command

Base Command#

get-remote-data

Input#

Argument NameDescriptionRequired
idticket id. Possible values are: .Optional
lastUpdatelast update parameter. Possible values are: .Optional

Context Output#

There is no context output for this command.

glpi-add-link#


Link tickets

Base Command#

glpi-add-link

Input#

Argument NameDescriptionRequired
ticket_ID_1First ticket ID.Required
ticket_ID_2Second ticket ID.Required
linkRelation between tickets. Possible values are: Link, Duplicate, Child, Parent.Required

Context Output#

There is no context output for this command.

glpi-update-user#


Update a user

Base Command#

glpi-update-user

Input#

Argument NameDescriptionRequired

Context Output#

There is no context output for this command.