Skip to main content

GitLab Integration Setup

Complete guide for connecting your GitLab repositories to ProdE's knowledge layer.

Overview​

GitLab integration allows ProdE to access your GitLab repositories and create intelligent knowledge layers for your selected codebases. ProdE supports both OAuth and Personal Access Token (PAT) authentication methods.

Prerequisites​

  • GitLab Account: Active GitLab account with repository access
  • Group Access: For group repositories, you must have appropriate permissions to grant read access

Setup Process​

Step 1: Initiate GitLab Connection​

  • Log into your ProdE account
  • Navigate to Knowledge Layer section in the sidebar
  • Click on GitLab provider option and click Connect

Step 2: Choose Authentication Method​

  1. Complete OAuth Flow: You'll be redirected to GitLab's authorization page
  2. Grant Access: Authorize ProdE with read-only access (read_repository, read_api, read_user scopes)
  3. Automatic Setup: ProdE will securely store your tokens and discover your GitLab groups

Option B: Personal Access Token (PAT)​

  1. Generate a PAT in your GitLab account settings under Access Tokens
  2. Required Scopes: Ensure the token has read_repository, read_api, and read_user scopes
  3. Enter PAT: Paste the token into ProdE's connection form
  4. Validation: ProdE will validate the token and discover your groups

After authentication:

  • Select Groups: Choose which GitLab groups you want to connect
  • Automatic Repository Loading: All repositories from your selected groups will become available in your ProdE account

Step 4: Repository Management​

  • Next Steps: Navigate to the Repository Management page to learn more about managing your connected repositories and creating knowledge layers

Security Features​

Read-Only Access​

  • No Write Permissions: ProdE only requests read-only access to your repositories
  • Secure Authentication: Token-based authentication through GitLab OAuth or PAT
  • Permission Scoping: Limited to repository content reading only

Data Privacy​

  • GitLab Permissions: Access is limited by your GitLab permissions
  • Secure Processing: Repository data is processed securely
  • Deletion Option: Data can be deleted upon disconnection

Disconnection and Data Management​

Disconnecting GitLab​

Important

Disconnecting GitLab will permanently delete all associated repository data and knowledge layers.

When you disconnect GitLab:

  1. All GitLab repository data is permanently deleted
  2. Knowledge layers are removed
  3. Reconnection requires reauthorization

Disconnecting Groups​

Data Loss Warning

Disconnecting a group permanently deletes all repository data and knowledge layers from that group.

When you disconnect a group:

  1. All repository data from the group is permanently deleted
  2. Knowledge layers for that group are completely removed
  3. No access to group repository content or insights
  4. Other connected groups remain unaffected
Last updated on