GitLab

Linking GitLab to Aude

At the current time, Aude supports GitLab Cloud. Let us know if you have a particular use case for GitHub on-premises.

Aude supports connecting to GitLab groups. You'll need to setup an application and an app access token. Then using the provided information from each step, connect to the GitLab installation.

1. Setup application

The application is used to provide an Oauth link from Aude to GitLab, to allow users to login with their own GitLab accounts.

  1. Visit the Applicationspage in your group's settings

  1. Click Add new application and configure it as follows:

    1. Name: Aude

    2. Redirect URI: https://server.aude.app/api/identity/oauth/gitlab/callback

    3. Scopes: read_api

    4. Confidential: No

  2. The new application will be created. Take note of its Application ID.

2. Setup app access token

An app access token is required for background reindexing of the code repositories. You need to ensure the app access token user has permission to access all the repositories in the group so reindexing occurs successfully.

Preferably, you should create a Group Access Token (requires paid GitLab plan). However, any app access token works, such as a Personal Access Token. as long as it has the required permissions to access the repositories.

Ensure the access token is setup with read_api scope.

Access tokens have an expiry date. You will need to update the installation with Aude with the new access token prior to expiry to ensure indexing continues uninterrupted.

Once you've created the access token, take note of it.

3. Link installation in Aude

From Aude configuration, you may find the Link GitLab Installation button. Click it and fill the following details.

  1. Group ID: You may find this via the GitLab group's main page.

  1. Application ID: From the prior step.

  2. App Access Token: From the prior step.

Once the installation is linked, you'll need to Log in into it. Following this, all the code repositories you have permission to access will be linkable via the Link repository button.

PreviousGitHubNextEnd-User License Agreement (EULA)

Last updated