Configuration du SSO de Talend Administration Center avec AD FS 3.0

Vue d'ensemble de AD FS 3.0

Configurez les services Active Directory Federation Services (AD FS) 3.0 sur Windows Server 2012 R2 pour activer la gestion sécurisée d'identités et l'accès via SSO (Single Sign-On) à Talend Administration Center.

AD FS permet un partage d'identité décentralisé entre des partenaires métier, en implémentant le protocole WS-Federation et des standards tels ques WS-Trust et Security Assertion Markup Language (SAML). AD FS est utilisé pour générer des assertions pour les utilisateurs. Ces assertions sont renvoyées dans Talend Administration Center, où les paramètres et les rôles utilisateurs sont assignés en se basant sur la configuration de AD FS.

Pour plus d'informations concernant les besoins système et pour savoir comment prendre en main AD FS, consultez la documentation AD FS (en anglais).

Installer AD FS 3.0

Subscription

es services Active Directory Federation Services (AD FS) 3.0 s'exécutent sous Windows Server 2012 R2.

Avant de commencer

Talend Administration Center doit être configuré avec le protocole HTTPS. Pour plus d'informations, consultez How to configure a bidirectional secure connection between Talend Studio and Talend Administration Center (en anglais).

Procédure

Ouvrez Server Manager.
Cliquez sur Manage > Add Roles and Features.
Dans la fenêtre Add Roles and Feature Wizard, configurez l'installation selon vos besoins.
Installez Active Directory Federation Services.

Configurer AD FS 3.0

Subscription

Procédure

Dans Server Manager, cliquez sur Tools > AD FS Management.
Cliquez-droit sur Trust Relationships > Relying Party Trusts et sélectionnez Add Relying Party Trust....
Cliquez sur Start.
Sélectionnez Enter data about the relying party manually, puis cliquez sur Next.
Saisissez un nom et cliquez sur Next.
Sélectionnez AD FS profile et cliquez sur Next.
Cliquez sur Next.
Dans la page Configure URL, cochez la case Enable support for the SAML 2.0 WebSSO protocol.
Saisissez l'URL du service SSO dans le champ Relying party SAML 2.0 SSO Service URL.
Par exemple, https://localhost:8080/org.talend.administrator/ssologin.
Dans la page Configure Identifiers, saisissez la même URL de service comme dans l'étape 9, puis cliquez sur Add et sur Next.
Choisissez de configurer les paramètres pour l'authentification multifacteur.
Laissez sélectionnée l'option Permit all users to access this relying party et cliquez sur Next.

Vous pourrez changer plus tard les règles d'autorisation.
Cliquez sur Next, puis sur Close.

Laissez cochée la case Open the Edit Claim Rules dialog for this relying party trust when the wizard closes.

Ajouter des règles de revendication

Subscription

Procédure

Dans la fenêtre Edit Claim Rules for..., cliquez sur Add Rule....
Définissez les attributs à envoyer à Talend Administration Center via une réponse SAML.
Cliquez sur OK.

Pour une configuration d'exemple, consultez Configurer la règle de revendication des rôles personnalisés (exemple).

Configurer la règle de revendication des rôles personnalisés (exemple)

Subscription

Procédure

Dans l'assistant Add Transform Claim Rule Wizard, sélectionnez Send Claims Using a Custom Rule dans la liste déroulante, puis cliquez sur Next.
Saisissez un nom pour la règle de revendication, par exemple, EmailAddress.

Saisissez la configuration dans le champ Custom rule.

c:[Type == "http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname", Issuer == "AD AUTHORITY"]
=> add(store = "Active Directory", types = ("http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"), query = ";mail;{0}", param = c.Value);

Cliquez sur Finish.
Dans la fenêtre Edit Claim Rules for..., cliquez sur Add Rule....
Sélectionnez Send Claims Using a Custom Rule dans la liste déroulante, puis cliquez sur Next.
Saisissez un nom pour la règle de revendication, par exemple NameId.

Saisissez la configuration dans le champ Custom rule.

c:[Type == "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"]
=> issue(Type = "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier", Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/format"] = "urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress", Value = c.Value);

Cliquez sur Finish.
Dans la fenêtre Edit Claim Rules for..., cliquez sur Add Rule....
Sélectionnez Send Claims Using a Custom Rule dans la liste déroulante, puis cliquez sur Next.
Saisissez un nom pour la règle de revendication, par exemple, Attributes.

Saisissez la configuration dans le champ Custom rule.

c:[Type == "http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname", Issuer == "AD AUTHORITY"]
=> issue(store = "Active Directory", types = ("firstName", "lastName", "tac.projectType", "tac.role"), query = ";givenName,sn,displayName,department;{0}", param = c.Value);

Cliquez sur Finish.

Exporter des métadonnées

Subscription

Procédure

Ouvrez AD FS Management.
Dans le panneau de gauche, sélectionnez Service > Endpoints faites défiler la vue au centre vers le bas, jusqu'à la zone Metadata.
Notez le chemin d'accès au fichier FederationMetadata.xml.
Téléchargez le ficher de métadonnées depuis votre hôte AD FS, par exemple, https://<ADFShost>/FederationMetadata/2007-06/FederationMetadata.xml.

Lier Talend Administration Center à un fournisseur d'identité

Subscription

Procédure

Connectez-vous à Talend Administration Center.
Depuis la page Configuration, développez le nœud SSO.
Si le SSO n'a pas été précédemment activé, sélectionnez true dans le champ Use SSO Login.
Cliquez sur Launch Upload dans le champ IDP metadata et chargez le fichier de métadonnées de l'IdP (fournisseur d'identité) que vous avez téléchargé précédemment depuis votre Fournisseur d'identité (IdP).
Dans le champ Service Provider Entity ID saisissez l'identifiant de l'Entité de votre Fournisseur de service (disponible dans la configuration du Fournisseur d'identité).
Par exemple, http://<host>:<port>/org.talend.administrator/ssologin pour Okta at ADFS ou <Connection ID> pour PingFederate.
Cliquez sur Launch Upload dans le champ IDP Authentication Plugin et chargez le fichier de métadonnées précédemment téléchargé depuis le système Identity Provider.

Les fichiers Jar fournis par Talend se trouvent dans le répertoire <TomcatPath>/webapps/org.talend.administrator/idp/plugins.

Il est possible de réécrire le code d'authentification, si nécessaire.

Le champ Identity Provider System change automatiquement selon votre système fournisseur d'identité.
Cliquez sur Identity Provider Configuration et renseignez les informations requises.
PingFederate
- PingFederate SSO URL : https://win-350n8gtg2af:9031/idp/startSSO.ping?PartnerSpld=TAC701
- Basic Adapter Instance ID : BasicAdapter
Okta
- Okta Organization URL : https://dev-515956.oktapreview.com
- Okta Embedded URL : https://dev-515956.oktapreview.com/home/talenddev515956_talendadministrationcenter_1/0oacvlcac5j52hFhP0h7/alncvlmpk1VXbYAGu0h7
AD FS 2
- Adfs SSO Url : https://<host>/adfs/ls
- Adfs Basic Auth Path : auth/basic
- Adfs SP Entity Id : https://<host>:<port>/org.talend.administrator/ssologin
AD FS 3
- Adfs 3 SP Entity Id : https://<host>:<port>/org.talend.administrator/ssologin
- Adfs 2 SSO Url : https://<host>/adfs/ls
Définissez le champ Use Role Mapping à true pour faire correspondre les types de projet et rôles utilisateur des applications avec ceux définis dans le fournisseur d'identité.
Une fois les rôles et types de projet définis côté fournisseur d'identité, vous ne pourrez pas les modifier depuis Talend Administration Center.
Cliquez sur Mapping Configuration et renseignez les champs des types de rôles/projets avec les attributs SAML correspondants précédemment configurés dans le système fournisseur d'identité.
Exemples de types de projets :
- MDM = MDM
- DI = DI
- DM = DM
- NPA = NPA
Exemples de rôles :
- Rôles de Talend Administration Center
  - Administrator = tac_admin
  - Operation Manager = tac_om
  Configurer les rôles dans Talend Administration Center est obligatoire.
- Rôles de Talend Data Preparation
  - Administrator = dp_admin
  - Data Preparator = dp_dp
- Rôles de Talend Data Stewardship
  - Data Steward = tds_ds
Les types de rôles et projets configurés dans le fournisseur d'identité écrasent les rôles configurés dans Talend Administration Center.
Les types de rôles et projets configurés dans le fournisseur d'identité écrasent les rôles configurés dans Talend Administration Center lors de la connexion de l'utilisateur.

Si votre entreprise n'accepte pas les attributs personnalisés dans le jeton SAML :
1. Sélectionnez Show Advanced Configuration dans l'assistant et, dans le champ Path to Value, saisir l'expression XPath pour cibler la valeur SAML et mapper l'objet Talend Administration Center correspondant (Project Types, Roles, Email, First Name, Last Name).
  
  Par exemple, l'expression XPath pour le type de projet DI : /saml2p:Response/saml2:Assertion/saml2:AttributeStatement/saml2:Attribute[@Name='tac.projectType']/saml2:AttributeValue/text()
2. Définissez le champ Use Role Mapping à false.
  
  Dans ce cas, vous ne pouvez créer manuellement les utilisateurs, mais le type d'utilisateur et ses rôles peuvent être modifiés plus tard dans Talend Administration Center.
  
  Lorsqu'un utilisateur se connecte pour la première fois, son type est No Project access.
Le délai avant suspension de la connexion est configuré à 120 secondes par défaut. Vous pouvez modifier cette valeur en ajoutant le paramètre sso.config.clientLoginTimeout avec la durée voulue dans le fichier <ApplicationPath>/WEB-INF/classes/configuration.properties.

Résultats

Vous pouvez vous connecter à Talend Administration Center via votre fournisseur d'identité.

Se connecter à Talend Administration Center via AD FS

Procédure

Une fois la configuration terminée, connectez-vous à Talend Administration Center via l'URL du SSO de AD FS.

https://<host>/adfs/ls/idpinitiatedsignon