GitLab

Prev Next

This is a Managed App Connector.


Supported authentication methods#

  • API access token

  • OAuth2 (Recommended)

Refer to GitLab's API documentation for more information about the service.

Using API access token#

To configure this credential, you'll need a GitLab account and:

  • The URL of your GitLab Server

  • An Access Token

To set up the credential:

  1. In GitLab, select your avatar, then select Edit profile.

  2. In the left sidebar, select Access tokens.

  3. Select Add new token.

  4. Enter a Name for the token, like Calero Automations integration.

  5. Enter an expiry date for the token. If you don't enter an expiry date, GitLab automatically sets it to 365 days later than the current date.

    • The token expires on that expiry date at midnight UTC.

  6. Select the desired Scopes. For the GitLab node, use the api scope to easily grant access for all the node's functionality. Or refer to Personal access token scopes to select scopes for the functions you want to use.

  7. Select Create personal access token.

  8. Copy the access token this creates and enter it in your Calero Automations credential as the Access Token.

  9. Enter the URL of your GitLab Server in your Calero Automations credential.

Refer to GitLab's Create a personal access token documentation for more information.

Using OAuth2#

If you're self-hosting Calero Automations, you'll need a GitLab account. Then create a new GitLab application:

  1. In GitLab, select your avatar, then select Edit profile.

  2. In the left sidebar, select Applications.

  3. Select Add new application.

  4. Enter a Name for your application, like Calero Automations integration.

  5. In Calero Automations, copy the OAuth Redirect URL. Enter it as the GitLab Redirect URI.

  6. Select the desired Scopes. For the GitLab node, use the api scope to easily grant access for all the node's functionality. Or refer to Personal access token scopes to select scopes for the functions you want to use.

  7. Select Save application.

  8. Copy the Application ID and enter it as the Client ID in your Calero Automations credential.

  9. Copy the Secret and enter it as the Client Secret in your Calero Automations credential.

Refer to GitLab's Configure GitLab as an OAuth 2.0 authentication identity provider documentation for more information. Refer to the GitLab OAuth 2.0 identity provider API documentation for more information on OAuth2 and GitLab.

Onboard This Managed App Connector

  1. Go to SaaS Management > Applications.

  2. Select Add Integration.

  3. From the Vendors tab, select the card with the vendor's name.

  4. From the API tab, enter the field(s) you copy/saved above.

  5. If your company has more than one instance (or “tenant”) of this application, you will also be prompted for a Connection Alias.

  6. Select the Authorize button.

SUCCESS!

You will now be redirected to the Integrations page in Calero.com, where the data sync will continue in the background, and you can monitor progress.


SUGGESTION:

Access Help through your Calero.com instance if links between articles return errors or if there are fewer sections in the Help menu than expected. Doing so will ensure you see all Help articles.