GitLab credentials#

You can use these credentials to authenticate the following nodes:

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 SMS-iT Workflow 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 SMS-iT Workflow credential as the Access Token.
  9. Enter the URL of your GitLab Server in your SMS-iT Workflow credential.

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

Using OAuth2#

Note for SMS-iT Workflow Cloud users

Cloud users don't need to provide connection details. Select Connect my account to connect through your browser.

If you're self-hosting SMS-iT Workflow, 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 SMS-iT Workflow integration.
  5. In SMS-iT Workflow, 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 SMS-iT Workflow credential.
  9. Copy the Secret and enter it as the Client Secret in your SMS-iT Workflow 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.