Skip to main content
  • Latest version: v1.0.0
  • Compatible with Fusion version: 5.4.0 and later
The Slack connector does not function due to Slack disabling crawling access.

Authentication

You must install a Slack application in the workspace that will be indexed before using the Slack V2 connector. See Slack’s Basic app setup for more information about installing a Slack application. Once the app is correctly installed in the workspace, Slack will provide an access token, which you will then use in the Slack V2 connector configuration.

Required application scopes

The Slack application must provide access to the following User Token Scopes in order to work with Slack V2 connector: Slack User Token Scopes

Initial actions

The Slack V2 connector will perform the following actions at the beginning of each job:
  • Load all users in the users cache. This information will be used later to resolve user names when processing mentions in messages.
    It will also be useful for avoiding requests to retrieve user’s metadata.
  • Load the channels to be processed using the channel filtering properties from the configuration.
    This will be useful to establish a source of truth when determining whether a channel should be indexed or deleted on each job.

Document filtering

Crawling process

Due to limitations in the Slack Web API, edited and deleted messages cannot be retrieved. You must clear the datasource and start a new connectors job to index edited messages and/or remove deleted messages.

Crawl process diagram

Endpoints used in the crawling process

Message mentions processing

The Slack V2 connector retrieves messages from the Slack API in the following format:
In this example, @U01U580HSDN is the user Id. The connector will resolve the user Id with the user’s display name, if it exists. Otherwise, it will use the full name in the user’s profile.

Incremental Crawling processors

Each incremental job will re-index the User ACL to update all users in the Access Control Collection, and the Channel ACL to update the members of each channel.

Security filtering

Security filtering processors

Access Control Document links

Security trimming rules

Security trimming uses the following rules:
  • All users (regular and guest) can see the profile of any user in the Slack workspace.
  • All regular users can access public channels and messages, even if they are not members of the channel.
  • Guest users can only access the public or private channels they are members of.
  • Only the members of private channels can access the channel and messages.
  • Only the users involved can access direct messages and multi-party direct messages.

Remote connectors

V2 connectors support running remotely in Fusion versions 5.7.1 and later. For more information, see Configure remote V2 connectors. Below is an example configuration showing how to specify the file system to index under the connector-plugins entry in your values.yaml file:
You may also need to specify the user that is authorized to access the file system, as in this example:

Configuration