{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"GitLab integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"gitlab-integration","__idx":0},"children":["GitLab integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A GitLab account with access to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://gitlab.com/-/user_settings/applications"},"children":["User Settings"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-gitlab","__idx":1},"children":["Connect GitLab"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-the-oauth-applications-page","__idx":2},"children":["Step 1: Open the OAuth applications page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sign in to GitLab and navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Settings → Applications"]}," at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://gitlab.com/-/user_settings/applications"]},". This page lists all OAuth applications registered under your account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add new application"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/gitlab-1.eedf6827fb5731747865bd53dac3f593247db7f32dc39ae6fbd0e553944bef45.1ce25488.png","alt":"GitLab User Settings Applications page"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-fill-in-the-application-details","__idx":3},"children":["Step 2: Fill in the application details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add new application"]}," form, enter the following:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A descriptive name, e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URI"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Frontegg callback URIs (see below)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Confidential"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check this box for server-side applications"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URI"]}," field, enter the callback URI:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://YOUR_MCP_GATEWAY_URL/integration-callback\n"},"children":[]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/gitlab-2.730bab9f8b7659b91bac700198af12f1ca3c285a90d6267d37f7f2278deba42c.1ce25488.png","alt":"GitLab new application form"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-select-oauth-scopes","__idx":4},"children":["Step 3: Select OAuth scopes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scopes"]}," section, select the scopes required for your integration:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read_api"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only API access to all groups, projects, and packages"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read_user"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read user profile information"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read_repository"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only access to repositories"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["write_repository"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-write access to repositories"]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Minimum required scopes","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For basic functionality, select at minimum: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read_api"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read_user"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save application"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/gitlab-3.c850dd46a41a093b4d6b8486ac6494d3a577df579c53861309df6a514f3329a1.1ce25488.png","alt":"GitLab application form with scopes selected"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-copy-your-credentials","__idx":5},"children":["Step 4: Copy your credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After saving, GitLab displays the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application ID"]}," (Client ID) and a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret"]}," (Client Secret). Copy both values immediately and store them securely."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Client Secret is shown only once. If you lose it, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Renew secret"]}," to generate a new one — this will invalidate the previous secret."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/gitlab-4.d2b81ca18af90e6d72c721025fda6408840500ae957a05591b3d880c8bad9cd2.1ce25488.png","alt":"GitLab application credentials"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":6},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application ID"]}," (Client ID) and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secret"]}," (Client Secret) from the steps above, enter them in the integration configuration page of the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → GitLab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," in the corresponding fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scopes"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":7},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.gitlab.com/ee/api/oauth2.html"},"children":["GitLab OAuth 2.0 documentation"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://gitlab.com/-/user_settings/applications"},"children":["GitLab User Settings Applications"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://docs.gitlab.com/ee/api/rest/"},"children":["GitLab API documentation"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]}]},"headings":[{"value":"GitLab integration","id":"gitlab-integration","depth":2},{"value":"Connect GitLab","id":"connect-gitlab","depth":3},{"value":"Step 1: Open the OAuth applications page","id":"step-1-open-the-oauth-applications-page","depth":4},{"value":"Step 2: Fill in the application details","id":"step-2-fill-in-the-application-details","depth":4},{"value":"Step 3: Select OAuth scopes","id":"step-3-select-oauth-scopes","depth":4},{"value":"Step 4: Copy your credentials","id":"step-4-copy-your-credentials","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"seo":{"title":"GitLab integration"}},"lastModified":"2026-05-01T18:45:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/gitlab","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}