Support and Documentation

Slack Federated Search

The Slack plugins for federated search add the capability to search for files stored on your Slack workspace directly from search panel. You can import the found files into Brightspot and use them as any other asset. See Federated search and import for more information.

Configuring Slack Federated Search

Administrators perform this task.

Slack federated search requires a Slack account with an app configured to provide access to workspace files. The Slack app shares configuration values with Brightspot.

If your version of Brightspot is missing any of the following configuration options, contact your Brightspot representative.

Procedure. To configure Slack federated search:
  1. From the Navigation Menu, select Sites & Settings.

  2. In the Sites widget, select Global.

  3. Under Main, ensure that the Default Tool URL field is set.

  4. In the Sites widget, select the site for which you want to configure Slack federated search, or select Global to configure Slack federated search for all sites.

  5. Under Main, expand Slack.

  6. In the Client ID field, paste the redirect URL into a text editor.

    client-id-field-empty.svg
  7. Click Slack API Console to access your Slack console. If prompted, log into your Slack account. The Slack Your Apps page appears.

  8. On the Your Apps page, click Create an App.

  9. Name the app and select the workspace that you would like Brightspot to search.

    slack-create-app.png
  10. Click Create App. The Basic Information page appears.

  11. Click Permissions. The OAuth & Permissions page appears.

  12. Under Redirect URLs, do the following:

    1. Click Add New Redirect URL.

    2. Enter the redirect URL from step 6 and click Add New Redirect URL.

    3. Click Save URLs.

      slack-redirect-url.png
  13. Under Select Permission Scopes, add the search:read and files:read scopes, then click Save Changes.

    slack-scope-settings.png
  14. Scroll to the top of the OAuth & Permissions page and click Install App to Workspace.

    Note

    Depending on your role in the Slack workspace, you may first have to request approval to install the app.

  15. Click Authorize.

  16. On the Slack API page for your app, under Settings, click Basic Information.

  17. Scroll to App Credentials.

    slack-client-id-secret.png
  18. Copy the client ID and client secret values to the Client ID and Client Secret fields on the Edit Site widget.

    client-id-field-set.png
  19. Click Save.

  20. Verify the plugin is enabled. In the search panel, in the Create widget, ensure you can select Slack File.

    external-menu-box.png