> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Découvrez les propriétés de l’objet context de Rules, qui stocke des renseignements sur les adresses IP, les applications et l’emplacement des utilisateurs.

# Propriétés de l’objet Context dans Rules

<Warning>
  La date de fin de vie (EOL) de Rules et Hooks est fixée au **18 novembre 2026**, et ils ne sont plus offerts aux nouveaux locataires créés à compter du **16 octobre 2023**. Les locataires existants avec des Hooks actifs conserveront l’accès au produit Hooks jusqu’à la fin de vie.

  Nous vous recommandons fortement d’utiliser Actions pour étendre les fonctionnalités d’Auth0. Avec Actions, vous avez accès à des informations de type détaillées, à de la documentation intégrée et à des packages `npm` publics, et vous pouvez connecter des intégrations externes qui améliorent votre expérience globale en matière d’extensibilité. Pour en savoir plus sur ce qu’offre Actions, consultez [Comprendre le fonctionnement d’Auth0 Actions](/fr-CA/docs/customize/actions/actions-overview).

  Pour vous aider dans votre migration, nous offrons des guides pour [migrer de Rules vers Actions](/fr-CA/docs/customize/actions/migrate/migrate-from-rules-to-actions) et [migrer de Hooks vers Actions](/fr-CA/docs/customize/actions/migrate/migrate-from-hooks-to-actions). Nous avons également une page dédiée, [Passer à Actions](https://auth0.com/extensibility/movetoactions), qui présente des comparaisons de fonctionnalités, [une démonstration d’Actions](https://www.youtube.com/watch?v=UesFSY1klrI) et d’autres ressources pour vous accompagner tout au long de votre migration.

  Pour en savoir plus sur la dépréciation de Rules et Hooks, consultez notre billet de blogue : [Préparer la fin de vie de Rules et Hooks](https://auth0.com/blog/preparing-for-rules-and-hooks-end-of-life/).
</Warning>

L’objet `context` 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 <Tooltip tip="Authentification multifacteur (MFA) : processus d’authentification de l’utilisateur qui utilise un facteur en plus du nom d’utilisateur et du mot de passe, comme un code envoyé par SMS." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=multifactor+authentication">l’authentification multifacteur</Tooltip> ou le consentement de l’utilisateur, l’utilisateur sera invité avant que les modifications apportées au jeton soient disponibles.

<div id="properties">
  ## Propriétés
</div>

Les propriétés suivantes sont disponibles pour l’objet `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.<br />`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](/fr-CA/docs/glossary?term=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 :<ul> <li>`oidc-basic-profile` : le plus utilisé, connexion sur le Web</li> <li>`oidc-implicit-profile` : utilisé sur les appareils mobiles et les applications monopage</li> <li>`oauth2-device-code` : transaction utilisant le [flux d’autorisation d’appareil](/fr-CA/docs/get-started/authentication-and-authorization-flow/device-authorization-flow)</li> <li> `oauth2-resource-owner` : connexion par nom d’utilisateur et mot de passe, généralement utilisée avec les connexions de base de données</li> <li>`oauth2-resource-owner-jwt-bearer` : connexion à l’aide d’un JWT de type bearer signé avec la clé privée de l’utilisateur</li> <li>`oauth2-password` : connexion utilisant l’échange de mot de passe</li> <li>`oauth2-refresh-token` : actualisation d’un jeton à l’aide de l’échange de jeton d’actualisation</li> <li>`samlp` : protocole SAML utilisé avec les applications SaaS</li> <li>`wsfed` : WS-Federation utilisé avec les produits Microsoft comme Office365</li> <li>`wstrust-usernamemixed` : connexion par nom d’utilisateur et mot de passe WS-trust utilisée avec CRM et Office365</li> <li>`delegation` : lors de l’appel du [point de terminaison Delegation](https://auth0.com/docs/api/authentication#delegation)</li> <li>`redirect-callback` : lors de la reprise d’une Rule de redirection</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `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](/fr-CA/docs/secure/multi-factor-authentication/adaptive-mfa/customize-adaptive-mfa).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `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](/fr-CA/docs/authenticate/login/configure-silent-authentication) (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)](/fr-CA/docs/glossary?term=Single+Sign-on+%28SSO%29) (s’il y a lieu)<ul> <li>`with_auth0` : lorsqu’un utilisateur ouvre une session avec le SSO dans une application où le paramètre `Use Auth0 instead of the IdP to do Single Sign-On` est activé (uniquement pour les locataires Legacy).</li> <li>`with_dbconn` : une connexion SSO pour un utilisateur qui s’est connecté au moyen d’une connexion de base de données.</li> <li>`current_clients` : les ID client qui utilisent le SSO.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `context.accessToken`        | Un objet représentant les options définies pour le [Jeton d’accès](/fr-CA/docs/glossary?term=Access+Toke). Vous pouvez utiliser cet objet pour [ajouter des claims personnalisées dans un espace de noms](/fr-CA/docs/get-started/apis/scopes/sample-use-cases-scopes-and-claims#add-custom-claims-to-a-token) au [Jeton d’accès](/fr-CA/docs/glossary?term=Access+Toke). `context.accessToken.scope` peut être utilisé pour [modifier les scopes renvoyés dans le Jeton d’accès](/fr-CA/docs/customize/actions/actions-overview#modify-scope-of-access-token). 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](/fr-CA/docs/secure/tokens/id-tokens). Sert à ajouter des claims personnalisées [avec espace de noms](/fr-CA/docs/secure/tokens/json-web-tokens/create-custom-claims) à 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](/fr-CA/docs/secure/multi-factor-authentication).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `context.redirect`           | L’objet utilisé pour [mettre en place la redirection d’un utilisateur depuis une Rule](/fr-CA/docs/customize/rules/redirect-users#how-to-implement-a-redirect).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `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 :<ul> <li>`userAgent` : l’agent utilisateur de l’application qui tente de se connecter.</li> <li>`ip` : l’adresse IP d’origine de l’utilisateur qui tente de se connecter. Nous exposons des adresses IPv6 dans nos points de terminaison publics (par exemple, travel0.us.auth0.com). Si une requête provient d’une machine compatible avec IPv6, cette propriété contiendra une adresse IPv6. Si vous manipulez manuellement des adresses IP, nous vous suggérons d’utiliser la [bibliothèque ipaddr.js@1.9.0](https://www.npmjs.com/package/ipaddr.js/v/1.9.0).</li> <li>`hostname` : le nom d’hôte utilisé pour le flux d’authentification.</li> <li>`query` : un objet contenant les propriétés de la chaîne de requête de la transaction de connexion envoyée par l’application.</li> <li>`body` : le corps de la requête POST dans les transactions de connexion utilisées avec les protocoles `oauth2-resource-owner`, `oauth2-resource-owner-jwt-bearer` ou `wstrust-usernamemixed`.</li> <li>`geoip` : un objet contenant des renseignements géographiques liés à l’adresse IP. Il possède les propriétés suivantes :<ul> <li>`country_code` : un code à deux caractères du pays associé à l’adresse IP.</li> <li>`country_code3` : un code à trois caractères du pays associé à l’adresse IP.</li> <li>`country_name` : le nom du pays associé à l’adresse IP.</li> <li>`city_name` : le nom de la ville ou de la localité associée à l’adresse IP.</li> <li>`latitude` : la latitude associée à l’adresse IP.</li> <li>`longitude` : la longitude associée à l’adresse IP.</li> <li>`time_zone` : le fuseau horaire associé à l’adresse IP.</li> <li>`continent_code` : un code à deux caractères du continent associé à l’adresse IP.</li> <li>`subdivision_code` : le code ISO 3166-2 de la subdivision ou région de premier niveau.</li> <li>`subdivision_name` : le nom anglais de cette subdivision ou région.</li></ul></li></ul> |
| `context.primaryUser`        | L’id unique du compte principal de l’utilisateur. Utilisé pour [lier des comptes d’utilisateur](/fr-CA/docs/manage-users/user-accounts/user-account-linking#automatic-account-linking) 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 :<br /><br />`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 :<br />`json lines [ { "name": "pwd", "timestamp": 1434454643024 }, { "name": "mfa", "timestamp": 1534454643881 } ] `<br />Les objets de méthode contiennent les propriétés suivantes : <ul> <li> `name` : une chaîne qui représente le nom de la méthode d’authentification effectuée. Elle peut prendre l’une des valeurs suivantes (d’autres valeurs pourraient être prises en charge à l’avenir) :<br /><ul> <li>`federated` : une connexion sociale ou d’entreprise a été utilisée pour authentifier l’utilisateur</li> <li>`pwd` : une connexion de base de données a été utilisée pour authentifier l’utilisateur</li> <li>`sms` : une connexion SMS [Passwordless](/fr-CA/docs/glossary?term=Passwordless) a été utilisée pour authentifier l’utilisateur</li> <li>`email` : une connexion Passwordless par courriel a été utilisée pour authentifier l’utilisateur</li> <li>`mfa` : l’utilisateur a effectué une authentification multifacteur</li> </ul> </li> <li>`timestamp` : un entier indiquant l’heure, en secondes, à laquelle la méthode d’authentification a eu lieu au format Unix Epoch</li> </ul> Vous pouvez consulter un exemple de cas d’utilisation de la propriété `context.authentication.methods` dans la [Rule Require MFA once per session](https://github.com/auth0/rules/blob/master/src/rules/require-mfa-once-per-session.js).                                                                                                                                                                                                                                                                                                                                   |
| `context.authorization`      | Un objet contenant des informations relatives à la transaction d’autorisation avec les propriétés suivantes :<ul> <li>`roles` : un tableau de chaînes contenant les noms des [rôles](/fr-CA/docs/glossary?term=roles) attribués à un utilisateur. Vous pouvez consulter un exemple d’utilisation de la propriété `context.authorization.roles` pour ajouter des rôles aux jetons dans [Exemples de cas d’utilisation : Rules avec autorisation](/fr-CA/docs/manage-users/access-control/sample-use-cases-rules-with-authorization#add-user-roles-to-tokens).</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `context.organization`       | Objet contenant des informations sur l’organisation. Comprend les propriétés suivantes :<ul> <li>`id` : chaîne contenant l’ID de l’organisation à laquelle l’utilisateur se connecte.</li><li>`name` : chaîne contenant le nom de l’organisation (tel qu’il est défini dans l’Auth0 Dashboard).</li><li>`metadata` : dictionnaire de paires clé-valeur de chaînes contenant d’autres propriétés de l’organisation.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

<div id="learn-more">
  ## En savoir plus
</div>

* [Débogage des Rules](/fr-CA/docs/customize/rules/debug-rules)
* [Propriétés de l’objet utilisateur dans les Rules](/fr-CA/docs/customize/rules/user-object-in-rules)
* [Exemples de cas d’utilisation : scopes et claims](/fr-CA/docs/get-started/apis/scopes/sample-use-cases-scopes-and-claims)
