Skip to main content

Cloud ConnectorsExabeam Cloud Connectors Configuration Guide

Table of Contents

Slack Classic App Cloud Connector (Formerly known as Slack Enterprise Grid Cloud Connector)

Slack Enterprise Grid is a platform for all workplace collaboration that helps organizations collaborate across workspaces. For more information see the Slack documentation.

Prerequisites to Configure the Slack Classic App Connector (Formerly Known as Slack Enterprise Grid Connector)

Before you configure the Slack Classic App connector, you must obtain the values for client ID and client secret by creating a Slack app for integration.

Obtain Client ID and Secret by Creating a Slack App

Slack APIs are authenticated via client ID and client secret. You must create a Slack app to obtain the values for client ID and client secret to use while configuring the Slack connector.

To create a Slack app:

  1. Log in to Slack Enterprise Grid, and access https://api.slack.com/apps?new_classic_app=1.

    Slack_App_Create_App.png

  2. Specify a name for the app, select the Slack workspace to which the app belongs, and click Create App.

  3. Navigate to OAuth & Permissions page.

  4. Click Add New Redirect URL and enter https://auth.skyformation.net/v1/oauth in the Redirect URLs box.

  5. Click Add, then click Save URLs.

  6. Scroll down to the Scopes section.

  7. In the Select Permission Scopes list, select auditlogs:read. This permission is required to allow interaction with the Audit Log API.

  8. Click Save Changes.

  9. In the left pane, navigate to Settings > Basic Information.

  10. In the Basic Information section, click Manage Distribution.

  11. Click Distribute App.

  12. In the Share Your App with Other Workspaces section, click Remove Hard Coded Information.

    Note

    In the Share Your App with Other Workspaces section, ensure that you select the check boxes for all the available options such as Enable Features & Functionality, Add OAuth Redirect URLs, and Use HTTPS For Your Features.

  13. Select the I've reviewed and removed any hard-coded information check box.

  14. Click Activate Public Distribution.

  15. Initiate the OAuth handshake that will install the app:

    1. In Share Your App with Your Workspace, copy the Sharable URL and paste it into a browser to on your organization.

      You must be logged in as the Owner of your Enterprise Grid organization to install the app.

    2. Verify the dropdown 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.

      After your app completes the OAuth flow, you will be granted an OAuth token that you can use to call all of the Audit Logs API methods for your organization.

    For more information, see the Slack documentation.

  16. In the left pane, navigate to Basic Information > App Credentials.

  17. Copy the values for Client ID and Client Secret to use for authorizing the API calls. Use these values, represented by a string of letters and numbers, to configure the Slack cloud connector.

    Note

    If the app authorization URL or shareable URL in the Manage Distribution section displays v2, proceed to configure the Slack App Cloud Connector. If you do not see the version v2, in the URL, proceed to configure the Slack Classic App Cloud Connector.

    Manage_Distribution2.png

Configure the Slack Classic App Connector (Formerly known as Slack Enterprise Grid Connector)

Slack Enterprise Grid is a platform for all workplace collaboration that helps organizations collaborate across workspaces. Using Slack, teams can communicate, share files from other services, and work on those files together. Using the messaging and collaboration tool, users can get connected through search, direct messaging, a directory, and conversation channels for various groups, topics, and projects. Slack connects multiple interconnected workspaces. Slack also provides enhanced data protection, compliance, policy, and other regulatory requirements. For more information see the Slack documentation.

The following table displays the audit source API and security events supported by the connector.

Audit Source: API

Service or Module Covered

Event Included

Audit Logs API

All

Monitor what's happening in your Slack Enterprise Grid organization.

Table 28. Audit source API and security events supported by the connector


To configure the Slack Classic App Connector formerly known as Slack Enterprise Grid connector to import data into the Exabeam Cloud Connector platform:

  1. Complete the Prerequisites to Configure the Slack Classic App Connector (Formerly Known as Slack Enterprise Grid Connector).

  2. Log in to the Exabeam Cloud Connectors platform with your registered credentials.

  3. Navigate to Settings > Accounts > Add Account.

  4. Click Select Service to Add, then select Slack from the list.

    Slack_Classic_App.png

  5. In the Accounts section, enter the required information. Required fields are indicated with a red bar.

    1. Tenant – Select a tenant to attach to the connector if you are using a multi-tenant edition of Exabeam. Otherwise, select default.

    2. Account Name – Specify a name for the Slack connector. For example, Slack collaboration.

    3. Description – (Optional) Describe the Slack connector. For example, Slack, a platform to collaborate across workspaces.

    4. Client-ID – Enter the value for client ID that you obtained while completing prerequisites.

    5. Client-Secret – Enter the value for client secret that you obtained while completing prerequisites.

    6. External Authentication – Click the Open External OAuth Window to log in to the Slack account that you used to create the Slack app and click Authenticate.

      Note

      The External Authentication field is required even though it is not indicated with a red bar. The Slack administrator must authenticate the connection request by entering the username and password to give required permission to the Exabeam Cloud Connector.

  6. To confirm that the Exabeam Cloud Connector platform communicates with the service, click Test Connection.

  7. Click Done to save your changes. The cloud connector is now set up on the Exabeam Cloud Connector platform.

  8. To ensure that the connector is ready to send and collect data, Start the connector and check that the status shows Ok.