{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Administration","product_name":"Control Panel","type":"markdown"},"seo":{"title":"Configuring a SAML 2.0 Identity Provider for SSO","description":"Connect a SAML 2.0 identity provider with no dedicated guide to Treasure AI SSO. Register Treasure AI in your IdP, configure Sign-in Settings, and test sign-in.","siteUrl":"https://docs.treasure.ai","image":"/assets/treasure-ai-social-preview.e6fefb35676f6da91c2d1bc783bd39e618e7af2b1ad3aa52a96ae69d72e700fe.b1bff462.png","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"configuring-a-saml-20-identity-provider-for-sso","__idx":0},"children":["Configuring a SAML 2.0 Identity Provider for SSO"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure AI single sign-on (SSO) uses the SAML 2.0 protocol, so an identity provider (IdP) that supports SAML 2.0 can be connected to a Treasure account. Connecting your IdP lets your users sign in to Treasure Console with the credentials your company already manages, and the sign-in policies you set in your IdP apply to them. Use this page when your IdP doesn't have its own setup guide. For IdPs that do, such as Okta, Microsoft Entra ID, PingFederate, and PingOne, follow the provider guides listed in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/control-panel/security/sign-in-settings/single-sign-on"},"children":["Single Sign on"]}," instead."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-begin","__idx":1},"children":["Before You Begin"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure you have the following before you start:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SSO is enabled for your Treasure account. Contact your Customer Success representative to enable it. They provide your account name and Entity ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Owner or administrator access to Treasure Console."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Administrator access to your IdP, so you can create a SAML application and assign users to it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For an IdP that isn't in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identity Provider Name"]}," list, a Treasure AI API key. Get the key from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["My Settings"]}," in Treasure Console."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From your IdP: the sign-in endpoint URL, and the signing certificate in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".pem"]}," format or a metadata XML file. The sign-out endpoint URL is optional."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"know-the-limitations","__idx":2},"children":["Know the Limitations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Keep these limitations in mind before you configure SSO:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI supports only SP-initiated sign-in."]}," Users must start sign-in from the Treasure sign-in URL described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-the-values-from-treasure-ai"},"children":["Get the Values from Treasure AI"]},". Sign-in started from an application tile in your IdP's dashboard (IdP-initiated sign-in) isn't supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enabling SSO disables Google SSO sign-in"]}," for the users of that account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Treasure AI doesn't import users from your IdP."]}," Add each user in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Control Panel"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]}," and set their sign-in method to your IdP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users added for SSO don't receive an invitation email."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Multiple IdPs for one account"]}," require enabling by your Customer Success representative."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-the-values-from-treasure-ai","__idx":3},"children":["Get the Values from Treasure AI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your Customer Success representative provides the account name for your Treasure account. Treasure Console shows the Entity ID in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-in Settings"]},". The Entity ID uses this format:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"urn:treasuredata:sso:<SITE>:<ACCOUNT_NAME>\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<SITE>"]}," with the site of your Treasure account, which is one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aws"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aws-tokyo"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eu01"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ap02"]},". Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<ACCOUNT_NAME>"]}," with your account name."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Users start sign-in from the following URL, which you use as the sign-in URL for your region:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["US: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://console.us01.treasuredata.com/users/initiate_sso?account_name=<ACCOUNT_NAME>"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Japan: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://console.treasuredata.co.jp/users/initiate_sso?account_name=<ACCOUNT_NAME>"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Europe: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://console.eu01.treasuredata.com/users/initiate_sso?account_name=<ACCOUNT_NAME>"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For other regions, use the sign-in URL that your Customer Success representative provides."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"register-treasure-ai-in-your-idp","__idx":4},"children":["Register Treasure AI in Your IdP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your IdP administrator registers Treasure AI as a SAML 2.0 application. Menu names vary by IdP, so use the terms your IdP shows for each value:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a new SAML 2.0 application for Treasure AI. Give it a name your users recognize."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the Assertion Consumer Service (ACS) URL, which your IdP may call the Single Sign-On URL, Reply URL, or Recipient URL, to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://sso.treasuredata.com/login/callback"]},". This value is the same for all sites and regions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the Audience URI (SP Entity ID) to the Entity ID from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#get-the-values-from-treasure-ai"},"children":["Get the Values from Treasure AI"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the NameID format to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unspecified"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["emailAddress"]},". Choose the user attribute that identifies each user, such as the email address or a custom identifier. The value your IdP sends must match the identifier set for the user in Treasure Console. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#add-users-and-set-their-identifiers"},"children":["Add Users and Set Their Identifiers"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Get the sign-in endpoint URL from your IdP. Optionally, get the sign-out endpoint URL too."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the signing certificate in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".pem"]}," format, or the metadata XML file if your IdP provides one."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Don't enter the Treasure sign-in URL in the ACS field. The ACS URL is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://sso.treasuredata.com/login/callback"]},". The sign-in URL is the address where users start sign-in."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configure-sign-in-settings-in-treasure-console","__idx":5},"children":["Configure Sign-in Settings in Treasure Console"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your IdP appears in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identity Provider Name"]}," list, configure the sign-in settings in Treasure Console as described in this section. If your IdP doesn't appear in the list, the console doesn't offer it, so configure it with the REST API instead. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#configure-sign-in-settings-with-the-rest-api"},"children":["Configure Sign-in Settings with the REST API"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You might be asked to re-authenticate before you can change sign-in settings."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open Treasure Console and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Control Panel"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-in Settings"]},". The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account Name"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Entity ID"]}," fields are already filled in."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the edit tool."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your IdP in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identity Provider Name"]}," list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-in Endpoint URL"]},", which is the URL your IdP uses for sign-in."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally, enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-out Endpoint URL"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificate File"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".pem"]}," format. If your IdP provides a metadata XML file, you can upload it instead of entering the values in steps 5 through 7."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configure-sign-in-settings-with-the-rest-api","__idx":6},"children":["Configure Sign-in Settings with the REST API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the REST API when your IdP isn't in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identity Provider Name"]}," list. The request creates the SSO setting for your Treasure account. For all request parameters, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/td-api/identity-federation"},"children":["REST API for Identity Federation"]},"."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Collect the sign-in endpoint URL and the X.509 certificate from your IdP. Collect the sign-out endpoint URL too, if your IdP provides one."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Convert the certificate to a single line. Keep the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-----BEGIN CERTIFICATE-----"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-----END CERTIFICATE-----"]}," lines, and separate each base64 line with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\\r\\n"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a file named ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sso_setting.json"]}," with the following content. Replace each placeholder with your values. Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["setting_name"]}," to a unique value without spaces. If your IdP has no sign-out endpoint, set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sign_out_endpoint"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"sso_setting\": {\n    \"strategy\": \"samlp\",\n    \"identity_provider_name\": \"<IDP_DISPLAY_NAME>\",\n    \"setting_name\": \"<UNIQUE_SETTING_NAME>\",\n    \"sign_in_endpoint\": \"<SIGN_IN_ENDPOINT_URL>\",\n    \"sign_out_endpoint\": \"<SIGN_OUT_ENDPOINT_URL>\",\n    \"cert\": \"-----BEGIN CERTIFICATE-----\\r\\n<CERTIFICATE_LINES>\\r\\n-----END CERTIFICATE-----\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<API_BASE_URL>"]}," with the Treasure API base URL for your account's region and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<YOUR_API_KEY>"]}," with the API key from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["My Settings"]}," in Treasure Console. Use the same base URL for both requests. For the full list of regional endpoints, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/endpoints/endpoints#treasure-api-baseurls"},"children":["Treasure API base URLs"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Account Region"},"children":["Account Region"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Treasure API Base URL"},"children":["Treasure API Base URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["US (US01)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.treasuredata.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Japan (AP01)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.treasuredata.co.jp"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Europe (EU01)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.eu01.treasuredata.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Korea (AP02)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.ap02.treasuredata.com"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"API_BASE_URL='<API_BASE_URL>'\ncurl -X POST \"${API_BASE_URL}/v3/account/sso_setting\" \\\n  -H \"Authorization: TD1 <YOUR_API_KEY>\" \\\n  -H \"Content-Type: application/json\" \\\n  -d @sso_setting.json\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful request returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}," with the saved ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sso_setting"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the same shell, confirm the saved setting with a GET request. Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<YOUR_API_KEY>"]}," with the same API key."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request GET \\\n  --url \"${API_BASE_URL}/v3/account/sso_setting\" \\\n  --header 'Authorization: TD1 <YOUR_API_KEY>'\n","lang":"bash"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-users-and-set-their-identifiers","__idx":7},"children":["Add Users and Set Their Identifiers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure AI matches the identifier your IdP sends to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unique Identifier"]}," of each Treasure user. By default, the identifier is the user's email address. You can also use a custom identifier, such as an employee ID, if your IdP sends that value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To add a user, follow these steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Treasure Console, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Control Panel"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add User"]},". Enter the user's email address, select your IdP in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-in Method"]}," list, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Same as email address"]}," as the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unique Identifier"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your IdP, assign the user to the Treasure AI application. Users who aren't assigned can't complete sign-in."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To change an existing user to SSO, select the user, select the edit pencil under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Details"]},", select your IdP in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-in Method"]}," list in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personal Info"]}," dialog, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"test-sign-in","__idx":8},"children":["Test Sign-In"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Test the connection with a user who is assigned in your IdP:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-in Settings"]},", select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Copy Console Sign-in URL"]}," and open the URL in a browser."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your email address or ID as shown on your IdP's sign-in page, and complete authentication."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm that you reach Treasure Console. You can also check your sign-in method in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["My Settings"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For day-to-day sign-in behavior, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/control-panel/security/sign-in-settings/signing-in-as-an-sso-user"},"children":["Signing in as an SSO User"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":9},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sign-in-returns-to-the-default-treasure-console-sign-in-page","__idx":10},"children":["Sign-in returns to the default Treasure Console sign-in page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The IdP's ACS URL is set to something other than ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://sso.treasuredata.com/login/callback"]},", or the Treasure sign-in URL was entered as the ACS URL. Set the ACS URL in your IdP to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://sso.treasuredata.com/login/callback"]},", and confirm that the sign-in endpoint in Treasure Console is your IdP's URL."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To check the SAML response, capture the sign-in traffic with a browser SAML tracing tool. In the response, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Destination"]}," attribute and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SubjectConfirmationData"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Recipient"]}," attribute should both be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://sso.treasuredata.com/login/callback"]},". Treat captures as sensitive, because they contain authentication data."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sign-in-shows-the-error-oops-something-went-wrong","__idx":11},"children":["Sign-in shows the error \"Oops, something went wrong\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One of the following is usually the cause:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign-in started from your IdP's dashboard. Start sign-in from the Treasure sign-in URL instead."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The user's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unique Identifier"]}," doesn't match the identifier your IdP sends. Set the identifier in the user's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Personal Info"]}," dialog to match."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The NameID format isn't recognized. Set the NameID format in your IdP to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unspecified"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["emailAddress"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-idp-authenticates-the-user-but-sign-in-fails","__idx":12},"children":["The IdP authenticates the user, but sign-in fails"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm that the user is assigned to the Treasure AI application in your IdP, and that the user's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sign-in Method"]}," in Treasure Console is set to your IdP."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-rest-api-request-fails","__idx":13},"children":["The REST API request fails"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The certificate has ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\\r\\n"]}," between each line, and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BEGIN"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["END"]}," lines are included."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["setting_name"]}," is unique for each SSO setting in the account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The API key has permission to configure SSO."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":14},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/control-panel/security/sign-in-settings/configuring-sso-in-td-console"},"children":["Configuring SSO in Treasure Console"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/control-panel/security/sign-in-settings/setting-session-timeout-for-sso"},"children":["Setting session timeout for SSO"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/td-api/identity-federation"},"children":["REST API for Identity Federation"]}]}]}]},"headings":[{"value":"Configuring a SAML 2.0 Identity Provider for SSO","id":"configuring-a-saml-20-identity-provider-for-sso","depth":1},{"value":"Before You Begin","id":"before-you-begin","depth":2},{"value":"Know the Limitations","id":"know-the-limitations","depth":2},{"value":"Get the Values from Treasure AI","id":"get-the-values-from-treasure-ai","depth":2},{"value":"Register Treasure AI in Your IdP","id":"register-treasure-ai-in-your-idp","depth":2},{"value":"Configure Sign-in Settings in Treasure Console","id":"configure-sign-in-settings-in-treasure-console","depth":2},{"value":"Configure Sign-in Settings with the REST API","id":"configure-sign-in-settings-with-the-rest-api","depth":2},{"value":"Add Users and Set Their Identifiers","id":"add-users-and-set-their-identifiers","depth":2},{"value":"Test Sign-In","id":"test-sign-in","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"Sign-in returns to the default Treasure Console sign-in page","id":"sign-in-returns-to-the-default-treasure-console-sign-in-page","depth":3},{"value":"Sign-in shows the error \"Oops, something went wrong\"","id":"sign-in-shows-the-error-oops-something-went-wrong","depth":3},{"value":"The IdP authenticates the user, but sign-in fails","id":"the-idp-authenticates-the-user-but-sign-in-fails","depth":3},{"value":"The REST API request fails","id":"the-rest-api-request-fails","depth":3},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Configuring a SAML 2.0 Identity Provider for SSO","description":"Connect a SAML 2.0 identity provider with no dedicated guide to Treasure AI SSO. Register Treasure AI in your IdP, configure Sign-in Settings, and test sign-in."}},"lastModified":"2026-11-18T03:15:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/control-panel/security/sign-in-settings/configuring-a-saml-2-0-identity-provider-for-sso","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}