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

Slack setup for Workbench

  • Updated

This article helps you integrate your Slack installation with the Expel Workbench.

In this article

Before you start

  • Slack Enterprise Grid is required.

  • The Slack app must be installed by the Owner of the Enterprise Grid organization.

  • The Slack app must be installed on the organization, not just a workspace within the organization.

Step 1: Enable API 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. Create a new slack app https://api.slack.com/apps.

  2. In the settings for the new app, select OAuth > Permissions from the left navigation. Scroll to the section titled Scopes, then click Add an OAuth Scope under User Token Scopes. Add the auditlogs:read scope. Use https://localhost for the redirect URL.

  3. In the settings for the new app, select Manage Distribution from the left navigation. Under the section titled Share Your App with Other Workspaces, make sure all four sections have the green checkmark. Then click the green Activate Public Distribution button.

  4. Under the Share Your App with Your Workspace section, copy the Sharable URL and paste it into a browser to start the OAuth handshake that installs the app on your organization. You must be logged in as the Owner of your Enterprise Grid organization to install the app.

  5. Check the list in the upper right of the installation screen to make sure you are installing the app on the Enterprise Grid organization, not an individual workspace within the organization (see image below).

  6. After the app is authorized, you are redirected to the localhost URL that contains a temporary code. Use that code to manually exchange it with an access token. Click here for instructions. Save the access token for later use.

Step 2: Configure Slack in Expel 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, click this link to open the Add Security Device screen in Workbench.

    Slack_AddSecDev_v2.png

  2. Fill in the fields like this:

    Field name

    What to put in it

    Name

    What you want to name the security device.

    Location

    Geographic location of the server.

    API Token

    The access token created in Step 1.

  3. 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.

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