Passer au contenu principal
Les extensions de journaux Auth0 suivantes sont maintenant obsolètes et seront prises en charge jusqu’aux dates de fin de vie (EOL) indiquées ci-dessous. Il n’est plus possible de créer de nouvelles extensions à partir de cette liste d’extensions de journaux obsolètes. Vous pouvez mettre en place une fonctionnalité équivalente à l’aide de flux de journaux ou d’intégrations de l’Auth0 Marketplace Les éléments suivants atteindront leur fin de vie dans le cloud privé le 6 janvier 2023 :
  • Webhooks d’Auth0 Authentication API
  • Webhooks d’Auth0
  • Journaux vers CloudWatch
  • Journaux vers Logentries
  • Journaux vers Loggly
  • Journaux vers Logstash
  • Journaux vers Papertrail
  • Journaux vers Splunk
  • Journaux vers Sumo Logic
Les éléments suivants atteindront leur fin de vie dans Public Cloud le 2 mai 2023 :
  • Webhooks d’Auth0 Authentication API
  • Webhooks d’Auth0 Management API
  • Journaux vers CloudWatch
  • Journaux vers Logentries
  • Journaux vers Loggly
  • Journaux vers Logstash
  • Journaux vers Papertrail
  • Journaux vers Splunk
  • Journaux vers Sumo Logic
  • Journaux vers Segment
  • Journaux vers Mixpanel
  • Journaux vers AppInsights
  • Journaux vers Azure Blob Storage
À compter des dates de fin de vie indiquées, Auth0 ne prendra plus en charge les extensions de journaux installées figurant dans la liste ci-dessus. Sur cette page, vous trouverez des instructions pour migrer à partir d’extensions de journaux précises.

​
Webhooks de l’Auth0 Authentication API

Assurez-vous que votre destination peut traiter un tableau d’objets de log.
  1. Connectez-vous à votre Auth0 Dashboard.
  2. Accédez à Extensions et sélectionnez votre webhook de l’Auth0 Authentication API dans l’onglet Installed Extensions.
  3. Copiez le Webhook URL et le Authorization Header (si vous en avez un).
  4. Ensuite, accédez à Monitoring > Streams > New Event Stream.
  5. Sélectionnez Custom Webhook, entrez un nom, puis cliquez sur Create.
  6. Configurez votre webhook.
    • Dans Payload URL, entrez l’URL du webhook que vous avez copiée de l’extension.
    • Si vous en avez un, définissez Authorization Token sur la valeur de Authorization Header que vous avez copiée de l’extension.
    • Réglez Content Format sur JSON Array.
  7. Cliquez sur Save.
  8. Retournez à Extensions > Installed Extensions et désactivez votre extension Auth0 Authentication API webhooks.

​
Webhooks de l’Auth0 Management API

Assurez-vous que votre destination peut traiter un tableau d’objets de log.
  1. Connectez-vous à votre Auth0 Dashboard.
  2. Accédez à Extensions et sélectionnez votre webhook de l’Auth0 Management API dans l’onglet Installed Extensions.
  3. Copiez le Webhook URL et le Authorization Header (si vous en avez un).
  4. Accédez à Monitoring > Streams > New Event Stream.
  5. Sélectionnez Custom Webhook, saisissez un nom, puis cliquez sur Create.
  6. Configurez votre webhook.
    • Pour Payload URL, saisissez l’URL du webhook que vous avez copiée depuis l’extension.
    • Si vous en avez un, définissez Authorization Token sur l’en-tête d’autorisation que vous avez copié depuis l’extension.
    • Réglez Content Format sur JSON Array.
  7. Cliquez sur Save.
  8. Revenez à Extensions > Installed Extensions et désactivez votre extension webhooks de l’Auth0 Management API.

​
CloudWatch

Configurez l’intégration Amazon EventBridge offerte sur Auth0 Marketplace. Une fois les événements disponibles dans votre bus d’événements, créez des règles pour acheminer ces événements vers AWS CloudWatch. Assurez-vous de désactiver votre extension Auth0 Logs to CloudWatch :
  1. Connectez-vous à votre Auth0 Dashboard.
  2. Accédez à Extensions > Installed Extensions.
  3. Désactivez l’extension Auth0 Logs to CloudWatch.

​
Loggly

  1. Connectez-vous à votre compte Loggly.
  2. Ouvrez le menu Logs et sélectionnez Source Setup.
  3. Accédez à l’onglet Customer Tokens.
  4. Copiez votre jeton.
  5. Connectez-vous à votre Auth0 Dashboard.
  6. Accédez à Monitoring > Streams > New Event Stream.
  7. Sélectionnez Custom Webhook, entrez un nom, puis cliquez sur Create.
  8. Configurez votre webhook.
    • Pour Payload URL, remplacez LOGGLY_TOKEN par le jeton copié dans votre compte Loggly : https://logs-01.loggly.com/bulk/{LOGGLY_TOKEN}/tag/auth0-{TENANT_NAME}/.
    • Laissez Authorization Token vide.
    • Réglez Content Type sur application/json.
    • Réglez Content Format sur JSON Lines.
  9. Cliquez sur Save.
  10. Accédez à Extensions > Installed Extensions et désactivez votre extension Auth0 Logs to Loggly.

​
Logstash

  1. Connectez-vous à votre Auth0 Dashboard.
  2. Accédez à Monitoring > Streams > New Event Stream.
  3. Sélectionnez Custom Webhook, entrez un nom, puis cliquez sur Create.
  4. Configurez votre webhook.
    • Dans Payload URL, entrez l’URL de votre serveur Logstash.
    • Définissez Authorization Token à Basic <CREDENTIALS>, en remplaçant CREDENTIALS par l’encodage Base64 de votre nom d’utilisateur et de votre mot de passe Logstash, séparés par deux-points (<USER:PASSWORD>). Vous trouverez vos identifiants HTTP Logstash dans votre fichier de configuration Logstash.
  5. Cliquez sur Save.
  6. Accédez à Extensions > Installed Extensions et désactivez votre extension Auth0 Logs to Logstash.

​
Papertrail

  1. Connectez-vous à Papertrail.
  2. Accédez à Log Destinations, puis cliquez sur Create Log Destination.
  3. Saisissez une description et configurez les paramètres de destination.
  4. Dans le volet Accept Connections via …, sélectionnez Token.
  5. Cliquez sur Create.
  6. Connectez-vous à votre Auth0 Dashboard.
  7. Accédez à Monitoring > Streams > New Event Stream.
  8. Sélectionnez Custom Webhook, saisissez un nom, puis cliquez sur Create.
  9. Configurez votre webhook.
    • Réglez Payload URL sur https://logs.collector.solarwinds.com/v1/logs.
    • Réglez Authorization Token sur Basic <CREDENTIALS>, en remplaçant CREDENTIALS par le jeton Papertrail encodé en Base64 obtenu dans les paramètres de destination de Papertrail.
    • Réglez Content Format sur JSON Lines.
  10. Cliquez sur Save.
  11. Accédez à Extensions > Installed Extensions et désactivez votre extension Auth0 Logs to Papertrail.

​
Splunk

Utilisez l’intégration Splunk disponible dans Auth0 Marketplace. Assurez-vous de désactiver l’extension Auth0 Logs to Splunk :
  1. Connectez-vous à votre Auth0 Dashboard.
  2. Accédez à Extensions > Installed Extensions.
  3. Désactivez l’extension Auth0 Logs to Splunk.

​
Sumo Logic

Utilisez l’intégration Sumo Logic offerte dans Auth0 Marketplace. Assurez-vous de désactiver l’extension Auth0 Logs to Sumo Logic :
  1. Connectez-vous à votre Auth0 Dashboard.
  2. Accédez à Extensions > Installed Extensions.
  3. Désactivez l’extension Auth0 Logs to Sumo Logic.

​
Logentries

Il n’existe actuellement aucune procédure pour migrer de l’extension Logs to Logentries vers les flux de journaux.

​
Segment

  1. Connectez-vous à votre Auth0 Dashboard
  2. Dans Extensions > Installed Extensions, repérez votre extension Segment.
  3. Notez votre Write Key, car vous en aurez besoin pour votre nouveau flux de journal vers Segment.
  4. Désactivez votre extension Segment.
  5. Notez l’horodatage UTC du dernier journal reçu dans Segment. Cet horodatage vous permettra de créer votre nouveau flux tout en évitant les journaux en double dans Segment.
  6. Accédez à Monitoring > Log Streams, puis créez un nouveau flux de journal Segment. Saisissez votre Write Key dans le champ approprié, ainsi que l’horodatage que vous avez noté dans la section Start From.
  7. Créez le flux

​
Mixpanel

  1. Connectez-vous à votre compte Mixpanel, puis ouvrez vos Project Settings. Prenez en note votre Project ID et votre Data Residency (la région).
  2. Mixpanel ne recommande plus d’utiliser le jeton de projet pour importer des événements et préconise plutôt le mécanisme de compte de service. Dans la page Project Settings, sélectionnez Service Accounts, puis créez un nouveau compte de service avec des autorisations d’administrateur ou de propriétaire. Prenez en note les identifiants.
  3. Connectez-vous à votre Auth0 Dashboard.
  4. Dans Monitoring > Log Streams, créez un nouveau flux Mixpanel. Entrez l’id du projet, la région et les identifiants du compte de service, puis créez le flux.
  5. N’oubliez pas de désactiver votre ancienne extension. Accédez à Extensions > Installed Extensions et désactivez l’extension Auth0 Logs to Mixpanel.

​
AppInsights

  1. Configurez un flux de journal Azure EventGrid ou utilisez votre flux EventGrid existant.
  2. Suivez les instructions publiées par Azure pour définir une destination pour les événements du journal.
  3. Les journaux peuvent être transformés différemment via Log Streaming. Consultez le code obsolète de l’extension de journaux pour en savoir plus.
Les transformations notables appliquées aux journaux comprennent :
  • Le client AppInsights est remplacé :
    • Définit une heure personnalisée équivalente à l’heure du journal
    • Définit le système d’exploitation et sa version pour qu’ils correspondent aux informations du journal
    • Définit l’étiquette du type d’appareil pour indiquer si le journal provient d’une source mobile
    • Définit l’étiquette de l’adresse IP pour qu’elle corresponde aux informations du journal
    • Définit les étiquettes de l’ID utilisateur, de l’ID de compte, de l’agent utilisateur et de l’ID utilisateur d’authentification pour qu’elles correspondent aux journaux
  • L’enregistrement est nettoyé afin de supprimer les propriétés suivantes si elles sont vides :
    • ip
    • user_id
    • user_name
    • connection
    • client_name
    • description
  • La propriété isMobile de l’enregistrement est modifiée pour contenir la chaîne yes ou no
  • La propriété details de l’enregistrement est convertie en chaîne
  • La propriété details de l’enregistrement est tronquée à 8185 caractères

​
Azure Blob Storage

  1. Configurez un flux de journal Azure EventGrid ou utilisez votre flux EventGrid existant.
  2. Suivez les instructions publiées par Azure pour définir une destination pour les événements du journal.
  3. Les journaux peuvent être transformés différemment via Log Streaming. Consultez le code de l’extension Log obsolète pour plus de détails
Transformations notables apportées aux journaux :
  • Les valeurs type_code et type de l’enregistrement sont ajustées. Type est la description en langage clair de type_code
  • Les champs os, os_version, device et device_version de l’enregistrement sont ajustés si l’enregistrement contient des informations user_agent