EV Observe - Configure the GLPI Ticketing System

Last modified on 2022/10/14 20:23
Contents

Note: GLPI is in constant development. As such, some of the screens shown in the procedures below may be different from the ones in the final interface.

This ticketing integration is used to create and synchronize tickets in both GLPI and EV Observe.

  • A ticket can be created in GLPI when a monitoring alert is acknowledged for a service or host in EV Observe. Open url.png See Ticketing integration - Overview
  • You can view information on the GLPI ticket in the EV Observe service or host.
  • To set up this integration, you must first perform the cross-reference mapping between some of EV Observe information and GLPI information.

Notes

  • Integration is performed using the GLPI REST API.
  • Validated versions: GLPI versions 9.1, 9.1.1, 9.1.2, 9.1.6, 9.3 (without CAS authentication as the GLPI bug that occurs with CAS authentication + API is only corrected in version 9.4.2)

Caution

  • To optimize performance, only one call is made to the GLPI Web service for processing the list of tickets. If this list of tickets to be synchronized contains one or more tickets that no longer exist in GLPI, e.g. ticket permanently deleted from the recycle bin, the Web service will generate an error and the integration will not update the list of tickets. To prevent this, you should avoid permanently deleting any open ticket in monitoring.
  • Based on your context, check which fields are mandatory in GLPI for creating tickets. If mandatory fields are considered optional by the integration, the integration will not run correctly.

Cross-reference mapping between EV Observe and GLPI

  • The first column in the table displays the ticket field in GLPI.
  • The second column displays operating rules for the integration.
  • The third column indicates the mandatory fields required to ensure that the integration runs correctly.
GLPI field Operating rules Mandatory
Entity 
  • An EV Observe company or site corresponds to a GLPI entity.
  • The link between the GLPI entity and the EV Observe company or site is indicated in the EV Observe form.
  • You must configure one link for each EV Observe site.
 Yes
Type 
  • Non-modifiable default value: Incident
 N/A
Category 
  • Fixed value defined in the integration configuration
  • Optional field specified in the integration information. Enter the full name, cat 1 > cat 2 > cat 3 (identical to the display in GLPI)
  • The category is not displayed in the EV Observe ticket creation form.
  • Check that the value exists by testing the connection in the EV Observe Web app and when creating tickets.
 No
Requester 
  • The requester is the user declared in EV Observe (Administration > External connections > External connections > User field).
 Yes
Observer Not used by the integration N/A
Assigned to Not used by the integration N/A
Request source 
  • This field is used to determine the rate of tickets opened since the start of EV Observe monitoring.
  • Non-modifiable default value: Monitoring
  • The value is defined in the integration configuration.
  • GLPI prerequisites: You must create the source if it does not exist.
 Yes
Associated elements 
  • Values preloaded with the EV Observe host corresponding to the alert.
  • You can modify this field when creating tickets in EV Observe.
  • The mapping key is the name of the EV Observe host.
  • If the record is found, the list of hosts for the site will appear with the field value initialized by the record.
  • If no record is found, the list of hosts for the entity will appear without any preselection.
 No
Title 
  • For a host: Host XXX - IP address: YYY - YYY status
  • For a service: Service XXX for host YYY (IP address: YYY) - ZZZ status
  • The title is displayed in the EV Observe ticket creation form.
  • You can modify this field when creating tickets in EV Observe.
 Yes
Description 
  • For a host: Details/description of the alert generated by EV Observe
  • For a service: Details/description of the alert generated by EV Observe
  • The description is displayed in the EV Observe ticket creation form.
  • You can modify it when creating tickets in EV Observe.
 Yes
Opening date 
  • This field is used to calculate the processing time of incidents.
  • The ticket is created by initializing the date based on the configuration of the control:
    • No cross-check: start date of the SOFT/HARD state (in this case, identical)
    • Cross-check: start date of the HARD state (confirmed)
 N/A
Status 
  • Non-modifiable default value: New
 N/A

Procedure: How to configure the GLPI ticketing system

Configuration in GLPI

Step 1: Create a user whose profile is super-admin

Note : This profile  super-admin has all of the configuration and setup rights for the application.

Caution: From version 9.3 onwards, you must specify by default the supervisor profile in addition to the super-admin profile. The supervisor profile must also have read access to categories and sources.

Best Practice icon.png  You should enable maximum pagination for the profile, especially if there are numerous categories and/or sources.

Specific case of authentication delegation (SSO)

User authentication in GLPI can be integrated (SSO) and then delegated to an LDAP directory and performed automatically. You define this configuration in the Web server.
In Apache, you can do this by including an authentication module and the NTLMAuthHelper clause in the Apache configuration file.

Caution: The REST API does not support this type of authentication. You should therefore retain the Basic authentication method and exclude the IP address of the EV Observe platform from the integrated authentication. This platform is the one that sends requests to the GLPI REST API.

example  Functional Apache configuration, to be adapted based on requirements

<Directory /var/www/html/glpi>
AllowOverride All
Order allow,deny
Options Indexes
Allow from all
NTLMAuth on
NTLMBasicAuth on
NTLMBasicRealm xxxxx
AuthType NTLM
AuthName ‘<nom de l'utilisateur>’
NTLMAuthHelper "/usr/bin/ntlm_auth –helper-protocol=squid-2.5-ntlmssp"
NTLMBasicAuthoritative off
require valid-user
Require local
require ip x.y.z.t
</Directory>

Step 2: Generate an API and a token

1. Select Setup > General > API in the menu.

2. Generate an API and a token.

  • Specify the URL of the API.
  • Select Yes in the Enable REST API field.
  • Select Yes in the Enable login with credentials field.
  • Select Yes in the Enable login with external token field.
  • Click Save.

            GLPI - Create API and token.png

3. Authorize access to EV Observe by specifying its IP address.

  • Click Add API client.
  • Authorize access to EV Observe by specifying the IP address of the EV Observe server or by specifying a range of IP addresses.
               GLPI - Create API client.png
     

Step 3: Create a Monitoring request source for GLPI tickets

1. Select Setup > Dropdowns > Request Sources in the menu.

2. Create a new request source.

  • Name it Monitoring.
  • Select Yes in the Request source visible for tickets field.
    The Monitoring request source will be assigned to all tickets from EV Observe.
     

Step 4 (optional): Create a category

1. Select Setup > Dropdowns > Ticket Categories.

2.Create a new category.

  • Select Yes in the Category source visible for tickets field.

Configuration in EV Observe

Step 1: Create a GLPI connector

1. Go to the Web app.

2. Create a GLPI connector.

  • Select Administration > External connections > External connections in the menu.
  • Click + Add.
          EV Observe - GLPI connector configuration.png

3. Specify the information below.

  • Type: Select the GLPI Web service connector.
  • Version: Enter 9.1.
  • Module: Select the Ticketing value.
  • Specify the User / Password fields.
  • Specific information: Specify the fied in the following format, {"app_token":"xxx", "category":"xxx", "source":"xxx"} using the values configured in GLPI.
    • The app_token parameter is mandatory.
    • The source parameter is mandatory. If the value is specified, it must exist in GLPI.
    • The category parameter is optional. If the value is specified, it must exist in GLPI.

example  

{"app_token":"wsdkiqchmavuaz9XXXXXXXXXXXz9g", "category":"", "source": "Monitoring"}

4. Click Test to check that the connector is correctly configured.

Note: The host not found error message may appear. This is a known error that does not prevent the integration from running correctly.

5. Click Apply.
 

 Step 2: Associate the company with the GLPI entity

1. Select Organization > Sites in the menu.

2. Select the company and click Update.

3. Specify the CRM link field.

        EV Observe - GLPI company configuration.png

Tags:
Powered by XWiki © EasyVista 2022