Stocker la configuration des Rules

Découvrez l’objet global configuration dans Rules pour stocker les valeurs couramment utilisées.

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 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’offrent Actions, consultez Comprendre le fonctionnement d’Auth0 Actions.

Pour vous aider dans 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émonstration d’Actions 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.

L’objet global configuration est disponible dans Rules pour stocker les valeurs couramment utilisées, comme des URL. Les renseignements sensibles, comme les identifiants ou les clés API, doivent être stockés dans l’objet configuration et non dans votre code Rules.

​

Configurer des valeurs

Vous pouvez définir des valeurs de configuration dans vos paramètres des Rules du Dashboard.

Pour modifier la valeur d’une clé de configuration, supprimez le paramètre de configuration existant et remplacez-le par la nouvelle valeur. Vous devez avoir créé au moins une Rule pour voir la zone de configuration; sinon, la démo des Rules s’affiche à la place.

​

Utiliser l’objet de configuration

Vous pouvez accéder à toutes les valeurs de configuration que vous définissez par clé au moyen de l’objet configuration dans votre code Rules.

var MY_API_KEY = configuration.MY_API_KEY;

L’exemple suivant montre une Rule qui envoie un message Slack lorsqu’un nouvel utilisateur s’inscrit. Le webhook Slack correspond à une valeur de configuration définie à l’aide de la clé SLACK_HOOK_URL.

function (user, context, callback) {
  // court-circuiter si l'utilisateur s'est déjà inscrit ou utilise un Refresh Token
  if (context.stats.loginsCount > 1 || context.protocol === 'oauth2-refresh-token') {
    return callback(null, user, context);
  }

  // obtenez l'URL du hook Slack ici : https://slack.com/services/10525858050
  const SLACK_HOOK = configuration.SLACK_HOOK_URL;

  const slack = require('slack-notify')(SLACK_HOOK);
  const message = 'New User: ' + (user.name || user.email) + ' (' + user.email + ')';
  const channel = '#some_channel';

  slack.success({
    text: message,
    channel: channel
  });

  // ne pas attendre la fin de l'appel d'API Slack, retourner immédiatement (la requête continuera dans le sandbox)`
  callback(null, user, context);
}