Register an OAuth application on your instance
Create the application on the same GitLab instance you are connecting.
1
Open Applications
Sign in to your GitLab instance.
- For an instance-wide application, go to Admin > Applications (administrators only)
- For a personal application, go to Edit profile > Applications
- Click Add new application
2
Configure the application
Enables actions: Add Group Member, Add Project Deploy Key, Add Project Member, Approve Merge Request, Archive Project, Cancel Auto-Merge, Cancel Pipeline, Cherry-Pick Commit, Compare Branches, Create Branch, Create Commit, Create Environment, Create File, Create Group, Create Issue, Create Issue Note, Create Merge Request, Create Merge Request Note, Create Pipeline, Create Project, Create Project CI/CD Variable, Create Project Label, Create Project Milestone, Create Release, Create Snippet, Create Tag, Create User, Delete Branch, Delete File, Delete Group, Delete Issue, Delete Pipeline, Delete Project, Delete Project CI/CD Variable, Delete Project Deploy Key, Delete Project Label, Delete Project Milestone, Delete Release, Delete Snippet, Delete Tag, Delete User, Enable Project Deploy Key, Fork Project, Get Branch, Get Commit, Get Commit Diff, Get Current User, Get Current User Status, Get Environment, Get File, Get Group, Get Group Merge Request Approval Settings, Get Instance Metadata, Get Issue, Get Job, Get Job Log, Get Merge Request, Get Merge Request Approval State, Get Merge Request Approvals, Get Merge Request Participants, Get Namespace, Get Pipeline, Get Pipeline Variables, Get Project, Get Project Approval Configuration, Get Project CI/CD Variable, Get Project Label, Get Project Milestone, Get Protected Branch, Get Release, Get Repository Contributors, Get Snippet, Get Unified Credentials, Get Unified Group, Get Unified Organization, Get Unified Role, Get Unified User, Get User, Get User Status, List All Group Members, List All Project Members, List Billable Group Members, List Billable Member Memberships, List Branches, List Commits, List Enterprise Users, List Environments, List Group Branch Rules, List Group Descendant Members, List Group Members, List Group Merge Requests, List Group Merge Requests With Approvals, List Group Project Members, List Group Projects, List Group Subgroups, List Groups, List Issue Notes, List Issue Participants, List Merge Request Commits, List Merge Request Diffs, List Merge Request Notes, List Merge Requests For Commit, List Namespaces, List Pending Group Members, List Pipeline Jobs, List Pipelines, List Project Approval Rules, List Project CI/CD Variables, List Project Deploy Keys, List Project Issues, List Project Labels, List Project Members, List Project Merge Requests, List Project Milestones, List Projects, List Protected Branches, List Related Merge Requests, List Releases, List Repository Tree, List Snippets, List Tags, List Unified Groups, List Unified Organizations, List Unified Resource Types, List Unified Resource Users, List Unified Roles, List Unified Users, List Users, Merge Merge Request, Move Issue, Protect Branch, Rebase Merge Request, Remove Group Member, Remove Project Member, Retry Job, Retry Pipeline, Revert Commit, Search Globally, Search In Group, Search In Project, Stop Environment, Unarchive Project, Unprotect Branch, Update Environment, Update File, Update Group, Update Issue, Update Merge Request, Update Project, Update Project CI/CD Variable, Update Project Label, Update Project Member, Update Project Milestone, Update Release, Update Snippet, Update User
Fill in the application details.
- Name: StackOne
- Redirect URI:
https://api.stackone.com/connect/oauth2/gitlab/callback - Confidential: leave checked
3
Copy the credentials
Click Save application, then copy the Application ID and Secret. The secret is shown only once.
4
Add admin_mode for administrators
If an administrator connects and Admin Mode is turned on, also select admin_mode on the application and in the scopes field. Without it GitLab treats the administrator as a regular user, so the instance user roster and two-factor status stay hidden.
Find your instance URL
Use the address you open GitLab at, such as https://gitlab.example.com, without a trailing slash or /api/v4.
Linking the Account from the Hub
1
Navigate to the Hub
Use one of the three Linking Account Methods to access the Hub.
2
Fill out the fields
Fill out the following fields using details from your provider:
- GitLab Instance URL
- Application ID
- Application Secret
- OAuth Scopes (Optional)
3
Connect
- Click Connect
- If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
- Once authorization is successful, you will see a confirmation popup
If the account linking is successful, you will see the newly linked account in your Accounts page.
Next Steps
Webhooks setup
Configure receiving Events for GitLab into StackOne.