Connect to GitLab Cloud (gitlab.com)

Public projects

No configuration needed.

Private projects

By default no configuration is required. Each user will have to authenticate with OAuth to GitLab to access the content. Therefore, each Confluence user also needs a GitLab account to see the private projects.

Shared Authentication

Alternatively, shared authentication can be used. All Confluence users will share the same authentication to GitLab and therefore won’t need a GitLab account. Confluence users will see all content the authentication token has access to.

1. On GitLab.com, navigate to User-Settings → Access → Personal access tokens for user scoped tokens. Or project settings → Access tokens for project scoped tokens.

2. Create an Access-Token:

   1. (For Project tokens only) Select the Reporter role

   2. Grant the read_api scope

   3. Note the expiration date. Be aware to update the token if it expires or remove the expiration date.

      

      
      

3. On Confluence, navigate to the Settings → Apps → Include from GitLab to Confluence

4. Switch the authentication method and save the token: