Connect with GitLab

Our integration with Gitlab allows you to sync repositories to Venue.sh as entities.

Prerequisites

• An organization in Venue.sh
• A role of Owner or above
• A GitLab account with an appropriate permission level

Creating a Personal Access Token

tip

As a best practice, we recommended setting up a dedicated service account for this token.

note

GitLab's documentation on creating personal access tokens describes the process in detail. While we endeavour to keep this document current, GitLabs's process may have changed.

1. Go to https://gitlab.com or your hosted instance of GitLab and sign in.

2. Click your profile pic, then select preferences > Access Tokens > Add new token.

3. Give the token a name and define its expiration period.

   TIP: Remember, when the token expires, you will need to replace it to ensure no lapse in functionality.

4. Choose the following scopes/permissions for the token:

   • api
   • read_repository
   • write_repository

5. Click Create personal access token.

6. Copy the token as it cannot be retrieved once you leave the page.

Creating an OAuth app

To fully integrate Gitlab with Venue.sh, you must set up an OAuth app.

1. Go to https://gitlab.com or your hosted instance of GitLab and sign in.

2. Click your profile pic, then select preferences > Applications > Add new application.

3. Insert the following properties:

• Name: Venue.sh
• Redirect URI: https://<organization>.venue.sh/api/auth/gitlab/handler/frame

tip

Your organizations Redirect URI can be found in app when adding a Gitlab connection on the right sidebar.

4. Choose the following scopes/permissions for the application:

   • Confidential
   • read_user
   • read_repository
   • write_repository
   • openid
   • profile
   • email

5. Click Save application.

6. Take note of the Application ID and Secret.

7. Click Continue.