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.

Create a User Account

1. At the bottom of the homepage, navigate to EXABEAM ADMIN OPERATIONS.
2. Under the Exabeam User Management section select Users.
   
   
3. Select Add User.
4. 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	This optional field can be left blank.
   Password	Type a password. Save the password to enter later in the Workbench.

    

5. For Role, select Tier 3 Analyst. If a custom role is preferred, complete steps 1.6 and 1.7 below. Note the permission requirements. If a custom role isn't needed, skip to Step 2.1 below.
6. For a custom role, type Expel for Role Name and Expel Custom Role for Description.
7. Select Advanced Analytics, and choose 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 & 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. 

Register device in Expel Workbench

1. Go to https://workbench.expel.io/settings/security-devices?setupIntegration=exabeam_data_lake.
2. Complete all fields using the credentials and information you collected in Step 1:
   
   
   • • (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 the city or site where your Exabeam is located for Location.
     • Under Connection Settings, for Token type the token you generated in Step 2 and for Server Address type the IP address for Exabeam. 
     • (Optional) Under Console Login, type the Username and Password you generated in Step 1.
3. 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.