> ## Documentation Index
> Fetch the complete documentation index at: https://www.oplane.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect GitLab projects to Oplane

> Connect Oplane to GitLab projects for automated threat modeling on merge requests. No app install required — just sign in with your GitLab account.

Connect Oplane to your GitLab projects to enable automated threat modeling on merge requests. No app installation required — just sign in with your GitLab account.

<Steps>
  <Step title="Open Workspaces">
    Navigate to **Workspaces** in the left sidebar and click the **+ Workspace** button in the top right corner.

    <Frame>
      <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/gitlab-setup/workspaces.webp?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=392d59c5fbc1ae3ba2a08a06c2d60dda" alt="Oplane Workspaces page" width="3246" height="1866" data-path="images/gitlab-setup/workspaces.webp" />
    </Frame>

    <Frame caption="Click the + Workspace button">
      <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/gitlab-setup/zoom-button.png?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=864c1188679f90cc3b08abcef57eb254" alt="+ Workspace button" width="1024" height="854" data-path="images/gitlab-setup/zoom-button.png" />
    </Frame>
  </Step>

  <Step title="Create a Managed Workspace">
    Select **Managed Workspace** and under Git Repository, click **Continue with GitLab** to connect your account.

    <Frame>
      <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/gitlab-setup/setup.webp?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=1e9d988b5c926d20e46256ad85b99fd3" alt="Create a Managed Workspace with GitLab" width="964" height="737" data-path="images/gitlab-setup/setup.webp" />
    </Frame>
  </Step>

  <Step title="Sign in to GitLab">
    You'll be redirected to GitLab to sign in. Enter your credentials or use one of the alternative sign-in methods (Google, GitHub, Bitbucket, Salesforce, or Passkey).

    Once authenticated, you'll be redirected back to Oplane where your GitLab account will be connected.

    <Frame>
      <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/gitlab-setup/signin.webp?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=1ab00d3f69ec4d7d71b22a98e149eb99" alt="GitLab sign-in page" width="652" height="859" data-path="images/gitlab-setup/signin.webp" />
    </Frame>
  </Step>

  <Step title="Select a Project">
    Back in Oplane, select your group from the dropdown and search for the project you want to connect.

    <Note>
      Only GitLab projects where you are Maintainer or Owner are listed. This access level is required to create a project access token.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/gitlab-setup/search.webp?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=660cefd6850fccc81fc4e4af95d2c494" alt="Select group and project" width="1030" height="700" data-path="images/gitlab-setup/search.webp" />
    </Frame>
  </Step>

  <Step title="Configure the Workspace">
    Once connected, configure your workspace settings:

    * **Analyse Pull Requests** — Enable to automatically threat model every MR. If disabled, you can still trigger reviews by mentioning `@oplane` in an MR comment.
    * **Access** — Add team members who should have access to this workspace.

    Click **Create** when ready.

    <Frame>
      <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/gitlab-setup/configure.webp?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=75426171d6b57c4e564e7b01662f9e69" alt="Configure workspace settings" width="958" height="936" data-path="images/gitlab-setup/configure.webp" />
    </Frame>
  </Step>

  <Step title="Choose Threat Models">
    Oplane analyses your repository and suggests threat models based on the codebase. Select the ones relevant to your project, or describe your own scope.

    <Frame>
      <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/gitlab-setup/suggest.webp?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=8f48127170cbb50ec36985149a816739" alt="Choose threat models for your project" width="801" height="899" data-path="images/gitlab-setup/suggest.webp" />
    </Frame>
  </Step>
</Steps>

<Card title="What's next?" icon="git-pull-request" href="/docs/github-prs">
  Learn how Oplane reviews your merge requests in the Pull & Merge Requests guide.
</Card>
