Configure SSO on your Talend Cloud platform after setting up an application on your SSO provider side.
Before you begin
- You must have the Security Administrator role in Talend Cloud Management Console.
- You must have the metadata file obtained from the SSO provider.
- Log in to Talend Cloud Management Console.
- On the top of the Users page, click Authentication.
- Click Configuration.
Enter the SSO provider domain name in the Organization URL
Find this URL in the Identity Provider Single Sign-On URL field of the Applications tab in Okta.
- Upload the metadata file you downloaded from the SSO application configuration by clicking the icon.
Check the default User attributes. If needed, edit them to match the application configuration specified on the SSO provider side.
These attributes are propagated to the SAML token used to authenticate users. The application configuration on the SSO provider side must specify these attributes as well as two other attributes:
TalendCloudDomainNameattribute that indicates your Talend Cloud account name. You can find the account name in the Domain field of the Subscription page of your Talend Management Console.
NameId Formatattribute that indicates the email address format.
Click Test to check your configuration.
Note: The test checks that the provided URL and metadata file are valid. It does not guarantee that logging in through this SSO configuration will work.
Set up user provisioning to automatically create users in Talend Cloud Management Console
when logging in to a Talend Cloud
application via the identity provider.
- It is recommended to set up SCIM provisioning in your identity provider and
map roles between this provider and Talend Cloud.
This is the most robust mechanism. For further information, see this example. For demonstration purposes,
Azure AD is used as identity provider in the linked example.
If the Just-in-time user provisioning option is already used when you set up the role mapping, for any given user, the roles assigned by this role mapping override those provided by the just-in-time option.
- Alternatively, you can toggle the Just-in-time user
provisioning option ON in Talend Cloud Management Console. This is the classic option provided by Talend Cloud.With the Just-in-time user provisioning option, select the default roles to be assigned to every automatically created user. These users use the following format for their names in the Login name field:
username.DomainName@TalendCloudDomainName, for example,
firstname.lastname@example.org.Note: Make sure that the selected set of default roles poses no security risk for your platform.
- It is recommended to set up SCIM provisioning in your identity provider and map roles between this provider and Talend Cloud. This is the most robust mechanism. For further information, see this example. For demonstration purposes, Azure AD is used as identity provider in the linked example.
Customize the logout URL. For example, redirect users to a specific page. By default, users are redirected to the Talend Cloud login page when they log out.
For more information on the format to use for this URL, see the documentation of your SSO provider.
- Click Save and Activate.
You can now assign users to this application. They are then able to log in to Talend Cloud through SSO.
After single sign-on is enabled, you must generate an Access Token in Talend Cloud and use this token inside Studio. For further information about how to generate a token in Talend Cloud, see Generating a Personal Access Token.
Only users with the Security Administrator role can log in to Talend Cloud without using the identity provider.
As a Security Administrator, you can disable the active SSO configuration at any time from this Authentication page by toggling the External single sign-on provider option off. As a consequence, users can only login using their Talend Cloud username and password. The previous configuration is still saved if you want to enable it again.
What to do next
When the SSO certificate is renewed on your SSO provider side, you must update this certificate on your Talend Cloud platform.
To do this, download the metadata file from your SSO provider again and upload it to Talend Cloud Management Console by following the same procedure described above.