1. Expel Support Center
  2. Connect your technology
  3. SaaS integrations

GitLab (SaaS) Setup for Workbench

  • Updated

This article explains how to connect GitLab to Expel Workbench.

In this article

Before you start

You must have:

  • A GitLab SaaS installation. Reach out to your engagement manager if you’re using the self-managed version.

  • A user account with owner permissions on the top-level group.

Step 1: Enable console access

Having read-only access to the interface of your technology allows Expel to dig deeper during incident investigations. Our device health team uses this access to investigate potential health issues with your tech.

Note

Expel secures all login information our SOC analysts need about your devices in a MFA password product. Access to this login information is protected using our internal MFA processes. To learn more about the IP addresses all Expel traffic comes from, go here.

  1. Login to GitLab and navigate to a top-level group.

  2. Copy the Group ID.

  3. Open your Profile menu and select Preferences.

  4. Click Access Tokens.

  5. Generate a Personal Access Token with a 1-year expiry date and a read_api permission level.

Step 2: Configure the technology in Workbench

Now that we have the correct access configured and noted the credentials, we can integrate your tech with Workbench.

  1. In a new browser tab, log into Workbench. The link opens the Add Security Device screen directly.

  2. Fill in the fields like this:

    GitLab_AddSecDev.jpg

    • Add a Name and Location that are meaningful to you.

    • For API token, use the Personal Access Token created in Step 1.5.

    • For On-prem URL, if the server is self-managed, use the GitLab server URL.

    • For Group IDs, type the Group ID copied in Step 1.2.

You can see if the device is healthy on the Security Devices page. It may take a few minutes to see the device listed as healthy.

To check if alerts are coming through, navigate to the Alerts Analysis page. Scroll to the device you want to check and click View alerts. Switch to grid view, then check the list for device alerts. It can take 36 to 72 hours for alerts to appear after setup, as we tune your device.

Tip

This article was accurate at the time of writing, but changes happen. If you find the instructions are outdated, leave a description in the comment field below and let us know!

  • Was this article helpful?

  • 0 out of 0 found this helpful

Related articles