====== GitLab ======

{{indexmenu_n>19}}

[[:en:documentation:start| Back to Pandora FMS documentation index]]

**Integria IMS** allows the visualization of tickets created in [[https://about.gitlab.com/company/|GitLab]]. Thanks to this functionality, you can have visibility of all tickets within the same tool.


===== Settings =====

In order to access the list of GitLab tickets, the first thing we have to do is activate it in the **Setup **in the corresponding tab and enter the necessary data to connect to **GitLab**.

{{ :wiki:iims-08_integrations-02_gitlab-img010.png?direct& }}

We need an access token that belongs to a GitLab user with permissions to view the tickets of the project we are interested in.

Creating personal access token in GitLab:

    - Login to GitLab.
   - In the upper right corner, select the avatar icon.
   - Edit profile.
   - Access tokens.
   - Enter name and optional expiration date for the token.
   - Select the desired areas.
   - Keep the personal access token in a safe place. **After leaving the page, we will no longer have access to the token.**

{{ :wiki:iims-08_integrations-02_gitlab-img020.png?direct& }}

We also need the URL of the project. Example:
<code>

https://example.es:8080/api/v4/projects/1/

</code>

And the base URL of the images to be able to load the images that contain the tickets in their description and in their comments. Example:

<code>
https://example.es:8080/artica/integria/

</code>

{{ :wiki:iims-08_integrations-02_gitlab-img030.png?direct& }}

In order to access the menu in the following image, in addition to having the token active in the Configuration section, we must have the appropriate profile applied or be an administrator user.

{{ :wiki:iims-08_integrations-02_gitlab-img040.png?direct& }}

===== Profile Management =====

To give access to the GitLab menu, in addition to activating the configuration token, you have to assign the permission to the desired profiles.{{ :wiki:iims-08_integrations-02_gitlab-img050.png?direct& }}

Here is an example profile for the ticket view:{{ :wiki:iims-08_integrations-02_gitlab-img060.png?direct& }}

We will mark the option **Gitlab View**. And as a note, it should be remembered that it will be necessary to have permissions on the **Tickets ** section to be able to access the list of GitLab tickets as shown in the previous image.

===== Uploading tickets from GitLab to Integria IMS =====

To load tickets from GitLab, just run the file found in ''operation/incidents/load_issues_gitlab.php'' from a terminal or by accessing it from Integria IMS.

{{ :wiki:iims-08_integrations-02_gitlab-img070.png?direct& }}Once the upload is done, you can check the list of tickets from GitLab.

===== Viewing tickets =====

The list of tickets is accessed from the **Support** menu –> **GitLab Issues**.{{ :wiki:iims-08_integrations-02_gitlab-img080.png?direct& }}This is a list only for viewing tickets. **It is not possible to edit it**. You can refine your search using the filters: keyword in title or description, ticket status, milestone to which the ticket belongs, tags assigned to it, and date range of creation.{{ :wiki:iims-08_integrations-02_gitlab- img090.png?direct& }}{{ :wiki:iims-08_integrations-02_gitlab-img100.png?direct& }}

To see the detail, click on the GitLab ID or on the ticket title.{{ :wiki:iims-08_integrations-02_gitlab-img110.png?direct& }}

The details of the ticket, its description and comments, if any, are displayed.

[[:en:documentation:start| Back to Pandora FMS documentation index]]