Integrating Slack Workspace with an Isolated Cloud Site
Slack marketplace apps are built for multi-tenant environments. These apps are incompatible with Isolated Cloud sites, which are provisioned on isolated, single-tenant environments.
Integrating a Slack workspace with your Isolated Cloud site requires a Custom Integration. This will communicate directly with a custom app on your Slack workspace.
This page assumes that you already have an existing Slack workspace. For instructions on how to create one, see Create a Slack workspace.
Creating a custom Slack app and integrating it with an Atlassian app on the Isolated Cloud involves a shared responsibility between you and Atlassian. Review Shared responsibilities for custom Slack apps for details.
Create Slack app and Isolated Cloud site integration
To integrate your Slack workspace with your site, you’ll need to create two integrations simultaneously:
A Slack app
An Isolated Cloud site Custom Integration
Each integration requires credentials and settings from the other at various stages of creation.
A single Custom Integration will only integrate your Slack workspace to either Jira or Confluence. If your Slack workspace needs access to both on your site, you’ll need to create separate Custom Integrations for each.
Step 1: Initiate site Custom Integration
Start by creating your site’s Custom Integration:
Access your site’s Connected apps page. The process is identical to how it’s done in commercial environments; see View an app for instructions.
On the Connected apps page, click Add Custom Integration on the top right.
Select which app to integrate with your Slack workspace, then select Next.
On the Configure and connect Slack screen, enter a name for your Custom Integration in the App name field. Doing this will populate the field below with a manifest you’ll use later when creating the Slack app.
Click Copy to Slack to copy the manifest content. You’ll use that in the next step.
The default manifest provided by this wizard also defines scopes and permissions used by different app features. If your organization requires strict security rules, you may need to edit the manifest’s scopes before proceeding to the next step. See Slack apps scopes reference for details.
The Configure and connect Slack screen contains other fields like Client ID and Client Secret. You’ll get the required values for those fields after Step 2: Create a Slack custom app.
Once you have those values, you can finish creating the Custom Integration. For now, leave the browser and wizard open.
Step 2: Create a Slack app
Your Custom Integration isn’t done yet. However, you should have the manifest content you need to start creating the Custom Integration’s corresponding Slack app.
To initiate this, open a new browser window where you’ll create the new Slack app (as you’ll be returning to the Configure and connect Slack screen later to finish creating the Custom Integration). On the new browser window:
Go to https://api.slack.com/apps.
Select Create New App to launch the app creation wizard.
Choose the From a manifest option, since you already have the manifest settings you need.Select the workspace you want to integrate with your Isolated Cloud site.
On the Create app from manifest screen, paste the contents you copied from the previous step into the JSON field, then select Next.
Review the manifest settings (OAUth, Features, Settings) and select Create.
Once the app is created, you can select it from https://api.slack.com/apps.
Select on the app to view its details. The app’s Basic Information tab contains the App Credentials you’ll need to finish your Isolated Cloud site’s Custom Integration (in the next step).
Step 3: Create a Bot Token
To finish creating your Custom Integration (which you initiated in Step 1: Initiate site Custom Integration), you’ll need a Bot Token from your Slack app. To get it, you’ll need to first install your Slack app on your Isolated Cloud site:
Go to https://api.slack.com/apps.
Click your Slack app to view its details.
Under the Settings category, select Install app in the left navigation.
Select the Install button on that page.
Review the Slack app’s permissions and then click Allow.
You’ll be returned to the Install App screen, which now has an OAuth Tokens section. This section includes a Bot User OAuth Token, which you’ll need for the Bot Token field in the next step.
Step 4: Create an Install Token (Confluence only)
Custom Integrations for Confluence will also require an Install Token from your Slack app. To create one:
Go to https://api.slack.com/apps.
Click your Slack app to view its details.
By default, the Basic Information tab should appear. Scroll down to the App-Level Tokens section and click Generate Token and Scopes.
On the Generate an app-level token wizard, enter a Token Name.
Click Add Scope and select
authorizations:readfrom the options.Now that
authorizations:readis part of the token’s scope, click Generate. The screen will show you the details for the token.
The token will also appear in the App-Level Tokens section, and you can return to it later.
Step 5: Finish creating Custom Integration
Now that the Slack app is created and installed on your Isolated Cloud site, you now have all the details to finish the Custom Integration you started earlier.
The Configure and connect Slack wizard (which you left open in Step 1: Initiate site Custom Integration) still has several fields you need to fill:
To get your Slack app’s Client ID, Client Secret, and Signing Secret:
Go to https://api.slack.com/apps.
Click your Slack app to view its details.
By default, the Basic Information tab should appear. The App Credentials section contains the details you’re looking for.
To get your Slack app’s manifest:
Go to https://api.slack.com/apps.
Click your Slack app to view its details.
Select App Manifest in the left navigation (under the Features category).
On the App Manifest screen, click Copy to Clipboard.
To get your Slack app’s Install token (Confluence only):
Go to https://api.slack.com/apps.
Click your Slack app to view its details.
By default, the Basic Information tab should appear. Scroll down to the App-Level Tokens section and select the token you created in Step 4: Create an Install Token (Confluence only).
To get your Slack app’s Bot Token:
Go to https://api.slack.com/apps.
Click your Slack app to view its details.
Select Install app in the left navigation (under the Settings category). This page now has an OAuth Tokens section; the Bot User OAuth Token is your Bot Token.
Once you’ve copied all the details from your Slack app, click Connect on the Configure and connect Slack wizard. You’ll be asked to verify the Custom Integration’s workspace and permissions:
You’ll get a notification if the process was successful, or if there are issues that require attention (for example, if your Slack email is different from your Isolated Cloud site email).
Once the Custom Integration is created, your Isolated Cloud site should be integrated with your Slack workspace. The Custom Integration will appear in the Installed app section of your site’s Connected apps.
Was this helpful?