Skip to content
Last updated

GitLab integration

GitLab is a DevOps platform that provides source code management, CI/CD pipelines, issue tracking, and project management. Integrating GitLab with Frontegg allows your application to manage projects, issues, and merge requests on behalf of your users through OAuth 2.0 authentication.


Prerequisites

Connect GitLab

Step 1: Open the OAuth applications page

Sign in to GitLab and navigate to User Settings → Applications at https://gitlab.com/-/user_settings/applications. This page lists all OAuth applications registered under your account.

Click Add new application.

GitLab User Settings Applications page

Step 2: Fill in the application details

On the Add new application form, enter the following:

FieldValue
NameA descriptive name, e.g., Frontegg Integration
Redirect URIThe Frontegg callback URIs (see below)
ConfidentialCheck this box for server-side applications

In the Redirect URI field, enter the callback URI:

https://YOUR_MCP_GATEWAY_URL/integration-callback

GitLab new application form

Step 3: Select OAuth scopes

In the Scopes section, select the scopes required for your integration:

ScopeDescription
read_apiRead-only API access to all groups, projects, and packages
read_userRead user profile information
read_repositoryRead-only access to repositories
write_repositoryRead-write access to repositories

Minimum required scopes

For basic functionality, select at minimum: read_api and read_user.

Click Save application.

GitLab application form with scopes selected

Step 4: Copy your credentials

After saving, GitLab displays the Application ID (Client ID) and a Secret (Client Secret). Copy both values immediately and store them securely.

Keep your credentials secure

The Client Secret is shown only once. If you lose it, click Renew secret to generate a new one — this will invalidate the previous secret.

GitLab application credentials

Configure the Frontegg portal

Once you have the Application ID (Client ID) and Secret (Client Secret) from the steps above, enter them in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → GitLab.
  2. Enter the Client ID and Client Secret in the corresponding fields.
  3. Select the required scopes.
  4. Click Save.

Additional resources