> ## 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 acheminer des événements de journalisation vers l’URL de votre choix.

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

Les webhooks permettent d’acheminer des événements vers un serveur Web externe. Auth0 offre plusieurs intégrations qui transmettent automatiquement des événements à 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 des 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 journaux
</div>

1. Accédez à [Dashboard > Monitoring > Streams](https://manage.auth0.com/#/log-streams) et 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="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="Dashboard Monitoring Streams Custom Webhook Settings Tab" width="1498" height="2064" data-path="docs/images/cdy7uua7fh8z/5vJVD09aqSF0xEZZFk6wh2/e6469041b2dd1e4f1b142961ca0a12ab/custom-webhook-settings.png" />
   </Frame>

   | Paramètre                    | Description                                                                            |
   | ---------------------------- | -------------------------------------------------------------------------------------- |
   | **Name**                     | Un nom d’affichage unique pour distinguer cette intégration des autres intégrations.   |
   | **Payload URL**              | L’URL à laquelle les payloads d’événement sont envoyés au moyen de requêtes HTTP POST. |
   | **Authorization Token**      | (Facultatif) La valeur de l’en-tête Authorization de la requête.                       |
   | **Content Type**             | Le type de média du payload qui sera transmis au webhook.                              |
   | **Content Format**           | Permet de recevoir les données au format JSON lines, tableau ou objet.                 |
   | **Filter by Event Category** | Liste des filtres de flux de journaux.                                                 |
   | **Starting Cursor**          | (Facultatif) Le jour et l’heure précis à partir desquels démarrer le flux.             |
4. Cliquez sur **Save**.

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

1. Passez à la vue **Santé** et confirmez que l’**état du flux** est **Actif**.
2. Effectuez une action qui crée un événement dans les journaux du tenant, comme une connexion, un échange de jetons ou un appel à l’Auth0 Management API.
3. Confirmez que l’événement a bien été créé dans les journaux de votre tenant.
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 **Santé** et confirmez qu’aucune erreur ne s’est produite.

<div id="troubleshoot-webhooks">
  ## Dépannage des webhooks
</div>

Si votre webhook ne fonctionne pas, il peut être difficile d’en faire le dépannage et de déterminer la cause du problème. Comme les webhooks sont asynchrones, les tester 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 heureusement des solutions de rechange au processus inefficace décrit ci-dessus. Bien que les détails complets du dépannage d’un webhook en particulier dépassent le cadre de cet article, voici quelques étapes que vous pouvez suivre pour déboguer :

1. Consultez [Auth0 Dashboard > Monitoring > Logs](/docs/fr-ca/deploy-monitor/logs) pour y repérer des messages utiles.
2. Analysez les requêtes envoyé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 avec cURL ou [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](/docs/fr-ca/customize/log-streams/check-log-stream-health)
* [Filtrer les événements de journalisation](/docs/fr-ca/deploy-monitor/logs/log-event-filters)
* [Codes de type de journal](/docs/fr-ca/deploy-monitor/logs/log-event-type-codes)