Metabase (SAML)
This guide details the steps required to configure Descope to work with Metabase as a federated identity provider, using SAML.
You can refer to the Metabase SAML documentation for more information on how this works and how to configure the Metabase side: Metabase SAML Authentication.
Note
Keep in mind that only the Pro and Enterprise tiers of Metabase work with SAML authentication.
Table of Contents
These steps will be taken in parallel, so it's a good idea to have the Descope Console and your Metabase Settings Dashboard both open before you begin.
Descope Configuration
- Create a New SAML Application: In your Descope console, go to the Applications section in the Descope Console and add a new SAML application.
- Configure Descope's SAML Settings in Metabase: Copy the
Entity ID
andXML URL
from Descope and paste them into the respective fields in Metabase's SSO Configuration.
You can skip to the Metabase Configuration section to get instructions on where to put these in Metabase. Once you've completed the Metabase Configuration steps, return here to complete the setup process.
-
Enter Metabase's Metadata: You'll need to select
Enter the connection details manually
, and from there input theACS URL
,Entity ID
andCertificate
that you retrieved from Metabase in Step 3 under Metabase Configuration below. -
SSO Mapping: This is found in the settings for your new SAML application. You'll need to map at least email to each of your Descope Users. It's also a good idea to map first and last name as well, along with SAML groups that are already configured in Metabase. You can do so by configuring the SSO mapping like this:
Descope Field | SAML Claim |
---|---|
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress | |
Given Name | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname |
Family Name | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname |
Descope Roles | http://schemas.xmlsoap.org/claims/Group |
Here is an example of what this looks like:
Metabase Configuration
- Set up SAML in Metabase: Navigate to the Admin Panel in Metabase, then to the Authentication tab. Select 'SAML' and enable it.
- Configure SAML Settings: Fill in the necessary details such as
SAML Identity Provider URL
,Entity ID
, etc., as required by Metabase. - Copy Over IdP Configuration Settings: You'll need to gather the
URL the IdP should redirect to
, as well as theEntity ID
andCertificate
from Metabase for use in the Descope Console. For more information, visit the Metabase docs page.
Now return to the Descope Console and put in the necessary information under SP Configuration. These steps are detailed above, under Step 3 of the Descope Configuration section.