Configurer OneLogin en tant que fournisseur d’identité SAML

Découvrez comment configurer OneLogin en tant que fournisseur d’identité SAML à utiliser avec Auth0.

Configurez OneLogin en tant que fournisseur d’identité SAML en effectuant les étapes suivantes :

1. Configurer l’intégration SAML de OneLogin
2. Configurer la connexion SAML dans Auth0.
3. Tester la connexion.

​

Conditions préalables

Vous devez avoir un compte développeur OneLogin.

​

Configurer OneLogin

1. Connectez-vous au tableau de bord OneLogin et cliquez sur Applications > Ajouter des applications.
2. Recherchez SAML, et sélectionnez Connecteur d’essai SAML (IdP w/attr).
3. Lorsque vous y êtes invité, modifiez le Nom d’affichage de votre application.
4. Cliquez sur Enregistrer.
5. Allez dans l’onglet SSO et copiez les valeurs de Point de terminaison SAML 2.0 (HTTP) et Point de terminaison SLO (HTTP).
6. Cliquez sur le lien Afficher les détails dans le champ Certificat X.509.
7. Téléchargez le certificat X.509 onelogin.pem.

​

Configurer la connexion Auth0

1. Allez sur Dashboard > Authentification > Entreprise > SAMLP et cliquez sur l’icône plus pour être redirigé vers la page qui vous permet de créer une nouvelle connexion.
2. Vous serez invité à fournir les réglages de configuration appropriés pour cette connexion. Les seuls champs obligatoires sont :

Paramètre	Description
URL de connexion	La valeur du point de terminaison SAML 2.0 (HTTP) que vous avez notée lors de la configuration de votre application OneLogin.
URL de déconnexion	La valeur du point de terminaison SLO (HTTP) que vous avez notée lors de la configuration de votre application OneLogin.
Certificats de signature X509	Le certificat que vous avez téléchargé de Onelogin. Vous devrez télécharger le certificat directement sur Auth0.

3. Cliquez sur Enregistrer pour continuer.

4. Dans la fenêtre suivante, deux options s’offrent à vous.

   1. Si vous êtes un administrateur de domaine, vous pouvez cliquer sur Continuer pour obtenir des instructions supplémentaires sur la configuration du fournisseur d’identité SAML.
   2. Si ce n’est pas le cas, vous pouvez donner à votre administrateur de domaine l’URL fournie afin qu’il puisse terminer la configuration.

​

Valeurs de configuration d’Auth0

Pour terminer la configuration de l’application SAML, l’administrateur aura besoin des informations suivantes concernant Auth0 :

• URL Consommateur SAML: https://{yourDomain}/login/callback
• Audience SAML : urn:auth0:{yourTenant}:yourConnectionName

Copiez également les valeurs de l’URL de renvoi et d’identifiant de l’entité avant de retourner à l’onglet Configuration de votre application OneLogin :

Auth0 value	Champ de configuration OneLogin
URL de renvoi	URL ACS (Consommateur) et Destinataire
Entité ID	Audience

Fournissez également une expression régulière valide pour le Validateur d’URL de l’ACS (Consommateur). Par exemple :

[-a-zA-Z0-9@:%._\+~#=]{2,256}\.[a-z]{2,6}\b([-a-zA-Z0-9@:%_\+.~#?&//=]*)

​

Tester la connexion

Avant de tester votre connexion :

• Assurez-vous que vous disposez d’un utilisateur OneLogin que vous pouvez utiliser pour les essais. Si ce n’est pas le cas, allez dans l’onglet Utilisateurs du tableau de bord OneLogin et ajoutez-en un.
• Assurez-vous que votre nouvelle connexion Auth0 SAMLP a été associée à une application (sinon vous obtiendrez une erreur invalid_request: the connection was disabled).

A côté de votre connexion SAML, cliquez sur le bouton Essayer. Si tout se passe bien, vous serez redirigé vers une page vous informant que la connexion fonctionne.

​

Authentification unique initiée par IdP

OneLogin offre à ses utilisateurs un portail/lanceur d’applications. Si vous souhaitez bénéficier de cette fonctionnalité, vous devrez modifier l’URL Consommateur SAML dans le tableau de bord OneLogin pour inclure le paramètre connection (par exemple, https://{yourDomain}/login/callback?connection=onelogin-customer). Veillez à remplacer onelogin-customer par le nom de votre connexion Auth0.

Enfin, veillez à activer la connexion initiée par l’IdP pour la connexion et à choisir l’application vers laquelle l’utilisateur est redirigé une fois l’assertion SAML consommée. Pour en savoir plus, lisez Configurer l’authentification unique initiée par le fournisseur d’identité.

​

Modifier les mappages de connexion

Si vous utilisez OneLogin et Auth0, les utilisateurs qui se connectent à l’aide de OneLogin et qui sont créés dans Auth0 Dashboard ne disposeront pas de certaines informations de profil que vous souhaiteriez avoir.

Pour collecter des informations supplémentaires sur l’utilisateur, modifiez les paramètres appropriés dans le tableau de bord OneLogin, incluez les paramètres dans l’assertion SAML et créez les mappages dans la connexion Auth0.

​

Attributs du profil utilisateur

Parfois, les attributs du profil utilisateur standard ne suffisent pas pour la fonctionnalité que vous souhaitez créer. Dans ce cas, vous pouvez utiliser des attributs personnalisés afin d’améliorer le jeton SAML. Prenons un exemple de base.

Le jeton SAML contient, entre autres, deux attributs : FirstName et LastName. Ajoutons un nouvel attribut personnalisé, nommé FullName, qui contiendra la concaténation du prénom et du nom.

1. Naviguez vers le tableau de bord OneLogin et modifiez votre application.
2. Sur l’onglet Réglages, cliquez sur Ajouter un paramètre.
3. Dans la fenêtre contextuelle, attribuez un nom à votre nouvel attribut personnalisé en utilisant la zone de texte Nom du champ. Veillez à cocher l’option Inclure dans l’assertion SAML. Cliquez sur Enregistrer.
4. Le nouvel attribut que vous avez créé s’affiche. Cliquez sur le champ Valeur, qui affiche actuellement - No default - .
5. Cliquez sur le menu déroulant Valeur et sélectionnez - Macro -.
6. Dans la zone de texte, définissez la valeur sur {firstname} {lastname}. Cliquez sur Enregistrer.
7. Testez nos changements. Retournez à Auth0 Dashboard > Authentification > Entreprise > SAML. Sur votre connexion SAML, cliquez sur le bouton Essayer. Le résultat devrait inclure le nouvel attribut FullName.

Vous pouvez trouver plus d’informations sur les macros d’attributs dans le Centre d’aide OneLogin.

​

Ajouter un nouveau paramètre à l’assertion SAML

Pour les besoins de la démonstration, voyons comment nous pouvons ajouter l’information EmailAddress à notre connexion, laquelle est plus que la concaténation de deux champs que nous envoyons déjà.

1. Avant de pouvoir mapper l’adresse EmailAddress des utilisateurs, vous devez ajouter ce champ en tant que paramètre personnalisé au tableau de bord OneLogin. Définissez Nom du champ sur EmailAddress et Valeur sur Email.
2. Vous trouverez des détails sur les étapes nécessaires à la personnalisation du profil utilisateur dans la section ci-dessus.
3. Une fois les modifications effectuées, enregistrez-les et testez à nouveau votre connexion.
4. Vérifiez votre utilisateur Auth0, en vous assurant que l’information EmailAddress est maintenant incluse et que la valeur est correcte.

Vous êtes maintenant prêt à procéder au mappage des champs d’information de l’utilisateur dans Auth0.

1. Allez dans les Réglages de votre SAML et naviguez jusqu’à l’onglet Mappages. Pour les adresses courriel, copiez la correspondance ci-dessous et collez-la dans la zone de texte.
2. Enregistrez vos modifications et essayez à nouveau de vous connecter. Une fois que vous avez réussi à vous connecter, allez sur Dashboard > Gestion des utilisateurs > Utilisateurs, et vérifiez votre connexion. Vous verrez des informations supplémentaires pour l’utilisateur approprié.