Skip to main content
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)
1

Create a Slack App

Create a Slack App in your workspace through the Slack API website. Select “From manifest” and then select your workspace.
2

Add Manifest

Paste in the JSON app manifest found below:
manifest.json
{
  "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
  }
}
3

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.
4

Access Recipes

Navigate to Recipes in Tempest and create or select a recipe.
5

Add Slack Resource

Add or select a Slack resource in your recipe.
6

Link Credentials

Click “Add credentials” then “+Link credentials.”
7

Select Authentication Method

Select “API Token.”
8

Name Credentials

Enter a credential name for identification.
9

Enter API Token

Input your Slack OAuth or Bot token.
10

Complete Connection

Click “Connect.”

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
I