awatertrevi/infisical
1
0
Fork 0
mirror of https://github.com/awatertrevi/infisical.git synced 2026-10-07 07:27:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: clarify GitLab access token requirements and update setup instructions

Browse Source
This commit is contained in:
Piyush Gupta
2025-10-28 18:11:27 +05:30
parent 9ac6234c95
commit 676c59d392
1 changed files with 58 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/integrations/app-connections/gitlab.mdx
+58 -40
View File
@@ -204,57 +204,75 @@ Infisical supports two methods for connecting to GitLab: **OAuth** and **Access
<Tabs> <Tabs>
<Tab title="Secret Sync"> <Tab title="Secret Sync">
For Secret Syncs, your token will require the `api` scope and at least a **Maintainer** role or higher. For Secret Syncs, the required role depends on your sync destination:
- **Project variables**: Requires **Maintainer** role or higher
- **Group variables**: Requires **Owner** role
Your token will require the `api` scope.
![GitLab Create Group Token](/images/app-connections/gitlab/gitlab-group-access-token-form-secret-sync.png) ![GitLab Create Group Token](/images/app-connections/gitlab/gitlab-group-access-token-form-secret-sync.png)
Click **Create group access token** to create the token. Click **Create group access token** to create the token.
<Note>
Use the **Owner** role if you need to sync to group-level variables. The **Maintainer** role is sufficient only for project-level variables.
</Note>
</Tab> </Tab>
<Tab title="Secret Scanning"> <Tab title="Secret Scanning">
For Secret Scanning, your token will require the `api` scope and at least a **Maintainer** role or higher. To set up Secret Scanning, the required permissions depend on the data source level:
![GitLab Create Group Token](/images/app-connections/gitlab/gitlab-group-access-token-form-secret-sync.png) - **Project-level data source:** Requires **Maintainer** role or higher
- **Group-level data source:** Requires **Owner** role
Click **Create group access token** to create the token. Your token will require the `api` scope.
</Tab>
</Tabs>
<Info> ![GitLab Create Group Token](/images/app-connections/gitlab/gitlab-group-access-token-form-secret-sync.png)
Group Access Token connections require manual token rotation when your GitLab access token expires or is regenerated. Monitor your connection status and update the token as needed.
</Info>
</Step>
<Step title="Copy Token">
Copy the generated token immediately as it won't be shown again.
![GitLab Group Token Created](/images/app-connections/gitlab/gitlab-group-access-token-created.png)
<Warning>
Keep your access token secure and do not share it. Anyone with access to this token can access all projects within your GitLab group.
</Warning>
</Step>
</Steps>
</Tab>
</Tabs>
## Setup GitLab Access Token Connection in Infisical Click **Create group access token** to create the token.
</Tab>
</Tabs>
<Steps> <Info>
<Step title="Navigate to App Connections"> Group Access Token connections require manual token rotation when your GitLab access token expires or is regenerated. Monitor your connection status and update the token as needed.
Navigate to the **App Connections** page in the desired project. </Info>
![App Connections Tab](/images/app-connections/general/add-connection.png) </Step>
</Step> <Step title="Copy Token">
<Step title="Add Connection"> Copy the generated token immediately as it won't be shown again.
Select the **GitLab Connection** option from the connection options modal. ![GitLab Group Token Created](/images/app-connections/gitlab/gitlab-group-access-token-created.png)
![Select GitLab Connection](/images/app-connections/gitlab/select-gitlab-connection.png) <Warning>
</Step> Keep your access token secure and do not share it. Anyone with access to this token can access all projects within your GitLab group.
<Step title="Configure Access Token"> </Warning>
Select the **Access Token** method, paste your GitLab access token in the provided field, and select the appropriate token type. </Step>
</Steps>
![Configure Access Token](/images/app-connections/gitlab/create-gitlab-access-token-connection.png) </Tab>
Click **Connect** to establish the connection. </Tabs>
</Step>
<Step title="Connection Created"> ## Setup GitLab Access Token Connection in Infisical
Your **GitLab Connection** is now available for use.
![GitLab Access Token Connection](/images/app-connections/gitlab/gitlab-access-token-connection.png) <Steps>
</Step> <Step title="Navigate to App Connections">
</Steps> Navigate to the **App Connections** page in the desired project.
![App Connections Tab](/images/app-connections/general/add-connection.png)
</Step>
<Step title="Add Connection">
Select the **GitLab Connection** option from the connection options modal.
![Select GitLab Connection](/images/app-connections/gitlab/select-gitlab-connection.png)
</Step>
<Step title="Configure Access Token">
Select the **Access Token** method, paste your GitLab access token in the provided field, and select the appropriate token type.
![Configure Access Token](/images/app-connections/gitlab/create-gitlab-access-token-connection.png)
Click **Connect** to establish the connection.
</Step>
<Step title="Connection Created">
Your **GitLab Connection** is now available for use.
![GitLab Access Token Connection](/images/app-connections/gitlab/gitlab-access-token-connection.png)
</Step>
</Steps>
</Tab> </Tab>
</Tabs> </Tabs>