Connectez votre application aux fournisseurs d’identité SAML

​

Prérequis

• Enregistrez votre application dans Auth0.
  • Sélectionnez un Type d’application approprié.
  • Ajoutez une URL de rappel autorisée de {https://yourApp/callback}.
  • Assurez-vous que les types d’autorisation de votre application incluent les flux appropriés.
• Choisissez le nom de cette connexion d’entreprise
  • L’URL de retour POST (aussi appelée URL du service consommateur d’assertion) devient : https://{yourDomain}/login/callback?connection={yourConnectionName}
  • L’ID d’entité devient : urn:auth0:{yourTenant}:{yourConnectionName}

​

Étapes

1. Saisir l’URL de retour POST et l’ID d’entité dans l’IdP (pour savoir comment faire, consultez les paramètres de configuration du fournisseur d’identité SAML).
2. Obtenir le certificat de signature auprès de l’IdP et le convertir en Base64.
3. Créer une connexion d’entreprise dans Auth0.
4. Activer la connexion d’entreprise pour votre application Auth0.
5. Configurer les mappages (inutile dans la plupart des cas).
6. Tester la connexion.

​

Obtenir le certificat de signature de l’IdP

​

Convertir le certificat de signature en Base64

​

Chiffrement des assertions

​

Créer une connexion d’entreprise dans Auth0

​

Créer une connexion d’entreprise à l’aide du Dashboard

1. Accédez à Auth0 Dashboard > Authentication > Enterprise, repérez SAML, puis sélectionnez son +.
   
2. Entrez les détails de votre connexion, puis sélectionnez Créer :

4. Dans la vue Expérience de connexion, configurez la façon dont les utilisateurs se connectent avec cette connexion.

5. Si vous avez les permissions administratives appropriées pour terminer l’intégration, cliquez sur Continue pour en savoir plus sur les paramètres personnalisés nécessaires pour configurer votre IdP. Sinon, fournissez l’URL indiquée à votre administrateur afin qu’il puisse ajuster les paramètres requis.

​

Créer une connexion d’entreprise à l’aide de la Management API

​

Créer une connexion à l’aide des valeurs indiquées

{
	"strategy": "samlp",
  	"name": "CONNECTION_NAME",
  	"options": {
    	"signInEndpoint": "SIGN_IN_ENDPOINT_URL",
    	"signOutEndpoint": "SIGN_OUT_ENDPOINT_URL",
    	"signatureAlgorithm": "rsa-sha256",
    	"digestAlgorithm": "sha256",
    	"fieldsMap": {
     		...
    	},
    	"signingCert": "BASE64_SIGNING_CERT"
  	}
}

​

Créer une connexion à l’aide d’un document de métadonnées SAML

1. Créez une connexion SAML avec options.metadataUrl. L’objet de connexion sera rempli avec les informations provenant des métadonnées.
2. Mettez à jour le contenu des métadonnées à l’URL.
3. Envoyez une requête PATCH au point de terminaison /api/v2/connections/CONNECTION_ID avec {options: {metadataUrl: '$URL'}}. L’objet de connexion est maintenant mis à jour avec le nouveau contenu des métadonnées.

​

Spécifier un ID d’entité personnalisé

{
  "strategy": "samlp", 
  "name": "{yourConnectionName}", 
  "options": { 
    "metadataUrl": "https://saml-idp/samlp/metadata/uarlU13n63e0feZNJxOCNZ1To3a9H7jX",
    "entityId": "urn:your-custom-sp-name:{yourConnectionName}"
  }
}

​

Activez la connexion d’entreprise pour votre application Auth0

​

Configurer les mappages

{
    "user_id": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier",
    "email": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier"
}

{
  "email": "EmailAddress",
  "given_name": "FirstName",
  "family_name": "LastName"
}

{
  "given_name": [
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname",
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name"
  ]
}

{
  "user_id": [
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier",
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn",
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name"
  ]
}

​

Tester la connexion

​

Configurer la révocation globale des jetons

​

En savoir plus

• Universal Logout