Single sign-on
Single sign-on (SSO) authentication allows users to authenticate via their organization's third-party identity provider (IdP) and gain access to a different system by providing proof of their authentication.
For you, this means that you can delegate Dashboard authentication to a third-party IdP. You can also choose whether to manage your users, roles, and entity access in your IdP or in the Dashboard.
You can use any identity provider to enable SSO with Dashboard, as long as they support Security Assertion Markup Language 2.0 (SAML).
We recommend single sign-on as the default approach to Dashboard team management.
Information
To learn more, contact your account manager or request support.
When you set up SSO, you choose where to manage user access and permissions:
- In your Identity Provider – Your IdP authenticates your users and assigns their roles and entity access. You map your IdP's SAML attribute values to Dashboard roles and entities during setup.
- In the Dashboard – Your IdP handles sign-in only. You add users and manage their roles and entity access manually in the Dashboard, in the same way as without SSO.
You can change how you manage users after you set up SSO. You must have the Account owner or IAM admin user role to change this setting.
- Sign in to the Dashboard.
- Select the Settings menu in the top navigation bar, and then select Settings.
- Under Team settings, select Single sign-on.
- Under Select how to manage users, select In your Identity Provider or In the Dashboard.
When you switch to In your Identity Provider, the Edit Dashboard role mapping screen opens so you can set up the role mapping this option requires. Map your IdP's SAML attribute values to Dashboard roles. Before you complete the change, select Review SAML attributes on the same screen to check that your IdP sends a group that matches one of your mapped roles.
You can use SSO to:
- Sign in to the Dashboard directly through your SSO platform's portal.
- Grant, update, and revoke your team's Dashboard access, if you manage users in your identity provider.
- Mandate your organization's security policies, such as multi-factor authentication, password policies, and account recovery procedures.
If you manage users in your identity provider, enabling SSO authentication in the Dashboard can simplify user management, as user access and permissions are granted or revoked automatically based on the user's identity and assigned groups in your SSO platform.
In addition, as you can mandate and enforce authentication standards directly from the SSO platform, you can increase security around your Dashboard access.
There are some limitations to be aware of if you decide to enable SSO for the Dashboard:
This limitation only applies if you manage users in your identity provider.
Because the Dashboard relies on the SSO service to grant user access and role information during authentication, the Dashboard is unaware of any changes in a user's permissions until they try to sign in. If a user's access is revoked via SSO, this change doesn't appear in the Dashboard UI until the user attempts to sign in again, or until an Admin manually removes that user using the Dashboard UI. This limitation only affects the UI. Users with revoked access in your IdP can never access the Dashboard.
System for Cross-domain Identity Management (SCIM) protocol, used to synchronize user identity details and permissions with applications, is not supported.