Slack

introduction this guide tells you how to authenticate the slack connector in swimlane you can authenticate using one of the following methods api key authentication http bearer authentication you will create a slack app, assign required scopes, obtain an access token, and configure the connector in swimlane prerequisites slack access requirements you must have slack permissions to create and manage slack apps for your workspace install an app to your workspace authorize requested oauth scopes required credentials during setup, you will collect url api token bot or user token urls base url use the following base url for slack api requests https //slack com/api slack setup the slack asset requires an api token bot or user token to set up a slack bot oauth api with the appropriate permissions follow these steps go to the slack api website https //api slack com/ click your apps in the top right corner and then click create new app provide a name for your app and select the slack workspace where you want to install the app once the app is created, you'll be redirected to the app's settings page from the app's settings page, navigate to oauth & permissions under scopes section for bot token scopes, add the necessary scopes for the api calls (see the scopes list below) install the app to your workspace in oauth & permissions, scroll down to the oauth tokens for your workspace section and click install app to workspace button authorize the app to access your slack workspace by following the prompts after installing the app, you'll be provided with access tokens such as bot user oauth access token copy the token for use in swimlane scopes add the necessary scopes based on the api calls you plan to run common scopes used by this connector include chat\ write chat\ write customize channels\ history channels\ manage channels\ read groups\ write groups\ history groups\ read im\ history im\ read im\ write mpim\ history mpim\ read mpim\ write users\ read for lookup by email action, please set the scope parameter to users\ read email connector configuration in swimlane log in to turbine from the left hand navigation pane, click orchestration and click assets asset homepage opens click plus icon to open the configure your connector asset window select slack from the asset type list fill in the asset settings and asset input as shown configuration api key authentication authenticates using an api key fill in the asset settings and asset input as shown field description required/optional url a url to the target host required token api key required verify ssl verify ssl certificate optional http proxy a proxy to route requests through optional fields with marks are required configuration http bearer authentication authenticates using bearer token such as a jwt, etc fill in the asset settings and asset input as shown field description required/optional url a url to the target host required token the api key, token, etc required verify ssl verify ssl certificate optional http proxy a proxy to route requests through optional fields with marks are required click create troubleshooting if you encounter an authentication error verify the token is correct and has not been revoked verify the app is installed to the correct workspace verify the required scopes are added and re install the app after changing scopes for lookup by email, verify users\ read email is granted if required, configure http proxy and verify outbound connectivity you have successfully authenticated the slack connector in swimlane