GitLab Token

Use this method to connect GitLab to OX by using a Personal Access Token (PAT). This method authenticates OX with your GitLab account and allows OX to discover and scan the projects that are accessible to that account.

Before you begin

Verify that:

• You have permission to configure connectors in OX.

• You have permission to create Personal Access Tokens in GitLab.

• You have access to the GitLab projects and groups that you want OX to scan.

Step 1: Create a Personal Access Token

1. Sign in to GitLab.

2. Go to User Settings > Access Tokens.

3. Select Add new token.

1. Enter a name for the token.

2. Optional: Specify an expiration date.

3. Select the following scopes:

   • api

   • read_user

   • read_registry

4. Select Create personal access token.

5. Copy the generated token.

Note

GitLab displays the token only once. Store it securely before leaving the page.

Step 2: Connect GitLab to OX

1. In OX, go to Settings > Connections.

2. Select GitLab.

1. Open the Token tab.

2. Configure the connection.

Parameter	Description
GitLab Host URL	The URL of your GitLab instance. For GitLab.com, enter https://gitlab.com. For a self-managed GitLab instance, enter your GitLab server URL.
Token	The Personal Access Token (PAT) that you created in GitLab.
Connection Name	A unique name for the connection.
OX Broker	Enable this option to connect GitLab through an OX Broker instead of a direct connection. When enabled, OX routes communication through the broker, allowing access to GitLab instances that are not directly reachable from the internet. After enabling the toggle, provide the broker connection details as described in the OX Broker documentation.
Bypass SSL Verification	Enable to skip SSL certificate validation. Use only if your environment uses self-signed or otherwise untrusted certificates. Not recommended because it reduces connection security.

1. Select Verify Connectivity.

2. Select Connect.