Integrating Trusona and Slack

This guide details the steps required to configure Trusona as a passwordless authentication solution for Slack.

By Trusona Engineering
Updated Mar 3, 2020

• 1. Getting Started
  • 1.1. Prerequisites
  • 1.2. Step 1: Email Trusona
  • 1.3. Step 2: Slack workspace administration
  • 1.4. Step 3: Configure SAML
  • 1.5. Step 4: Testing the integration
  • 1.6. Customizing your Trusona experience
  • 1.7. Provide images
  • 1.8. Provide hex values

1. Getting Started

1.1. Prerequisites

In order to integrate Trusona with Slack, you’ll need the following:

• Slack Plus or Enterprise Grid plan

1.2. Step 1: Email Trusona

Send an email to support@trusona.com with the following information:

Subject: Slack Integration

1. Company name

Trusona will send you the following via email:

1. X.509 Certificate
2. SAML Endpoint
3. Issuer (IdP Entity ID)

1.3. Step 2: Slack workspace administration

1. Login to Slack as a workspace owner
2. Navigate to the workspace administration area
3. Click the “Settings” tab

1.4. Step 3: Configure SAML

Refer to this Slack help center article for more information.

1. Click the “configure” button next to the “SAML authentication” option
2. Enter the “SAML Endpoint” value provided by Trusona for “SAML SSO URL”
3. Enter the “Issuer (IdP Entity ID)” value provided by Trusona for “Identity Provider”
4. Enter the value of the “X.509 Certificate” file provided by Trusona for “Public Certificate”
5. Expand the “Advanced Options” section
6. Uncheck, “Sign AuthnRequest”
7. Leave “AuthnContextClassRef” and “Service Provider Issuer” as is
8. Uncheck the “Responses Signed” option
9. Check the “Assertions Signed” option
10. Ensure the following settings are enabled:
11. “Update profile each time a user logs in”
12. “Allow users to change their email address”
13. “Allow users to choose their own display name”
14. Choose an option that’s best for your workspace for the “Authentication for your workspace must be used by” section
15. In the “Customize” section, enter “Trusona” for the “Sign in Button Label”
16. Click “Save Configuration”

1.5. Step 4: Testing the integration

1. After saving the SAML configuration, you will be automatically redirected to Trusona to complete an authentication

1.6. Customizing your Trusona experience

The Trusona Gateway (pictured below) includes default styling that will be familiar to your users using the Trusona App.

Optionally, it’s possible to provide a custom branded experience for your users including things like:

• Custom secure QR code colors
• Your company logo and colors

In order for Trusona to create your custom gateway you need to provide to Trusona hex values and images for the following:

1.7. Provide images

• Hero image: 1440 x 1800 px
• Logo image: 500 x 500 px

1.8. Provide hex values

• Animated dot color: this is the color dots that animate
• List of QR colors: multiples of the same color will appear more (provide 2 hex values)
• Link color:
• Text color:
• Background color: affects background behind the QR, usually we just do pure white (#FFFFFF)

---