{"hash":"slack","items":[{"hash":"0","content":"<h1 id=\"configure-sso-integration-for-slack\">Configure SSO Integration for Slack</h1>\n<p>The Slack <a href=\"https://auth0.com/docs/sso\">Single Sign-on (SSO)</a> Integration creates a client application that uses Auth0 for authentication and provides SSO capabilities for Slack. Your users log in to Slack with Auth0 <a href=\"https://auth0.com/docs/identityproviders\">identity providers</a>, which means the identity provider performs the identity credentials verification.</p>\n"},{"hash":"1","content":"<h2 id=\"prerequisites\">Prerequisites</h2>\n<p>Before you begin:</p>\n<ul>\n<li>Sign up for a Slack account.</li>\n<li><a href=\"https://auth0.com/docs/identityproviders\">Set up a connection</a>, which is a source of users. Connections can be databases, social identity providers, or enterprise identity providers, and can be shared among different applications. You may set up more than one connection for use with SSO integrations.</li>\n</ul>\n"},{"hash":"2","content":"<h2 id=\"steps\">Steps</h2>\n<p>To configure a Slack SSO integration, you will:</p>\n<ol>\n<li><a href=\"#consent-to-auth0-sso-integration\">Consent to Auth0 SSO integration</a></li>\n<li><a href=\"#create-auth0-sso-integration\">Configure Auth0 SSO integration</a></li>\n<li><a href=\"#configure-integration-with-slack\">Configure integration with Slack</a></li>\n<li><a href=\"#enable-connections\">Enable connections</a></li>\n</ol>\n"},{"hash":"3","content":"<h3 id=\"consent-to-auth-0-sso-integration\">Consent to Auth0 SSO integration</h3>\n<ol>\n<li>\n<p>Navigate to <a href=\"https://manage.auth0.com/#/externalapps\">Auth0 Dashboard &gt; Applications &gt; SSO Integrations</a>, and click <strong>+ Create SSO Integration</strong>.\n<img src=\"https://auth0.com/docs/media/articles/dashboard/sso-integrations/dashboard-integrations-sso-create_list.png\" alt=\"Create SSO Integration\" /></p>\n</li>\n<li>\n<p>Select <strong>Slack</strong>.\n<img src=\"https://auth0.com/docs/media/articles/dashboard/sso-integrations/dashboard-integrations-sso-create_select-service.png\" alt=\"Select Service\" /></p>\n</li>\n<li>\n<p>Click <strong>Continue</strong> to grant the integration access to the listed permissions.\n<img src=\"https://auth0.com/docs/media/articles/dashboard/sso-integrations/dashboard-integrations-sso-create_consent.png\" alt=\"Authorize Service\" /></p>\n</li>\n</ol>\n"},{"hash":"4","content":"<h3 id=\"configure-auth-0-sso-integration\">Configure Auth0 SSO Integration</h3>\n<p>Enter a name for your SSO Integration, configure the following settings, and click <strong>Save</strong>.</p>\n<table class=\"table\">\n    <thead>\n        <tr>\n            <th><strong>Setting</strong></th>\n            <th><strong>Description</strong></th>\n        </tr>\n    </thead>\n    <tbody>\n        <tr>\n            <td>Team Name</td>\n            <td>Name of your Slack team.</td>\n        </tr>\n        <tr>\n            <td>Use Auth0 instead of the IdP to do Single Sign-on (SSO). **Legacy tenants only.**</td>\n            <td>If enabled, Auth0 will handle SSO instead of Slack.</td>\n        </tr>\n    </tbody>\n</table>\n<p><img src=\"https://auth0.com/docs/media/articles/dashboard/sso-integrations/dashboard-integrations-sso-create_settings.png\" alt=\"Save Integration\" /></p>\n"},{"hash":"5","content":"<h3 id=\"configure-integration-with-slack\">Configure integration with Slack</h3>\n<p>To configure the integration with Slack, follow the instructions listed in the <strong>Tutorial</strong> view.</p>\n"},{"hash":"6","content":"<h4 id=\"slack-sso-integration\">Slack SSO integration</h4>\n<p>Before you continue, make sure you have your SSO integration Client ID. You will use the Client ID to replace the <code>SSO_CLIENT_ID</code> placeholders.</p>\n<p><img src=\"https://auth0.com/docs/media/articles/dashboard/sso-integrations/dashboard-integrations-sso-create_view-tutorial.png\" alt=\"Locate Client ID\" /></p>\n<ol>\n<li>\n<p>Log in to <a href=\"https://slack.com/admin/auth\">Slack Authentication Settings</a> as an administrator.</p>\n</li>\n<li>\n<p>Go to <strong>SAML authentication</strong> &gt; <strong>Configure</strong>.</p>\n</li>\n<li>\n<p>For <strong>SAML provider</strong>, choose <strong>Custom SAML 2.0</strong>.</p>\n</li>\n<li>\n<p>Enter the <strong>SAML 2.0 Endpoint (HTTP)</strong> (be sure to replace the SSO_CLIENT_ID placeholder with the Client ID of your SSO Integration):\n<code>https://{yourDomain}/samlp/SSO_CLIENT_ID</code></p>\n</li>\n</ol>\n<p>Alternatively, to log in with a specific identity provider, you can add a <code>connection</code> parameter (be sure to replace the SSO_CLIENT_ID placeholder with the Client ID of your SSO Integration):</p>\n<pre><code class=\"language-text\">https://{yourDomain}/samlp/SSO_CLIENT_ID?connection=email\nhttps://{yourDomain}/samlp/SSO_CLIENT_ID?connection=google-oauth2\nhttps://{yourDomain}/samlp/SSO_CLIENT_ID?connection=Username-Password-Authentication\n</code></pre>\n<p>In this case, Auth0 will redirect users to the specified connection and will not display the Login widget. Make sure you send the SAMLRequest using <code>HTTP POST</code>.</p>\n<ol start=\"5\">\n<li>\n<p>(Optional) Enter the <strong>Identity Provider Issuer</strong>:\n<code>urn:{yourDomain}</code></p>\n</li>\n<li>\n<p><a href=\"https://{yourDomain}/pem\">Download your Auth0 signing certificate</a>; copy and paste its contents as the <strong>Public certificate</strong>.</p>\n</li>\n<li>\n<p>Save your configuration.</p>\n</li>\n</ol>\n"},{"hash":"7","content":"<h3 id=\"enable-connections\">Enable connections</h3>\n<p>Choose the connections to use with your SSO integration. Users in enabled connections will be allowed to log in to Slack. By default, all configured connections are enabled.</p>\n<ol>\n<li>\n<p>Select the <strong>Connections</strong> view.</p>\n</li>\n<li>\n<p>Toggle the sliders next to connection names to enable or disable them.\n<img src=\"https://auth0.com/docs/media/articles/dashboard/sso-integrations/dashboard-integrations-sso-create_view-connections.png\" alt=\"Enable/Disable Connections\" /></p>\n</li>\n</ol>\n"}]}