Authentification
Gérer les utilisateurs
Personnaliser
Auth0 AI
Plateformecontext stocke des renseignements contextuels sur la transaction d’authentification en cours, comme l’adresse IP de l’utilisateur, l’application ou l’emplacement.
Si vous modifiez le contenu du jeton à l’aide de l’objet context dans une Rule, vos modifications seront reflétées dans les jetons une fois que toutes les Rules auront fini de s’exécuter. Si votre application exige aussi ou le consentement de l’utilisateur, l’utilisateur sera invité avant que les modifications apportées au jeton soient disponibles.
Propriétés
context.
| Propriété | Description |
|---|---|
context.tenant | Une chaîne contenant le nom du locataire. |
context.clientID | L’ID client de l’application à laquelle l’utilisateur se connecte. |
context.clientName | Le nom de l’application (tel que défini dans l’Auth0 Dashboard). |
context.clientMetadata | Un objet contenant d’autres propriétés de l’application. Ses clés et ses valeurs sont des chaînes. |
context.connectionID | Une chaîne contenant l’identifiant unique de la connexion. |
context.connection | Le nom de la connexion utilisée pour authentifier l’utilisateur (par exemple : twitter ou some-g-suite-domain) |
context.connectionStrategy | Le type de connexion. Pour une connexion sociale, connectionStrategy === connection. Pour les connexions d’entreprise, la stratégie est waad (Windows Azure AD), ad (Active Directory/LDAP), auth0 (connexions de base de données), et ainsi de suite. |
context.connectionOptions | Un objet représentant les options définies pour la connexion. connectionOptions.tenant_domain est une chaîne contenant le domaine utilisé pour l’authentification dans le cas d’une connexion d’entreprise.connectionOptions.domain_aliases est un tableau contenant les domaines facultatifs enregistrés comme alias, en plus du domaine principal (spécifié dans la propriété connectionOptions.tenant_domain). |
context.connectionMetadata | Objet représentant les métadonnées définies pour la connexion. Ses clés et ses valeurs sont des chaînes de caractères. |
context.samlConfiguration | Un objet qui contrôle le comportement des points de terminaison SAML et WS-Fed. Utile pour le mappage avancé des claims et l’enrichissement des jetons (disponible uniquement pour le protocole samlp et wsfed). |
context.protocol | Le protocole d’authentification. Valeurs possibles :
|
context.riskAssessment | Un objet contenant des scores spécifiques (faible, moyen, élevé, neutre) attribués aux évaluateurs de tentatives de connexion à haut risque. Consultez Personnaliser la MFA adaptative avec des Rules. |
context.stats | Un objet contenant certaines statistiques propres à l’utilisateur, comme stats.loginsCount. Notez qu’aucune des variables de compteur renvoyées dans l’objet stats n’augmente pendant l’authentification silencieuse (par exemple lorsque prompt=none). Il existe aussi des scénarios où les variables de compteur peuvent augmenter sans qu’une Rule ou qu’un ensemble de Rules ne s’exécute, comme dans le cas d’une authentification inter-origine réussie suivie d’une demande de jeton échouée. |
context.sso | Cet objet contiendra des renseignements sur la transaction d’authentification unique (SSO) (s’il y a lieu)
|
context.accessToken | Un objet représentant les options définies pour le Jeton d’accès. Vous pouvez utiliser cet objet pour ajouter des claims personnalisées dans un espace de noms au Jeton d’accès. context.accessToken.scope peut être utilisé pour modifier les scopes renvoyés dans le Jeton d’accès. Lorsqu’il est fourni, il s’agit d’un tableau contenant des permissions sous forme de chaînes de caractères. Les claims personnalisées seront incluses dans le Jeton d’accès après l’exécution de toutes les Rules. |
context.idToken | Objet représentant les options définies pour le ID Token. Sert à ajouter des claims personnalisées avec espace de noms à l’ID Token. Les claims personnalisées seront incluses dans l’ID Token après l’exécution de toutes les Rules. |
context.multifactor | Un objet représentant les paramètres MFA utilisés dans la mise en place de la MFA contextuelle. |
context.redirect | L’objet utilisé pour mettre en place la redirection d’un utilisateur depuis une Rule. |
context.sessionID | Un identifiant interne de la session d’authentification. La valeur n’est conservée que si prompt=none est utilisé dans la requête d’autorisation. Notez que l’identifiant de session peut changer après l’exécution de la Rule dans d’autres flux; la valeur disponible dans context.sessionID pourrait donc ne pas correspondre au nouvel identifiant de session que l’utilisateur recevra. Cette valeur n’a donc de sens que lorsque prompt=none est utilisé. |
context.request | Un objet contenant des renseignements utiles sur la requête. Il peut aussi être défini à undefined. Il possède les propriétés suivantes :
|
context.primaryUser | L’id unique du compte principal de l’utilisateur. Utilisé pour lier des comptes d’utilisateur issus de divers fournisseurs d’identité. |
context.authentication | Un objet contenant des informations liées à la transaction d’authentification avec les propriétés suivantes :methods : un tableau d’objets contenant les méthodes d’authentification qu’un utilisateur a effectuées pendant sa session. Par exemple, un utilisateur qui a effectué une authentification par mot de passe suivie d’une MFA peut avoir les méthodes suivantes :json lines [ { "name": "pwd", "timestamp": 1434454643024 }, { "name": "mfa", "timestamp": 1534454643881 } ] Les objets de méthode contiennent les propriétés suivantes :
context.authentication.methods dans la Rule Require MFA once per session. |
context.authorization | Un objet contenant des informations relatives à la transaction d’autorisation avec les propriétés suivantes :
|
context.organization | Objet contenant des informations sur l’organisation. Comprend les propriétés suivantes :
|