Utiliser la Management API depuis Rules

Appelez la Management API d’Auth0 depuis une Rule à l’aide de l’objet auth0 ManagementClient restreint, ou utilisez une version plus récente de node-auth0 pour accéder à des endpoints et à des scopes supplémentaires.

La date de fin de vie (EOL) de Rules et de Hooks est le 18 novembre 2026, et ces fonctionnalités ne sont plus offertes aux nouveaux tenants créés à compter du 16 octobre 2023. Les tenants existants ayant des Hooks actifs conserveront l’accès au produit Hooks jusqu’à sa fin de vie.

Nous vous recommandons fortement d’utiliser Actions pour étendre Auth0. Avec Actions, vous avez accès à des informations de type enrichies, à 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 d’extensibilité. Pour en savoir plus sur ce qu’offre Actions, consultez Understand How Auth0 Actions Work.

Pour faciliter votre migration, nous proposons des guides pour vous aider à passer de Rules à Actions et à passer de Hooks à Actions. Nous avons également une page dédiée, Move to Actions, qui présente des comparaisons de fonctionnalités, une démo d’Actions et d’autres ressources pour vous accompagner dans votre migration.

Pour en savoir plus sur la dépréciation de Rules et de Hooks, consultez notre billet de blogue : Preparing for Rules and Hooks End of Life.

Dans toute Auth0 Rule que vous écrivez, vous pouvez mettre à jour le app_metadata ou le user_metadata d’un utilisateur à l’aide de l’objet auth0, qui est une instance de ManagementClient soumise à des restrictions particulières (définie dans la bibliothèque cliente Node.js node-auth0) et qui fournit un accès limité à l’Auth0 Management API.

Pour accéder à d’autres endpoints de la Management API depuis Rules, vous devez utiliser une autre version de la bibliothèque.

Le jeton d’accès pour la Management API, accessible au moyen de auth0.accessToken, est limité aux scopes read:users et update:users. Si vous avez besoin d’un éventail plus large de scopes, vous pouvez demander un jeton à l’aide du Client Credentials Flow. Consultez Get Management API Access Tokens for Production.

​

Accéder à une version plus récente de la bibliothèque

Vous pouvez charger une version plus récente de la bibliothèque cliente Node.js d’Auth0 en indiquant la version précise de la bibliothèque. Pour obtenir les renseignements les plus récents sur les versions, consultez le dépôt Node d’Auth0 dans Github.

Dans cet exemple, nous chargeons la version 2.9.1 de la bibliothèque, puis interrogeons la liste des utilisateurs et affichons ces utilisateurs dans la console (pour les examiner avec les Journaux en temps réel des Actions).

La recherche d’utilisateurs à partir de Rules peut nuire aux performances lors des connexions; nous le déconseillons.

function (user, context, callback) {
  var ManagementClient = require('auth0@2.9.1').ManagementClient;
  var management = new ManagementClient({
    token: auth0.accessToken,
    domain: auth0.domain
  });

  management.getUsers(function (err, users) {
    console.log(users);
    callback(null, user, context);
  });
}

Pour voir une liste filtrée des bibliothèques disponibles pouvant être définies comme obligatoires, consultez les versions de bibliothèques disponibles.