All Collections
Setting up code scanning
Connect Aikido with Your Source Code
How to connect your GitLab self-managed server to Aikido
How to connect your GitLab self-managed server to Aikido

This article explains the steps you need to take to connect your GitLab server instance.

Bert Coppens avatar
Written by Bert Coppens
Updated this week

Aikido allows you to connect your self-managed GitLab server to secure your code. In order to connect your GitLab server to Aikido, you will need to follow the steps below.

If your GitLab is behind a firewall, we have a list of Static IPs you can whitelist.

Step 1. Select Google or O365 to authenticate

To connect your GitLab server, you first need to authenticate via Google or Office 365 to create a user in Aikido. On the signup screen, click on 'Self-Managed' to continue, next you can select the OAuth provider you'd like to use.

Once you're authenticated, you can either create a new workspace or use a sample repo to get a first look and feel of Aikido.

Step 2. Insert your GitLab server URL

When you decide to create a new workspace, you'll need to provide a few details about your self-managed GitLab instance so Aikido can connect to it.

Enter the URL to your GitLab server in the first input field.

Step 3. Create a Personal Access Token

Next up, you need to create a Personal Access Token to give us access to the resources you want.

  • Log in to your GitLab server

  • In the upper-right corner, click your avatar and select Settings.

  • On the User Settings menu, select Access Tokens.

  • Enter a name for the token, eg: 'Aikido Security Access Token'

  • You don't need to select an expiration date

  • We need the following scopes to be selected:

    • read_user

    • read_api

    • read_repository

  • Click the Create personal access token button.

  • Copy the token being shown on the screen and enter it in the input field.

Important: You will no longer be able to view the value of the token once you hit continue. Make sure you copied it first.

Aikido will now check the connection to your GitLab server. If the connection was not successful, make sure to double-check the URL you entered and the personal access token you provided.

Step 4. Select the group and repositories you'd like to secure

On the next screen, you can select which group you'd like to start with. You'll always be able to connect more of your groups to Aikido.

In the final step you can select all the repositories you would like us to monitor.

Did this answer your question?