Stocker les configurations des Rules

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

La date de fin de vie (EOL) de Rules et Hooks est fixée au 18 novembre 2026, et ils ne sont plus disponibles pour les nouveaux locataires créés à compter du 16 octobre 2023. Les locataires 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 typage 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 d’extensibilité. Pour en savoir plus sur ce qu’Actions permet, consultez Comprendre le fonctionnement des Actions Auth0.

Pour vous aider dans votre migration, nous proposons des guides qui vous aideront à migrer de Rules vers Actions et à migrer de Hooks vers Actions. Nous avons aussi une page dédiée, Passer à Actions, qui présente des comparaisons de fonctionnalités, une démo d’Actions et d’autres ressources pour vous accompagner dans votre démarche de migration.

Pour en savoir plus sur la dépréciation de Rules et Hooks, consultez notre billet de blogue : Se préparer à la fin de vie de Rules et Hooks.

L’objet global configuration est disponible dans les Rules pour stocker des valeurs fréquemment utilisées, comme des URL. Les renseignements sensibles, comme les informations d’identification ou les clés d’API, doivent être stockés au moyen de l’objet configuration et ne pas figurer dans le code de vos Rules.

​

Configurer les 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 existant et remplacez-le par la nouvelle valeur. Vous devez avoir créé au moins une Rule pour afficher la zone de configuration; sinon, la démo Rules s’affiche à la place.

​

Utiliser l’objet de configuration

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

var MY_API_KEY = configuration.MY_API_KEY;

L’exemple suivant présente une Rule qui envoie un message Slack lorsqu’un nouvel utilisateur vient de s’inscrire. Le Slack Webhook correspond à une valeur de configuration définie avec la clé SLACK_HOOK_URL.

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

  // obtenez l'URL du webhook 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 à l'API Slack, retourner immédiatement (la requête continuera dans le sandbox)`
  callback(null, user, context);
}