Configure Okta for SSO SAML
This article describes how to integrate the Okta identity provider with Zuora for single sign-on (SSO). Before you start configuring Okta, see Configure Single Sign-On for Zuora for the general requirements and the provisioning process for enabling Zuora single sign-on.
The following procedure might not apply to the version of Okta that you are working with. For more information about the Okta UI, always refer to the Okta documentation.
Add Zuora application to Okta
First, configure Okta to provide the sign-on information for the Zuora environment. To add the Zuora application to Okta, complete the following steps:
- Log in to Okta as the user who has the application administration permission.
- Go to the Applications tab and click Add application > Create new app.
- In the dialog, select SAML 2.0 as the sign-on method and click Create.
- In the General Settings step, enter the application name and an optional application. Click Next.
- Enter the SAML settings.
- Single sign-on URL : The Assertion Consumer Service (ACS) endpoints where the Zuora application receives the SAML assertion. The value to enter depends on the Zuora environment that you are enabling SSO in.
- US Cloud 1 Production -
https://na.zuora.com/apps/saml/SSO/alias/defaultAlias
- US Cloud 1 API Sandbox -
https://sandbox.na.zuora.com/apps/saml/SSO/alias/defaultAlias
- US Cloud 2 Production -
https://www.zuora.com/apps/saml/SSO/alias/defaultAlias
- US Cloud 2 API Sandbox -
https://apisandbox.zuora.com/apps/saml/SSO/alias/defaultAlias
- US Central Sandbox -
https://test.zuora.com/apps/saml/SSO/alias/defaultAlias
- US Performance Test -
https://pt1.zuora.com/apps/saml/SSO/alias/defaultAlias
- EU Cloud Production -
https://eu.zuora.com/apps/saml/SSO/alias/defaultAlias
- EU Cloud API Sandbox -
https://sandbox.eu.zuora.com/apps/saml/SSO/alias/defaultAlias
- EU Central Sandbox -
https://test.eu.zuora.com/apps/saml/SSO/alias/defaultAlias
- US Cloud 1 Production -
- Audience URI: Enter the Entity ID of this Zuora application. The value to enter depends on the Zuora environment that you are enabling SSO in.
- US Cloud 1 Production -
na.zuora.com
- US Cloud 1 API Sandbox -
sandbox.na.zuora.com
- US Cloud 2 Production -
www.zuora.com
- US Cloud 2 API Sandbox -
apisandbox.zuora.com
- US Performance Test -
pt1.zuora.com
- US Central Sandbox -
test.zuora.com
- EU Cloud Production -
eu.zuora.com
- EU Cloud API Sandbox -
sandbox.eu.zuora.com
- EU Central Sandbox -
test.eu.zuora.com
- US Cloud 1 Production -
- Default RelayState: Leave this field blank.
- Name ID format: Set to EmailAddress.
- Default username: Set to Email.
- Leave all other fields at their default values.
- Single sign-on URL : The Assertion Consumer Service (ACS) endpoints where the Zuora application receives the SAML assertion. The value to enter depends on the Zuora environment that you are enabling SSO in.
- Click Next.
- Click Finish.
Obtain Okta IDP metadata
As an SSO provisioning step, you need to provide the Okta identity provider metadata to Zuora. This metadata is specific to your Okta account. Complete the following steps to retrieve the identity provider metadata from Okta:
- Log in to Okta and go to the Applications tab.
- Click the application that you added for Zuora SSO.
- Click the Sign On tab.
- Click Identity Provider metadata to download the Okta metadata file.
- Provide the downloaded IDP metadata to Zuora.
If there is any change in your Okta settings that results in your metadata updates, you must re-submit the new metadata file to Zuora. Wait for a notification from Zuora before allowing your users to log in to Zuora via SSO.
Add a Zuora SSO test user to Okta
Add a test user to your company's Okta account to test SSO authentication against Zuora. You need to provide this test user's log-in information to Zuora for the Zuora SSO provisioning process. Complete the following steps to add a test user in Okta:
- From your Okta dashboard, click the People tab.
- Click Add Person.
Assign Zuora application to users
Okta requires each SSO user to be assigned to the Zuora application you created in Add Zuora Application to Okta. Complete the following steps to assign the Zuora application to the test user:
- In Okta, on the People tab, click the user's full name.
- Click Assign Applications.
- Click the Zuora application to be assigned to this user.
- Verify the user name in the Username field. This username will be used as the federated ID of the test user.
- Click Save.