Configuring the SAML server - 7.3

Talend Data Catalog Administration Guide

Version
7.3
Language
English
Product
Talend Big Data Platform
Talend Data Fabric
Talend Data Management Platform
Talend Data Services Platform
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Talend Data Catalog
Content
Administration and Monitoring
Data Governance
Last publication date
2022-06-13

Configure the SAML server to enable the external authentication server using the SAML 2.0 protocol.

Before you begin

  • As an administrator, you have configured the Talend Data Catalog application in your identity provider system.
  • As an administrator, you have set up the users and the user attributes of your application in your identity provider system.
  • You have signed in as a user assigned to the Administrators or Security Administrators group.

Procedure

  1. Go to MANAGE > Users.
  2. In the Authentication field of the toolbar, select SAML from the drop-down list.
  3. Click the Configure authentication icon next to the drop-down list.
  4. In the Connection tab, fill in the required information to link Talend Data Catalog to your identity provider.
    Field Action
    Identity Provider Enter the URL for your identity provider.
    X509 Certificate Enter the public X509 certificate of your identity provider which allows Talend Data Catalog to verify the signatures and establish trust in the exchanged messages.
    Binding Type
    Select the manner in which binding is accomplished:
    • HTTP-Redirect: Talend Data Catalog sends a SAML authentication request to the identity provider SSO service using the HTTP-Redirect Binding.
      Note: As Talend Data Catalog does not have the private key of the identity provider, the SAML authentication request sent by Talend Data Catalog is neither signed nor encrypted. Since the request usually does not contain much private data, there is little need to encrypt the SAML request.
    • HTTP-POST: The identity provider returns the SAML response to a Talend Data Catalog assertion consumer service using the HTTP-POST Binding.
      Note: As Talend Data Catalog does not have the private key of the identity provider, the SAML assertion received by Talend Data Catalog can be signed but not encrypted.

      To validate the signature, Talend Data Catalog only needs the identity provider’s public key. The assertion requires to be signed, so that Talend Data Catalog can verify that the assertion contents have not been altered in transit.

    Single Sign On URL

    Enter the Single-Sign On URL.

    Signature Element

    Select one of the values from the drop-down list to specify if the SAML authentication response message and SAML assertion are digitally signed by the identity provider or not.

    Talend Data Catalog will return an error message at the login time if an element is configured as signed but the element in the SAML response was not signed by the identity provider.

    If an element is configured as not signed, Talend Data Catalog will not validate the signature in that element even if it may have been signed by the identity provider.

  5. In the Attribute Mappings tab, map the attributes from the external user account to the Talend Data Catalog user attributes, such as Login, Full Name, Email or Groups.
  6. In the Group Mappings tab, map the group attribute from the external user account to the Talend Data Catalog group name.
    To enable the automatic group assignment, you can fill in the Groups attribute in the Attribute Mapping tab with the corresponding field name in the user account information. Talend Data Catalog uses the value of this field as the security group assignment.

    The user account information is returned from the SAML server to Talend Data Catalog after the SAML server validates an access token upon a login request.

    You can use the wildcard ("%") when configuring the group mappings. The % matches zero or more characters.
    When populating a SAML attribute for group assignment, you switch from native and manually managed group assignment to SAML driven and automatic group assignment for all SAML users. As a SAML user, you lose the previous native group assignment the next time you log in.

    When deleting the last SAML attribute for group assignment, you switch from SAML driven group assignment to native group assignment. Any SAML user will be associated with the Guest group, until the users are manually assigned to other groups.

  7. Save your changes.

Results

You can log in to Talend Data Catalog through your identity provider.