Skip to main content

GitLab

Visualize GitLab users, groups, code repositories, and merge requests, map GitLab users to employees and development/security trainings, and monitor changes through queries and alerts.

Installation​

info

To use this integration, JupiterOne requires a GitLab personal access token configured with read access (the read_api scope) and the API base URL, such as https://gitlab.com or your self-managed instance URL.

Configuration in JupiterOne​

To install the GitLab integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select GitLab. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

  • Account Name by which you'd like to identify this GitLab account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when Tag with Account Name is selected.

  • Description that will further assist your team when identifying the integration instance.

  • Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

  • Personal Access Token configured for read access in GitLab. Create it from your GitLab profile under Access > Personal access tokens, select the read_api scope (the Users data source also uses read_user), and copy the token value.

note

Once your token has expired, the integration will no longer run successfully, and the token will be revoked from your GitLab account. You will need to create another token to replace the expired one.

  • Your GitLab API Base URL (e.g., https://gitlab.com, or your self-managed instance URL).

  • Findings Personal Access Token, if needed. This optional second token is used only when ingesting vulnerability findings, to work around a GitLab issue where the primary token cannot read vulnerabilities. Provide it only if your findings ingestion fails with the primary token.

note

Some data sources require a higher GitLab subscription tier or role. Vulnerability findings require GitLab Ultimate; push rules and merge request approval rules require Premium or Ultimate. The Personal Access Tokens data source lists every token in the instance only when the token belongs to an instance Administrator, and group access tokens require the Owner role on the group.

Data Volume Configuration​

Control how much data is ingested from GitLab to manage storage and processing.

Ingestion Windows (Time Ranges)​

FieldDescriptionDefaultOptions
Merge Requests Ingestion WindowIngestion window for updated merge requests (days ago)9090, 180, 275, 365
Pipelines Ingestion WindowIngestion window for updated pipelines (days ago)907, 30, 90, 180, 365

How it affects data volume: Longer windows increase the number of merge requests and pipelines ingested from GitLab.

Data Filtering Options​

FieldTypeDescriptionDefault
Included Vulnerability SeveritiesMulti-selectSelect vulnerability severities to ingestMedium, High, Critical
Included Vulnerability StatesMulti-selectSelect vulnerability states to ingestConfirmed, Detected
Included Vulnerability Report TypesMulti-selectSelect vulnerability report types to ingestNone (all disabled by default)
Ingest Regular Users OnlyBooleanSkip all bot accounts including project and group botsfalse

How it affects data volume:

  • Severity filtering reduces vulnerabilities by excluding lower-severity findings. By default, only Medium, High, and Critical severabilities are ingested.
  • State filtering limits vulnerabilities to selected states. By default, only Confirmed and Detected vulnerabilities are ingested (Dismissed and Resolved are excluded).
  • Report type filtering allows selecting specific vulnerability scan types (SAST, DAST, Container Scanning, etc.). By default, all types are disabled and must be explicitly enabled.
  • User filtering, when enabled, excludes bot accounts from ingestion, reducing the number of user entities.

Advanced Configuration​

FieldDescriptionDefault
Disable project membershipWhen enabled, the integration retrieves all projects visible to the authenticated token instead of only those where the token's user is a direct member. This can increase the number of projects ingested.Disabled

Click Create after all values are provided to finalize the integration.

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.