Skip to main content

Connecting GitLab to Your Application

This page covers gitlab.com. For a self-managed instance you register an OAuth application on your own GitLab and enter its URL, client id and secret in Plexicus — see Self-Hosted.

Either way Plexicus requests the same eight scopes: api, read_api, read_user, read_repository, write_repository, openid, profile, email. Granting fewer lets the authorization succeed and the later repository calls fail.

Self-hosting Plexicus?

Before your users can click Connect for gitlab.com, the deployment needs a GitLab application of your own, registered with the callback URL https://<your-plexicus-domain>/api/callback/gitlab. See the SCM Connection Reference → GitLab.

Follow these steps to connect your GitLab account:

1. Open Settings › Integrations​

  • Log in to your account
  • In the left sidebar, click Settings, then Integrations
  • Select the SCM category
  • Click Configure on the GitLab card
Settings › Integrations, SCM category

2. Initiate the Connection​

  • Under Choose your GitLab instance type, keep GitLab.com selected (for your own instance, choose GitLab Self-Hosted and see GitLab Self-Hosted)
  • On the Token tab, click Connect
Gitlab Panel

3. Authorize GitLab Access​

  • Wait for the authorization process to complete
  • Grant necessary permissions for Plexicus to access your GitLab account
GitLab Authorize

4. Finalize the Connection​

  • You are redirected back to Plexicus
  • The GitLab panel shows that the connector is configured, with Connected and Delete buttons

Next Steps​

You can now scan repositories from GitLab: open Repo Scan in the left sidebar and click Add Repository. See Add repositories to scan.

Repo Scan page