Step 1: Enable console access

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

The Exabeam Security Management Platform uniquely combines a data lake for unlimited data collection, machine learning for advanced analytics, and automated incident response into an integrated set of products. The Expel SOC requires a dedicated User Account, which allows our analysts to respond to security alerts and leverage the data available in Exabeam.

1. At the top right from the menu, navigate to Settings.
   
2. Under the Exabeam User Management section, select Users.
3. Select Add User. Type the following information for the requested fields:
   

   Field name	What to put in it
   User Type	Local
   Username	expel
   Full Name	Expel SOC
   Email	Optional field can be left blank
   Password	Enter a password. Save the password to enter later in Workbench.

   • 

For Role, select Tier 3 Analyst. If a custom role is preferred, complete the next 2 steps below. Note the permission requirements. If a custom role is not needed, skip to Step 2.

• • For a custom role, enter Expel for Role Name and Expel Custom Role for Description.
  • Select Advanced Analytics and select the following permissions:
    

    View
    View Activities	Required
    View Executive Info	Required
    View Global Insights	Required
    View Infographics	Required
    View Insights	Required
    View Rules	Required
    Edit and Approve
    Approve Lockouts	Optional but recommended
    Accept Sessions	Optional but recommended
    Manage Rules	Optional but recommended
    Manage Watchlist	Optional but recommended
    Search
    Manage Search Library	Optional but recommended
    Basic Search	Required
    Threat Hunting	Required
    View Search Library	Required

Step 2: Generate API credentials

To integrate the technology with Expel, we need to create secure credentials to the API. Depending on the permissions allowed in Step 1, Expel may be able to generate API credentials. If you're unsure, reach out to your Expel Customer Success Engineer, or email customerhealth@expel.io.

1. Navigate to Settings > Admin Operations > Cluster Authentication Token.
2. At the Cluster Authentication Token menu, click + to add a new token.
3. In the Setup Token dialog box, fill in the Token Name, set Expiry Date to Permanent, and set the Permission Level(s) as Tier 3 Analyst.
4. Click SAVE to apply the configuration.
5. Copy the generated token for use in the next step.

Step 3: Configure the technology in Workbench

Now that we have all the correct access configured, we can integrate Exabeam with Expel.  

1. In a new browser tab, log into https://workbench.expel.io.
2. On the console page, navigate to Settings and click Security Devices.
3. At the top right of the page, select Add Security Device.
   
4. Search for and select Exabeam Advanced Analytics from the list of support technologies.  
5. Complete all fields using the credentials and information you collected in Step 1 and Step 2.
   
   
   • • (Optional) Select an Assembler from the list. If you have an assembler, select the assembler you set up in Step 2 of the Getting Started with Expel guide. 
     • Type Name (give your Exabeam a name). 
     • Type city or site where your Exabeam is located for Location.
     • Under Connection Settings, type Server Address (IP address for Exabeam), and for Token type the token you generated in Step 2. 
     • Under Console Login, type the Username and Password you generated in Step 1.
6. Click Save.

After a few minutes, refresh the Security Devices page and you see your device status reporting as Healthy, or if there is an issue, you see details of what the issue may be.

To check if alerts are coming through, navigate to Alerts on the console page. Click the icon in the upper right to switch to grid view, then check the list for device alerts.