Skip to main content
availability

Package: Invicti AppSec Core (on-demand), Invicti AppSec Enterprise (on-premise, on-demand)

GitLab (on-premises)

Prerequisites

Before you integrate GitLab On-prem, create an Invicti AppSec service account as a preparation step. Make sure this user has access to the projects to be scanned. Creating the user and adding it to the required organizations is sufficient.

caution

Before you complete the on-premises integration, make sure Invicti AppSec can connect to the GitLab On-premises instance.

Integration steps

To generate a personal access token in GitLab On-premises:

  1. Sign in to your GitLab On-premises account.
  2. In the upper-right corner, click your avatar and select Preferences.

  gitlab on-premises instance.

  1. In the User Settings menu, go to Access Tokens.

  gitlab on-premises instance.

  1. Enter a name for the token and, if needed, set an expiration date.
  2. Select the required scopes:
    • api
    • read_repository

  gitlab on-premises instance.

  1. Click Create personal access token.
info

Once generated, store the personal access token securely. For security reasons, the token won't be displayed again after you leave or refresh the page. If you don't save the token at this stage, you'll need to create a new one.

Continue the process in the Invicti AppSec UI using the generated token.

  gitlab on-premises instance.

At this step, enter the token and click Test Connection.

If you want to use GitLab On-premises as an Issue Manager, select the checkbox at the top of the list. When GitLab On-premises is used as an Issue Manager, an additional Label field appears. This setting applies only to issues created on GitLab On-premises through the Issue Manager integration. All issues generated by the system will use the specified labels.

  gitlab on-premises instance.

Onboarding projects

After integration, you can synchronize projects from the Sync option next to the Activate button. This lets you onboard projects quickly.

  gitlab on-premises instance.

When you enable the Daily Sync feature, Invicti AppSec synchronizes projects from GitLab On-premises every day and automatically onboards all projects that haven't been onboarded yet.If your license project count is limited, don't enable Daily Sync. The available project quota may be consumed quickly, which can prevent you from adding new projects. :::


Need help?

Invicti Support team is ready to provide you with technical help. Go to Help Center

Was this page useful?