> ## 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 contient des renseignements sur les adresses IP des utilisateurs, les applications et leur emplacement.

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

<Warning>
  La date de fin de vie (EOL) de Rules et Hooks sera le **18 novembre 2026**, et ils ne sont plus offerts aux nouveaux tenants créés à compter du **16 octobre 2023**. Les tenants 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 Auth0. Avec Actions, vous avez accès à des informations de typage détaillées, à de la documentation intégrée et à des packages `npm` publics, et vous pouvez établir des intégrations externes qui améliorent votre expérience globale d’extensibilité. Pour en savoir plus sur ce qu’offre Actions, consultez [Comprendre le fonctionnement des Auth0 Actions](/docs/fr-ca/customize/actions/actions-overview).

  Pour vous aider dans cette migration, nous proposons des guides pour vous aider à [passer de Rules à Actions](/docs/fr-ca/customize/actions/migrate/migrate-from-rules-to-actions) et à [passer de Hooks à Actions](/docs/fr-ca/customize/actions/migrate/migrate-from-hooks-to-actions). Nous avons aussi une page dédiée, [Move to Actions](https://auth0.com/extensibility/movetoactions), qui présente une comparaison des fonctionnalités, [une démo d’Actions](https://www.youtube.com/watch?v=UesFSY1klrI) et d’autres ressources pour vous accompagner dans votre migration.

  Pour en savoir plus sur la dépréciation de Rules et Hooks, consultez notre billet de blogue : [Preparing for Rules and Hooks End of Life](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 changements seront disponibles dans les jetons une fois que toutes les Rules auront fini de s’exécuter. Si votre application exige aussi la <Tooltip tip="Authentification multifacteur (MFA) : processus d’authentification de l’utilisateur qui utilise un facteur en plus du nom d’utilisateur et mot de passe, comme un code envoyé par SMS." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=multifactor+authentication">authentification multifacteur</Tooltip> ou le consentement de l’utilisateur, une invite sera présentée à l’utilisateur avant que les changements apportés 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 de caractères contenant le nom du tenant.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `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 le Dashboard).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `context.clientMetadata`     | Un objet qui contient d’autres propriétés de l’application. Ses clés et ses valeurs sont des chaînes de caractères.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `context.connectionID`       | Une chaîne de caractères 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 sera `waad` (Windows Azure AD), `ad` (Active Directory/LDAP), `auth0` (connexions de base de données), etc.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `context.connectionOptions`  | Un objet représentant les options définies pour la connexion. `connectionOptions.tenant_domain` est une chaîne de caractères contenant le domaine utilisé pour l’authentification lorsqu’une connexion Enterprise est utilisée.<br />`connectionOptions.domain_aliases` est un tableau contenant les domaines facultatifs enregistrés comme alias, en plus du domaine principal (indiqué dans la propriété `connectionOptions.tenant_domain`).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `context.connectionMetadata` | Un objet représentant les métadonnées définies sur 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 endpoints [SAML](/docs/fr-ca/glossary?term=SAML) et WS-Fed. Utile pour le mappage avancé des claims et l’enrichissement des tokens (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 Web</li> <li>`oidc-implicit-profile` : utilisé sur les appareils mobiles et les applications monopages</li> <li>`oauth2-device-code` : transaction utilisant le [Device Authorization Flow](/docs/fr-ca/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 utilisant un JWT 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 token au moyen de l’échange de Refresh Token</li> <li>`samlp` : protocole SAML utilisé avec les applications SaaS</li> <li>`wsfed` : WS-Federation utilisé avec des 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` : lorsqu’une règle de redirection reprend</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `context.riskAssessment`     | Un objet contenant des scores précis (faible, moyen, élevé, neutre) pour les évaluateurs de tentatives de connexion à risque élevé. Consultez [Personnaliser Adaptive MFA avec Rules](/docs/fr-ca/secure/multi-factor-authentication/adaptive-mfa/customize-adaptive-mfa).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `context.stats`              | Un objet contenant des statistiques utilisateur précises, comme `stats.loginsCount`. Notez qu’aucune des variables de compteur renvoyées dans l’objet `stats` n’augmente pendant l’[authentification silencieuse](/docs/fr-ca/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 un ensemble de Rules ne s’exécute, comme dans le cas d’une authentification cross-origin réussie suivie d’une demande de jeton ayant échoué.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `context.sso`                | Cet objet contiendra des renseignements sur la transaction de [Single Sign-on (SSO)](/docs/fr-ca/glossary?term=Single+Sign-on+%28SSO%29) (si disponible)<ul> <li>`with_auth0` : lorsqu’un utilisateur se connecte avec SSO à une application où le paramètre `Use Auth0 instead of the IdP to do Single Sign-On` est activé (uniquement pour les tenants 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 utilisant SSO.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `context.accessToken`        | Un objet représentant les options définies pour le [jeton d’accès](/docs/fr-ca/glossary?term=Access+Toke). Vous pouvez utiliser cet objet pour [ajouter des claims personnalisés avec espace de noms](/docs/fr-ca/get-started/apis/scopes/sample-use-cases-scopes-and-claims#add-custom-claims-to-a-token) au [jeton d’accès](/docs/fr-ca/glossary?term=Access+Toke). `context.accessToken.scope` peut être utilisé pour [modifier les scopes renvoyés par le jeton d’accès](/docs/fr-ca/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és seront inclus dans le jeton d’accès après l’exécution de toutes les Rules.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `context.idToken`            | Objet représentant les options définies dans le [ID Token](/docs/fr-ca/secure/tokens/id-tokens). Sert à ajouter des revendications personnalisées [avec espace de noms](/docs/fr-ca/secure/tokens/json-web-tokens/create-custom-claims) au ID Token. Les revendications personnalisées seront incluses dans le ID Token une fois toutes les Rules exécutées.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `context.multifactor`        | Un objet représentant les paramètres du MFA utilisés dans [la mise en œuvre du MFA contextuel](/docs/fr-ca/secure/multi-factor-authentication).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `context.redirect`           | L’objet utilisé pour [mettre en place la redirection d’un utilisateur dans une rule](/docs/fr-ca/customize/rules/redirect-users#how-to-implement-a-redirect).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `context.sessionID`          | Un identifiant interne de la session d’authentification. La valeur est conservée seulement si `prompt=none` est utilisé dans la demande d’autorisation. Notez que l’ID de session peut changer **après** l’exécution de la règle dans d’autres flux, de sorte que la valeur disponible dans `context.sessionID` pourrait ne pas correspondre au nouvel ID de session que l’utilisateur recevra. Cette valeur n’est donc utile que lorsque `prompt=none` est utilisé.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `context.request`            | Un objet contenant des renseignements utiles sur la requête. Il peut aussi être défini sur `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 source de l’utilisateur qui tente de se connecter. Nous exposons des adresses IPv6 sur nos points de terminaison publics (par exemple, travel0.us.auth0.com). Si une requête provient d’une machine qui prend en charge IPv6, cette valeur contiendra une adresse IPv6. Si vous manipulez manuellement des adresses IP, nous vous recommandons 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 associés à l’adresse IP. Il possède les propriétés suivantes :<ul> <li>`country_code` : un code à deux caractères pour le pays associé à l’adresse IP.</li> <li>`country_code3` : un code à trois caractères pour le 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 pour le 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 utilisateur unique du compte principal de l’utilisateur. Sert à [lier des comptes d’utilisateur](/docs/fr-ca/manage-users/user-accounts/user-account-linking#automatic-account-linking) de différents fournisseurs d’identité.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `context.authentication`     | Un objet contenant des renseignements liés à 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 durant 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 représentant le nom de la méthode d’authentification qui a été effectuée. Il peut s’agir de 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](/docs/fr-ca/glossary?term=Passwordless) a été utilisée pour authentifier l’utilisateur</li> <li>`email` : une connexion Passwordless Email 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, en temps Unix Epoch</li> </ul> Vous pouvez consulter un exemple de cas d’utilisation de la propriété `context.authentication.methods` dans la [règle 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 liées à la transaction d’autorisation avec les propriétés suivantes :<ul> <li>`roles` : un tableau de chaînes contenant les noms des [rôles](/docs/fr-ca/glossary?term=roles) attribués à un utilisateur. Vous trouverez un exemple de cas 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](/docs/fr-ca/manage-users/access-control/sample-use-cases-rules-with-authorization#add-user-roles-to-tokens).</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `context.organization`       | Objet contenant des renseignements liés à l’organisation. Inclut les propriétés suivantes :<ul> <li>`id` : String contenant l’ID de l’organisation avec laquelle l’utilisateur se connecte.</li><li>`name` : String contenant le nom de l’organisation (tel que 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](/docs/fr-ca/customize/rules/debug-rules)
* [Propriétés de l’objet `user` dans les Rules](/docs/fr-ca/customize/rules/user-object-in-rules)
* [Exemples de scénarios d’utilisation : Scopes et claims](/docs/fr-ca/get-started/apis/scopes/sample-use-cases-scopes-and-claims)
