Déclencheurs de flux d’événements

Découvrez les Actions de flux d’événements.

Les Actions de flux d’événements sont des fonctions qui s’exécutent de façon asynchrone lorsqu’un événement précis survient dans votre locataire Auth0. Il s’agit d’Actions non bloquantes qui n’ont aucune incidence sur la latence de l’expérience utilisateur.

Chaque Action de flux d’événements est associée à un flux d’événements et surveille un ensemble prédéfini de types d’événements (par exemple, les connexions réussies, les changements de mot de passe ou les suppressions d’utilisateurs). Lorsqu’un événement auquel l’Action est abonnée se produit, celle-ci est déclenchée. Contrairement aux Actions Login ou Pre-Registration, les Actions de flux d’événements s’exécutent en arrière-plan et n’affectent pas la transaction principale de l’utilisateur.

Ces Actions sont non bloquantes (asynchrones) et abonnées à un ensemble précis de types d’événements.

​

Déclencheurs

​

Flux d’événements

Les Actions event-stream sont des fonctions qui s’exécutent lorsque les types d’événements auxquels vous êtes abonné surviennent.

​

Références

• Objet d’événement : fournit le contexte à la fois du message flux d’événements et de l’exécution de l’Action.
• Objet API : fournit des méthodes pour modifier le comportement du flux.

​

Cas d’utilisation

​

Synchronisation

Une Action de flux d’événements peut servir à transmettre un événement précis à un service externe selon une logique personnalisée. L’Action suivante montre comment transmettre de façon sécurisée un message d’événement à un service externe à l’aide d’une clé API stockée.

/**
* Gestionnaire à exécuter lors du traitement des événements dans un flux d'événements.
* @param {Event} event - Détails sur l'événement entrant.
* @param {EventStreamAPI} api - Méthodes et utilitaires pour définir le traitement du flux d'événements.
*/
exports.onExecuteEventStream = async (event, api) => {
  const message = event.message;

  try {
    await fetch(event.secrets.URL, {
      method: 'POST',
      headers: {
        'X-API-Key': event.secrets.API_KEY,
      },
      body: JSON.stringify(message),
    });
  } catch (err) {
    throw new Error('External service failure');
  }

  return;
};

Pour en savoir plus sur la création d’Actions, consultez Write Your First Action.

Pour en savoir plus sur la création d’un flux d’événements, consultez Create an Event Stream.