Slack Connector

Used for OneTrust Data Discovery Scanners, the Slack Connector can scan and retrieve information from chat messages in the communication tool.

Pod Residency

<app-scanner>

Category

Connection Application

This connector relies on OAuth client credentials with scopes to grant necessary access to the Slack app that OneTrust will integrate with.

{
"access_token": "token"
}

The app must belong to an Enterprise Grid where the user has an owner role.

1. Navigate to Slack API - Apps.

2. Log in to your dedicated Slack sandbox or launch your workspace.

3. Click the Create New App button. The Create an app modal appears.

   
   
   

4. Select the option From scratch.

   
   
   

5. Provide a unique name for this new app, then choose the appropriate workspace for this new app.

   
   
   

6. Click the Create App button. The Basic Information screen appears.

7. Click Add features and functionality, then choose Permissions. The OAuth & Permissions screen appears.

   
   
   

8. Scroll to the Scopes > User Token Scopes, then click the Add an OAuth Scope button.

   
   
   

9. Select discovery:read.

   Important:

   Customers must contact Slack to enable the discovery:read scope for use.

   
   
   

10. Navigate to Redirect URLs to add a new redirect URL for https://localhost . Ensure that you click the Save URLs button.

    
    
    

11. Navigate to Settings > Manage Distribution.

12. In the Share Your App with Other Workspaces section, click the Activate Public Distribution button.

    
    
    

13. Scroll up to the Share Your App with Your Workspaces section to copy the Sharable URL.

    
    
    

14. Paste this URL into a browser and select the correct organizational workspace.

15. Click Allow. You will be redirected to the code generation page to copy the code from the URL field.

    
    
    
    CODECopy

    localhost/?code=<code>&state=                                                                                                                                                                                                                                                                                 This site can't be reached                                                                                                                                                                                                                                                                                  localhost refused to connect.                                                                                                                                                                                                                                                                                 Try:                                                                                                                                                                                                                                                                                               • Checking the connection                                                                                                                                                                                                                                                                                              • Checking the proxy and the firewall                                                                                                                                                                                                                                                                                   ERR_CONNECTION_REFUSED                                                                                                                                                                                                                                                                                          Details                                                                                                                                                                                                                                                  Reload

    localhost/?code=<code>&state=                                                                                                                                                                                                                                                                                 This site can't be reached                                                                                                                                                                                                                                                                                  localhost refused to connect.                                                                                                                                                                                                                                                                                 Try:                                                                                                                                                                                                                                                                                               • Checking the connection                                                                                                                                                                                                                                                                                              • Checking the proxy and the firewall                                                                                                                                                                                                                                                                                   ERR_CONNECTION_REFUSED                                                                                                                                                                                                                                                                                          Details                                                                                                                                                                                                                                                  Reload

    
    
    

16. Use this code plus the Client ID and Client Secret in order to generate the Discovery API token in your chosen developer tool.

    Tip:

    Client ID and Client Secret can be copied from the Slack app's Basic Information screen.

    
    
    
    JSONCopy

    #Sample Response { "ok": true, "app_id": "<your-app-id>", "authed_user": { "id": "scope": "discovery:read", "access_token": "<your-generated-code>", "token_type": "user", }, "team": null, "enterprise": { "id": "<your-enterprise-id>", "name": "<your-org-name>" }, "is_enterprise_install": "true }

    #Sample Response
    {
        "ok": true, 
        "app_id": "<your-app-id>",
        "authed_user": {
            "id": 
            "scope": "discovery:read", 
            "access_token": "<your-generated-code>",
            "token_type": "user",
        }, 
        "team": null, 
        "enterprise": {
            "id": "<your-enterprise-id>",
            "name": "<your-org-name>"
        },
        "is_enterprise_install": "true
    }