Passer au contenu principal
Les Rules atteindront leur fin de vie (EOL) le January 31, 2028.
  • Depuis le October 16, 2023, les Rules ne sont plus offertes dans les nouveaux locataires.
  • Depuis le November 18, 2024, les Rules sont en lecture seule. Les Rules actives continuent de s’exécuter, et vous pouvez toujours les activer ou les désactiver, et modifier leurs valeurs de configuration et leurs secrets. Par contre, vous ne pouvez plus modifier leur code dans le Dashboard, la Management API ou les outils qui l’utilisent, comme Auth0 CLI, Deploy CLI, Terraform et Agent Skills.
  • Après le January 31, 2028, les Rules cesseront de s’exécuter et seront supprimées.
Utilisez les Actions pour étendre Auth0 :
Vous pouvez créer vos propres Rule(s) pour répondre à vos besoins fonctionnels précis. Vous pouvez modifier un modèle de Rule existant ou choisir de partir de zéro à l’aide de l’un de nos exemples. Auth0 fournit un certain nombre de Rules et de modèles de Rule pour vous aider à atteindre vos objectif(s). Pour voir la liste, consultez notre dépôt de Rules sur GitHub.

Fonctionnement des Rule

Les Rule sont des fonctions JavaScript qui s’exécutent lorsqu’un utilisateur s’authentifie auprès de votre application. Elles s’exécutent une fois le processus d’authentification terminé, et vous pouvez les utiliser pour personnaliser et étendre les capacités d’Auth0. Pour des raisons de sécurité, le code de vos Rule s’exécute de façon isolée de celui des autres tenants Auth0 dans un bac à sable. Les Rule s’exécutent aussi pendant le flux de renouvellement du jeton. Pour en savoir plus, consultez Refresh Tokens. Dans Auth0, le flux de transaction d’authentification fonctionne comme suit lorsque vous utilisez des Rule :
Schéma des Rule dans le flux d’authentification
  1. Une application lance une requête d’authentification vers Auth0.
  2. Auth0 achemine la requête vers un fournisseur d’identité au moyen d’une connexion configurée.
  3. L’utilisateur s’authentifie avec succès.
  4. Le jeton ID ou le jeton d’accès passe par le pipeline des Rule, puis est envoyé à l’application.

Prérequis

Si vous comptez utiliser des variables globales dans votre rule, assurez-vous d’abord de configurer les variables de vos rules. Pour en savoir plus, consultez Configurer les variables globales pour Rules.

Utiliser le Dashboard

  1. Accédez à Dashboard > Auth Pipeline > Rules et cliquez sur Create.
    Dashboard - Auth Pipeline - Rules
  2. Sélectionnez un modèle de Rule.
    Dashboard - Auth Pipeline - Rules - Template
  3. Donnez un nom à la rule, modifiez le script selon vos besoins, puis cliquez sur Save changes.
    Dashboard - Auth Pipeline - Rules - Edit Rule

Utiliser la Management API

Faites une requête POST à l’endpoint Create Règle. Assurez-vous de remplacer les valeurs de l’espace réservé MGMT_API_ACCESS_TOKEN, RULE_NAME, RULE_SCRIPT, RULE_ORDER et RULE_ENABLED par votre , le nom de la Règle, le script de la Règle, le numéro d’ordre de la Règle et la valeur d’activation de la Règle, respectivement.
Vous utilisez l’Auth0 CLI? Si ce n’est pas déjà fait, configurez et authentifiez votre session CLI avant d’exécuter cette commande.
Nous exposons des adresses IPv6 dans nos endpoints publics (p. ex., travel0.us.auth0.com). Si une request provient d’une machine qui prend en charge IPv6, la propriété context.request.ip contiendra une adresse IPv6. Si vous manipulez manuellement des adresses IP, nous vous suggérons d’utiliser la library ipaddr.js@1.9.0.

Gérer les limites de débit

Pour les règles qui appellent les API Auth0, vous devriez toujours gérer les limites de débit en vérifiant l’en-tête X-RateLimit-Remaining et en prenant les mesures appropriées lorsque la valeur retournée approche de 0. Vous devriez aussi ajouter une logique pour gérer les cas où vous dépassez les limites de débit établies et recevez le code d’état HTTP 429 (Trop de requêtes) ; dans ce cas, si une nouvelle tentative est nécessaire, il vaut mieux prévoir un délai d’attente progressif afin d’éviter d’entrer dans une boucle infinie de tentatives. Pour en savoir plus sur les limites de débit, consultez la politique sur les limites de débit des API Auth0.

Modules disponibles

Les Rules s’exécutent dans un bac à sable JavaScript configuré pour une version précise de Node.js. Le bac à sable est compatible avec toutes les versions du langage JavaScript (et la syntaxe associée) prises en charge par la version de Node.js configurée, ainsi qu’avec un grand nombre de modules Node.js. Pour obtenir la liste des modules de bac à sable pris en charge, consultez Can I require: Auth0 Extensibility.

En savoir plus