SaaS Management integrates directly with GitLab SaaS to retrieve all user activity within the application. The integration gives you the usage data you need to make informed decisions on inactive licenses and any renewal or purchasing options.
SaaS Management does not access or request access to your code or commits.
Integrating with GitLab SaaS
SaaS Management pulls in a list of user and event data from your GitLab top-level group, including data from all subgroups within that top-level group. To complete the integration, you must copy and paste your GitLab top-level group ID into SaaS Management.
You must be assigned the Owner role for the top-level group to connect SaaS Management with your GitLab SaaS instance.
Before you integrate the applications, make sure you have signed out of your individual account within your organization and are signed in to the appropriate service account with the required permissions.
Copying your Top-level Group ID from GitLab SaaS
Log in to your GitLab account with the appropriate permission.
On the Groups page, select the top-level group, the parent group of all subgroups.
If there are multiple top-level groups, you must create multiple integrations. You can only map one top-level group to an integration instance.
You’ll enter the Group ID in SaaS Management to connect GitLab SaaS to the application.
Connecting your GitLab SaaS account
Select the Integrations tab from the SaaS Management navigation menu.
Select the GitLab SaaS tile.
Select Add Integration.
Enter the Group ID from GitLab SaaS in the Your GitLab Top-level Group ID field and select Submit.
Select Authorize to accept the requested permissions and complete the integration.
Your GitLab SaaS data will begin syncing immediately and should complete within 24 hours.
SaaS Management requests the following scopes:
|read_api||Grants read access to the API, including all groups and projects, the container registry, and the package registry. This access allows SaaS Management to pull user data as well as every change to a pull request or issue.|
SaaS Management pulls the following user metadata from GitLab SaaS. You can filter your usage data by these fields:
|State||The user's current state.|
|Membership Type||The user's membership type.|
|Removable||Indicates whether the billable member can be removed from a group and its subgroups and projects.|