This guide explains how to integrate Assertiv with Slack using SAML. When this set up is complete, users will be able to log into Slack using their Assertiv account.
To use SAML with Slack, you must be on the Slack Plus plan or higher.
Create Slack app in Assertiv
Log into your Assertiv Organization (https://<your-org>.assertiv.com) as an Admin user and select the App Config dashboard tile.
Select the plus (
) button to create a new App config.
Search for the Slack application and select the Slack icon.
You will be prompted for some information on the following page.
Slack Service Name: This is the name of the application how you would like it to appear in Assertiv. Make this a descriptive name that your users will understand. E.g "Corporate Slack"
Signing Certificate: The certificate is used to create a trust between Assertiv and your Slack account. For advanced users, if you have created a certificate you wish to use, select it here. Otherwise (or if you are unsure) you can select "-- Generate New Signing Certificate --".
Slack Subdomain URL Prefix: When you create a slack account, you are given a specialized URL for your organization (e.g. https://acme.slack.com). Enter the first section of the URL hostname. E.g. for https://acme.slack.com, enter acme.
Save the configuration
You should now be shown the Edit Service page with some additional information.
Configure Slack
Access the Administration, Workspace Settings menu from Slack.
Select the Authentication tab, then setup or change the SAML Authentication Settings
This page may look slightly different if you have not set up SAML on your account before.
Using the information from the Assertiv 'Edit Service' page above, fill in the details in the Slack configuration.
Match your Advanced settings to the following
The following sections can be configured optionally, however these are the recommended settings.
Save the configuration.
You will be redirected back to Assertiv, which will attempt a test single sign-on. If this is successful, you will see the following message.
Configure Roles
In order for your users to access Slack from their Assertiv apps page, you must set up a role, assign users to the role, and give that role permission to access the Slack application.
More details on roles can be found in the following articles