> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Découvrez comment configurer un flux de journaux à l’aide d’un webhook personnalisé pour transmettre des événements de journal à l’URL de votre choix.

# Créer des flux de journaux personnalisés à l’aide de webhooks

Les webhooks permettent de transmettre des événements à un serveur Web externe. Auth0 offre plusieurs intégrations qui envoient automatiquement les événements vers des systèmes tiers de gestion et d’analyse des journaux. Toutefois, si votre système tiers n’est pas pris en charge, vous pouvez configurer une intégration de webhook personnalisée.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Vous ne pouvez configurer qu’une seule URL de payload par configuration de webhook, mais vous pouvez utiliser la même URL pour plusieurs flux. Le payload sera transmis au format JSON Lines. Gardez-le à l’esprit lorsque vous traitez les journaux dans votre configuration de webhook.
</Callout>

<div id="configure-api-endpoint">
  ## Configurer le point de terminaison de l’API
</div>

Vous créerez une API qui expose une seule route (par exemple, `/api/logs`) et qui accepte les requêtes `HTTP POST`.

<Warning>
  Les certificats HTTP auto-signés ne sont pas pris en charge.
</Warning>

<div id="configure-log-stream">
  ## Configurer le flux de journal
</div>

1. Accédez à [Auth0 Dashboard > Monitoring > Streams](https://manage.auth0.com/#/log-streams), puis cliquez sur **Create Stream**.

   <Frame>
     <img src="https://mintcdn.com/translations/MV7tE-x71x8RWRES/docs/images/cdy7uua7fh8z/5ZY6sT68DabXNL9Dr4bhss/ff0f7306fcf9d64247a61a48b12a39a9/log_stream.png?fit=max&auto=format&n=MV7tE-x71x8RWRES&q=85&s=d758c12e1c9314e6cbddb3457bdf088e" alt="Auth0 Dashboard Monitoring Streams" width="1924" height="1336" data-path="docs/images/cdy7uua7fh8z/5ZY6sT68DabXNL9Dr4bhss/ff0f7306fcf9d64247a61a48b12a39a9/log_stream.png" />
   </Frame>
2. Sélectionnez **Custom Webhook** et saisissez un nom unique pour votre nouveau flux.
3. Configurez les paramètres suivants :

   <Frame>
     <img src="https://mintcdn.com/translations/6GE5Z24GDCZehiJ9/docs/images/cdy7uua7fh8z/5vJVD09aqSF0xEZZFk6wh2/e6469041b2dd1e4f1b142961ca0a12ab/custom-webhook-settings.png?fit=max&auto=format&n=6GE5Z24GDCZehiJ9&q=85&s=7e02467792efac2a21bd4409a82adcc6" alt="Onglet Settings de Custom Webhook dans Auth0 Dashboard Monitoring Streams" width="1498" height="2064" data-path="docs/images/cdy7uua7fh8z/5vJVD09aqSF0xEZZFk6wh2/e6469041b2dd1e4f1b142961ca0a12ab/custom-webhook-settings.png" />
   </Frame>

   | Paramètre                             | Description                                                                              |
   | ------------------------------------- | ---------------------------------------------------------------------------------------- |
   | **Nom**                               | Un nom d’affichage unique pour distinguer cette intégration des autres.                  |
   | **URL du payload**                    | L’URL à laquelle les payloads d’événement sont envoyés sous forme de requêtes HTTP POST. |
   | **Jeton d’autorisation**              | (Facultatif) La valeur de l’en-tête Authorization de la requête.                         |
   | **Type de contenu**                   | Le type de média du payload qui sera transmis au webhook.                                |
   | **Format du contenu**                 | Recevez les données sous forme de lignes JSON, de tableaux ou d’objets.                  |
   | **Filtrer par catégorie d’événement** | Liste des filtres du flux de journal.                                                    |
   | **Curseur de départ**                 | (Facultatif) La date et l’heure précises à partir desquelles démarrer le flux.           |
4. Cliquez sur **Save**.

<div id="test-configuration">
  ## Tester la configuration
</div>

1. Accédez à la vue **Health** et confirmez que **Stream Status** est **Active.**
2. Effectuez une action qui crée un événement dans les journaux du locataire, comme une ouverture de session, un échange de jeton ou un appel à la Management API d’Auth0.
3. Confirmez que l’événement a été créé dans les journaux de votre locataire.
4. Confirmez que votre API a reçu une requête `HTTP POST` contenant les données de l’événement.
5. Retournez à la vue **Health** et confirmez qu’aucune erreur ne s’est produite.

<div id="troubleshoot-webhooks">
  ## Résoudre les problèmes de webhooks
</div>

Si votre webhook ne fonctionne pas, il peut être difficile d’en trouver la cause. Les webhooks étant asynchrones, leur test peut vous obliger à déclencher le webhook, à attendre, puis à vérifier la réponse (si tant est que vous en ayez reçu une).

Cela dit, il existe des solutions plus efficaces que le processus décrit ci-dessus. Même si les détails complets du dépannage d’un webhook particulier dépassent le cadre de cet article, voici quelques étapes que vous pouvez suivre pour déboguer :

1. Consultez [Auth0 Dashboard > Monitoring > Logs](/fr-CA/docs/deploy-monitor/logs) pour y trouver des messages utiles.
2. Analysez les requêtes effectuées par votre webhook à l’aide d’un outil comme [Mockbin](http://mockbin.io/), [Beeceptor](https://beeceptor.com/) ou [RequestBin](https://github.com/RonTt/Requestbin) (auto-hébergé).
3. Simulez des requêtes à l’aide de cURL ou de [Postman](https://www.getpostman.com/).
4. Testez le code de votre webhook localement à l’aide d’un outil comme [localtunnel](https://github.com/localtunnel/localtunnel) ou [ngrok](https://ngrok.com/).
5. Utilisez un outil comme [Runscope](https://www.runscope.com/) ou [Assertible](https://assertible.com/) pour surveiller l’ensemble du flux d’exécution.

<div id="learn-more">
  ## En savoir plus
</div>

* [Vérifier l’état de santé du flux de journaux](/fr-CA/docs/customize/log-streams/check-log-stream-health)
* [Filtrer les événements de journal](/fr-CA/docs/deploy-monitor/logs/log-event-filters)
* [Codes de type d’événement de journal](/fr-CA/docs/deploy-monitor/logs/log-event-type-codes)