Slack is a messaging platform for team collaboration that brings together people, data, and tools. The Slack App in Tempest enables integration with Slack workspaces to create channels on-demand and import them into your service catalog.
For detailed information about each resource, see the Resources section below.
Authentication
These are the supported authentication methods for Slack in Tempest:
API Token
Ensure your Slack API token has appropriate permissions for all features you
plan to use through Tempest.
Tempest uses Slack API Token authentication to interact with Slack workspaces. This requires:
Slack API Token (Bot token)
How to get a Slack API Token
Create a Slack App
Create a Slack App in your workspace through the Slack API website . Select “From manifest” and then select your workspace.
Add Manifest
Paste in the JSON app manifest found below:
{
"display_information" : {
"name" : "Tempest" ,
"description" : "Tempest Slack App" ,
"background_color" : "#000000"
},
"features" : {
"app_home" : {
"home_tab_enabled" : false ,
"messages_tab_enabled" : true ,
"messages_tab_read_only_enabled" : true
},
"bot_user" : {
"display_name" : "Tempest" ,
"always_online" : true
}
},
"oauth_config" : {
"scopes" : {
"bot" : [
"app_mentions:read" ,
"channels:history" ,
"channels:join" ,
"channels:manage" ,
"channels:read" ,
"chat:write.customize" ,
"chat:write.public" ,
"chat:write" ,
"groups:history" ,
"groups:read" ,
"groups:write" ,
"im:history" ,
"im:read" ,
"im:write" ,
"mpim:history" ,
"mpim:read" ,
"mpim:write" ,
"team:read" ,
"usergroups:read" ,
"usergroups:write" ,
"users:read" ,
"users.profile:read"
]
}
},
"settings" : {
"event_subscriptions" : {
"bot_events" : [
"app_mention"
]
},
"interactivity" : {
"is_enabled" : true
},
"org_deploy_enabled" : false ,
"socket_mode_enabled" : true ,
"token_rotation_enabled" : false
}
}
Install the App
In the sidebar, click “Install App” and install it in your workspace. Save the Bot User OAuth Token which is shown after the app is installed—it should start with xoxb
.
Access Recipes
Navigate to Recipes in Tempest and create or select a recipe.
Add Slack Resource
Add or select a Slack resource in your recipe.
Link Credentials
Click “Add credentials” then “+Link credentials.”
Select Authentication Method
Name Credentials
Enter a credential name for identification.
Enter API Token
Input your Slack OAuth or Bot token.
Resources
Channel
Create, manage, and import Slack channels within your workspace.
Configuration options:
Channel name (required): The name of the channel, in alphanumeric with hyphens and underscores only
Channel topic: The topic of the Slack channel
Properties:
ID: The Slack channel identifier
Name: The name of the channel
Topic: The channel topic
Is Private: Whether the channel is private
Created: Date when the channel was created
Creator: The ID of the user who created the channel
Number of Members: The count of members in the channel