feat(secret-sync): add Gitlab PR comments suggestions

2026-09-22 13:39:35 +00:00 · 2025-06-24 10:05:46 -03:00
parent c305ddd463
commit 43e0d400f9
17 changed files with 243 additions and 153 deletions
--- a/docs/integrations/app-connections/gitlab.mdx
+++ b/docs/integrations/app-connections/gitlab.mdx
@@ -1,6 +1,6 @@
 ---
-title: "GitLab App Connection"
-description: "Learn how to configure a GitLab App Connection for Infisical using OAuth or Access Token methods."
+title: "GitLab Connection"
+description: "Learn how to configure a GitLab Connection for Infisical using OAuth or Access Token methods."
 ---

 Infisical supports two methods for connecting to GitLab: **OAuth** and **Access Token**. Choose the method that best fits your setup and security requirements.
@@ -10,7 +10,7 @@ Infisical supports two methods for connecting to GitLab: **OAuth** and **Access
    The OAuth method provides secure authentication through GitLab's OAuth flow.

    <Accordion title="Self-Hosted Instance Setup">
-      Using the GitLab App Connection with OAuth on a self-hosted instance of Infisical requires configuring an OAuth application in GitLab and registering your instance with it.
+      Using the GitLab Connection with OAuth on a self-hosted instance of Infisical requires configuring an OAuth application in GitLab and registering your instance with it.

      **Prerequisites:**
      - A GitLab account with existing projects
@@ -47,7 +47,7 @@ Infisical supports two methods for connecting to GitLab: **OAuth** and **Access
          - `CLIENT_ID_GITLAB`: The **Application ID** of your GitLab OAuth application.
          - `CLIENT_SECRET_GITLAB`: The **Secret** of your GitLab OAuth application.

-          Once added, restart your Infisical instance and use the GitLab App Connection.
+          Once added, restart your Infisical instance and use the GitLab Connection.
        </Step>
      </Steps>
    </Accordion>
@@ -60,7 +60,7 @@ Infisical supports two methods for connecting to GitLab: **OAuth** and **Access
        ![App Connections Tab](/images/app-connections/general/add-connection.png)
      </Step>
      <Step title="Add Connection">
-        Select the **GitLab App Connection** option from the connection options modal.
+        Select the **GitLab Connection** option from the connection options modal.
        ![Select GitLab Connection](/images/app-connections/gitlab/select-gitlab-connection.png)
      </Step>
      <Step title="Choose OAuth Method">
@@ -73,7 +73,7 @@ Infisical supports two methods for connecting to GitLab: **OAuth** and **Access
        ![GitLab Authorization](/images/app-connections/gitlab/gitlab-authorization-page.png)
      </Step>
      <Step title="Connection Created">
-        Your **GitLab App Connection** is now available for use.
+        Your **GitLab Connection** is now available for use.
        ![GitLab OAuth Connection](/images/app-connections/gitlab/gitlab-oauth-connection.png)
      </Step>
    </Steps>
@@ -96,13 +96,17 @@ Infisical supports two methods for connecting to GitLab: **OAuth** and **Access
            ![GitLab Personal Access Tokens](/images/app-connections/gitlab/gitlab-add-access-token.png)
          </Step>
          <Step title="Configure Token">
-            Fill in the token details:
-            - **Token name**: A descriptive name for the token (e.g., "connection-token")
-            - **Expiration date**: Set an appropriate expiration date
-            - **Select scopes**: Choose the **api** scope for full API access
-
-            ![GitLab Personal Token Form](/images/app-connections/gitlab/gitlab-personal-access-token-form.png)
+            <Tabs>
+              <Tab title="Secret Rotation">
+              For Secret Rotations, your token will require the ability to access the API:
+              Fill in the token details:
+              - **Token name**: A descriptive name for the token (e.g., "connection-token")
+              - **Expiration date**: Set an appropriate expiration date
+              - **Select scopes**: Choose the **api** scope for full API access

+              ![GitLab Personal Token Form](/images/app-connections/gitlab/gitlab-personal-access-token-form.png)
+              </Tab>
+            </Tabs>
          </Step>
          <Step title="Copy Token">
            Copy the generated token immediately as it won't be shown again.
@@ -126,19 +130,31 @@ Infisical supports two methods for connecting to GitLab: **OAuth** and **Access
            ![GitLab Project Access Tokens](/images/app-connections/gitlab/gitlab-project-access-token-list.png)
          </Step>
          <Step title="Configure Token">
-            Fill in the token details:
-            - **Token name**: A descriptive name for the token
-            - **Expiration date**: Set an appropriate expiration date
-            - **Select role**: Choose **Owner** or higher role
-            - **Select scopes**: Choose the **api** scope for API access
+            <Tabs>
+            <Tab title="Secret Rotation">
+                  For Secret Rotations, your token will require the ability to access the API and be at least an **Owner**:
+                  Fill in the token details:
+                  - **Token name**: A descriptive name for the token
+                  - **Expiration date**: Set an appropriate expiration date
+                  - **Select role**: Choose **Owner** or higher role
+                  - **Select scopes**: Choose the **api** scope for API access

-            ![GitLab Create Project Token](/images/app-connections/gitlab/gitlab-project-access-token-form.png)
+                  ![GitLab Create Project Token](/images/app-connections/gitlab/gitlab-project-access-token-form.png)
+              </Tab>
+            </Tabs>

+            <Info>
+              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 Project Token Form](/images/app-connections/gitlab/gitlab-project-access-token-created.png)
+
+            <Warning>
+              Keep your access token secure and do not share it. Anyone with access to this token can access your GitLab account and projects.
+            </Warning>
          </Step>
        </Steps>
      </Tab>
@@ -152,7 +168,7 @@ Infisical supports two methods for connecting to GitLab: **OAuth** and **Access
        ![App Connections Tab](/images/app-connections/general/add-connection.png)
      </Step>
      <Step title="Add Connection">
-        Select the **GitLab App Connection** option from the connection options modal.
+        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">
@@ -163,14 +179,10 @@ Infisical supports two methods for connecting to GitLab: **OAuth** and **Access
        Click **Connect** to establish the connection.
      </Step>
      <Step title="Connection Created">
-        Your **GitLab App Connection** is now available for use.
+        Your **GitLab Connection** is now available for use.
        ![GitLab Access Token Connection](/images/app-connections/gitlab/gitlab-access-token-connection.png)
      </Step>
    </Steps>

-    <Info>
-      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>
-
  </Tab>
 </Tabs>
--- a/docs/integrations/app-connections/heroku.mdx
+++ b/docs/integrations/app-connections/heroku.mdx
@@ -1,6 +1,6 @@
 ---
-title: "Heroku App Connection"
-description: "Learn how to configure a Heroku App Connection for Infisical using OAuth or Auth Token methods."
+title: "Heroku Connection"
+description: "Learn how to configure a Heroku Connection for Infisical using OAuth or Auth Token methods."
 ---

 Infisical supports two methods for connecting to Heroku: **OAuth** and **Auth Token**. Choose the method that best fits your setup and security requirements.
@@ -10,7 +10,7 @@ Infisical supports two methods for connecting to Heroku: **OAuth** and **Auth To
    The OAuth method provides secure authentication through Heroku's OAuth flow.

    <Accordion title="Self-Hosted Instance Setup">
-      Using the Heroku App Connection with OAuth on a self-hosted instance of Infisical requires configuring an API client in Heroku and registering your instance with it.
+      Using the Heroku Connection with OAuth on a self-hosted instance of Infisical requires configuring an API client in Heroku and registering your instance with it.

      **Prerequisites:**
      - A Heroku account with existing applications
@@ -42,7 +42,7 @@ Infisical supports two methods for connecting to Heroku: **OAuth** and **Auth To
          - `CLIENT_ID_HEROKU`: The **Client ID** of your Heroku API client.
          - `CLIENT_SECRET_HEROKU`: The **Client Secret** of your Heroku API client.

-          Once added, restart your Infisical instance and use the Heroku App Connection.
+          Once added, restart your Infisical instance and use the Heroku Connection.
        </Step>
      </Steps>
    </Accordion>
@@ -55,7 +55,7 @@ Infisical supports two methods for connecting to Heroku: **OAuth** and **Auth To
        ![App Connections Tab](/images/app-connections/general/add-connection.png)
      </Step>
      <Step title="Add Connection">
-        Select the **Heroku App Connection** option from the connection options modal.
+        Select the **Heroku Connection** option from the connection options modal.
        ![Select Heroku Connection](/images/app-connections/heroku/heroku-select-connection.png)
      </Step>
      <Step title="Choose OAuth Method">
@@ -68,7 +68,7 @@ Infisical supports two methods for connecting to Heroku: **OAuth** and **Auth To
        ![Heroku Authorization](/images/integrations/heroku/integrations-heroku-auth.png)
      </Step>
      <Step title="Connection Created">
-        Your **Heroku App Connection** is now available for use.
+        Your **Heroku Connection** is now available for use.
        ![Heroku OAuth Connection](/images/app-connections/heroku/heroku-connection.png)
      </Step>
    </Steps>
@@ -97,7 +97,7 @@ Infisical supports two methods for connecting to Heroku: **OAuth** and **Auth To
        ![App Connections Tab](/images/app-connections/general/add-connection.png)
      </Step>
      <Step title="Add Connection">
-        Select the **Heroku App Connection** option from the connection options modal.
+        Select the **Heroku Connection** option from the connection options modal.
        ![Select Heroku Connection](/images/app-connections/heroku/heroku-select-connection.png)
      </Step>
      <Step title="Configure Auth Token">
@@ -108,7 +108,7 @@ Infisical supports two methods for connecting to Heroku: **OAuth** and **Auth To
        Click **Connect** to establish the connection.
      </Step>
      <Step title="Connection Created">
-        Your **Heroku App Connection** is now available for use.
+        Your **Heroku Connection** is now available for use.
        ![Heroku Auth Token Connection](/images/app-connections/heroku/heroku-connection.png)
      </Step>
    </Steps>