1. Expel Help Center
  2. Connect Your Technology
  3. L-P Integrations

OneLogin Setup for Workbench

This article explains how to connect OneLogin to Workbench.

 

Quick Start

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. For more information, see Why Expel Asks for Console Access.

 

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

  1. In the OneLogin console, select Administration.
  2. Select Users and then New User.

  3. Fill in the following fields:

    • First name: Expel
    • Last name: SOC

    • For Email: soc+<Your_Organization_Name>@expel.io.

      Tip

      Yes, the "+" sign is part of the email address, and it's important. Click here to find out why.

    • Username: same as email
    • Password: set by user
    • Company: Expel
    • Leave the other fields blank.
  4. Click Save User.
  5. Notify your engagement manager that the registration email is sent.

Step 2: Generate API Credentials

 

To integrate the technology with Workbench, we need to create secure credentials to the API.

  1. Sign into your OneLogin as a user with Admin privileges.
  2. Navigate to Administration.
  3. Navigate to Developers > API Credentials.
  4. Select New Credential.
  5. Give the credential a name (such as Expel API) and select Read All and click Save.
  6. Save a copy of the Client ID and Client Secret.

Step 3: 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. Login to https://workbench.expel.io.
  2. Navigate to Settings > Security Devices.
  3. At the top of the page, click Add New Device.

  4. Search for and select OneLogin.

    image8.png
    • Give the device a Name and Location.
    • Fill in fields for Client Secret and Client ID with credentials generated in Step 2.
    • Specify the Region of the OneLogin device (US, EU).

  5. Click Save.

 

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.

Related articles