Troubleshoot SAML authorisation errors
SAML-based single sign-on (SSO) gives members access to Slack through an identity provider (IDP) of your choice. If you’re having trouble setting this up, find your error message in the table below to learn how to fix it.
Tip: If you don’t see your error message in the table or you’re still having trouble, our Support team is always happy to help. Click the Contact us button at the top of this page if you need a hand!
What causes SAML errors?
SAML errors usually occur when there’s missing or incorrect information entered during your SAML setup. You can resolve most of these issues from your IDP settings, but for some, you’ll need to update your SSO settings in Slack as well.
SAML error messages
Error message | How to fix it |
The SAML response does not contain the correct identity provider issuer. Please check that the issuer URL in your [IDP] settings matches the identity provider issuer below. | Check your IDP settings to ensure that you have the right value copied over to your workspace’s SSO page. The issuer value in an IDP is typically referred to as an issuer URL or entity URL/ID. |
The SAML response has not been signed. Please check your [IDP] settings. | Untick the Responses signed box on your workspace’s SSO page or enable signing responses in your IDP settings. If you don’t see these options, contact your IDP. |
The SAML response does not contain the correct audience. Please check that the service provider URL in your [IDP] settings matches the service provider issuer in advanced options below. | Make sure that the service provider issuer matches the audience in your IDP settings. The audience might also be called the SP entity ID or relying party identifier. We support https://slack.com and your workspace URL (https://yourteam.slack.com). |
The assertion of the SAML response has not been signed. Please check your [IDP] settings. | Untick the Assertions signed box on your workspace’s SSO page or enable signing assertions of responses in your IDP settings. If you don’t see these options, contact your IDP. |
The SAML response does not contain the correct destination, which should look something like https://yourteam.slack.com/sso/saml. Please check your [IDP] settings. | Update the destination in your IDP. The value’s name may vary, but it will typically be one of the following: Reply URL, ACS URL, assertion consumer service URL, trusted URL or endpoint URL. |
The SAML response is missing the ID attribute. Please check your [IDP] settings. | Make sure that you’re including the NameID as a claim sent in your IDP in the correct (persistent) format. |
Neither the SAML response nor assertion of the SAML response have been signed. Please check your [IDP] settings. | From your IDP settings, enable signing the response, the assertion of the response or both. If you don’t see these options, contact your IDP. |
The SAML response has not been signed (though there is a signed and encrypted assertion with an encrypted ID). Apologies, but Slack doesn’t support this format. Please check your [IDP] settings. | We don’t support this format. Enable signing the response and make sure that you’re following the guidelines to set up your SSO properly. |
The SAML response is not version 2.0. Please check your [IDP] settings. | Make sure that you’re using SAML 2.0 in your IDP. |
The SAML response was not sent through a HTTP_POST binding. Please check your [IDP] settings. | Make sure that you’re sending the SAML response in a POST. Then check that you’ve entered the right SSO URL in your IDP settings and configured your IDP properly. |
Hmm, it looks like the signature validation failed. Please check the signing certs in your [IDP] settings. | Update the certificate in your workspace's SSO page to match the certificate sent from your IDP. |
Oh dear, your SAML settings were not able to be parsed or saved. Please double-check them and try again. | The maximum length for SAML labels is 20 characters. Check your SAML configuration and make sure that you've selected a label that's shorter than 20 characters. |
Who can use this feature?
- Workspace owners and org owners
- Business+ and Enterprise Grid subscriptions