> ## 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 utiliser Correlation ID pour suivre les événements dans le processus d’authentification.

# Configurer Correlation ID

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "bêta",
    "ea": "Accès anticipé"
  };
  const stageText = stageTextMap[stage] || "une phase de lancement du produit";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>Cette fonctionnalité est offerte avec les forfaits {linkify(`${plans}`, "https://auth0.com/pricing")}. </>}
            {contact && "Pour y participer, communiquez avec " + contact + ". "}
            {terms && <>En utilisant cette fonctionnalité, vous acceptez les conditions applicables de l’essai gratuit énoncées dans le {linkify("Master Subscription Agreement", "https://www.okta.com/legal")} d’Okta.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>La fonctionnalité {feature} est en {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="ID de corrélation" stage="ea" terms="true" contact="Auth0 Support ou votre gestionnaire de compte technique" />

<Card title="Prérequis">
  Pour utiliser `correlation_id`, vous devez avoir :

  * **Auth0 Universal Login configuré** : l’ID de corrélation est disponible dans les flux Universal Login.
  * **Une application capable de générer des ID uniques** : votre application doit pouvoir générer des UUID ou des ID de transaction. (Exemple : `txn_12345_xyz`, des ID de session ou des ID de commande)

  <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
    Si `correlation_id` n’est pas disponible dans vos requêtes d’autorisation, il se peut que cette fonctionnalité ne soit pas activée dans votre tenant.
  </Callout>
</Card>

Auth0 vous permet de suivre les transactions d’authentification à l’aide d’un ID de corrélation. Cette capacité de suivi peut réduire le temps de réponse du soutien et vous offrir une traçabilité dans plusieurs systèmes en aval des événements d’authentification.

Le paramètre `correlation_id` ajoute à l’URL d’autorisation un identifiant unique généré par votre application. Cet ID est automatiquement enregistré, ce qui vous permet de suivre et de filtrer les événements dans les [journaux du tenant Auth0](/docs/fr-ca/deploy-monitor/logs).

L’ID de corrélation est conservé dans les événements suivants :

* Inscription
* Connexion
* Inscription et vérifications de Multi-Factor Authentication (MFA)
* Réinitialisation du mot de passe

Vous pouvez utiliser l’ID de corrélation avec Universal Login, Universal Login Page Templates, modèles de courriel, modèles SMS, pages d’erreur personnalisées, Flows et Auth0 Actions.

<div id="configure-correlation-id">
  ## Configurer l’ID de corrélation
</div>

Les valeurs de `correlation_id` doivent respecter les contraintes suivantes :

* **Caractères autorisés** : caractères alphanumériques et caractères spéciaux correspondant à `/^[-\w.*~@+/:]{1,64}$/`.
* **Longueur maximale** : 64 caractères
* **Ne doit pas** contenir de renseignements personnels permettant d’identifier une personne (PII)

Transmettez le paramètre `correlation_id` dans l’objet `authorizationParams` pour ajouter l’ID unique à l’URL d’autorisation, comme dans l’exemple suivant :

```javascript wrap lines theme={null}
const { loginWithRedirect } = useAuth0();
loginWithRedirect({
  authorizationParams: {
    // Ajoute "&correlation_id=..." à l'URL à des fins de suivi
    correlation_id: "YOUR_CORRELATION_ID"
  }
});
```

<div id="universal-login">
  ## Universal Login
</div>

Tous les flux Universal Login prennent en charge `correlation_id`. Une fois la valeur de l’ID de corrélation transmise au point de terminaison `/authorize`, les événements d’authentification génèrent des logs du tenant contenant l’ID de corrélation, que vous pouvez utiliser à des fins de suivi. Utilisez le SDK de la Management API pour récupérer et filtrer les événements récents afin d’isoler une transaction précise.

L’exemple de requête suivant utilise le SDK de la Management API pour récupérer les événements d’authentification les plus récents. Il les filtre ensuite localement afin d’isoler un événement précis :

```javascript wrap lines theme={null}
// 1. Envoyer une requête à la Management API (syntaxe SDK v5)
const { data: logs } = await management.logs.list({
  per_page: 100,
  sort: 'date:-1'
});
// 2. Filtrer le tableau côté client pour trouver votre ID
const transactionEvents = logs.filter(log =>
  log.references?.correlation_id === "YOUR_CORRELATION_ID"
);
console.log(`Found ${transactionEvents.length} events for this transaction.`);
```

<div id="login-page-template">
  ### Modèle de page de connexion
</div>

Si vous personnalisez votre expérience de connexion avec les [Universal Login Page Templates](/docs/fr-ca/customize/login-pages/universal-login/customize-templates), ajoutez le `correlation_id` à votre modèle pour suivre les événements d’authentification liés à une connexion personnalisée.

L’exemple suivant montre `correlationId: "{{correlation_id}}"` ajouté à `{%- auth0:widget -%}`.

```html wrap lines theme={null}
<!-- Exemple : Injection de l'ID dans un script côté client -->
<!-- Remarque : {{ }} est une syntaxe de gabarit Liquid évaluée côté serveur par Auth0, et non des espaces réservés de documentation -->
<script>
  window.addEventListener("load", function () {
    const loginContext = {
      application: "{{application.name}}",
      // Accéder à correlation_id directement via la syntaxe Liquid
      correlationId: "{{correlation_id}}"
    };

    console.log("Tracking Context:", loginContext);
    // Vous pouvez maintenant transmettre loginContext.correlationId à votre outil d'analyse
  });
</script>
```

<div id="email-templates">
  ## Modèles de courriel
</div>

Vous pouvez inclure `correlation_id` dans [Modèles de courriel](/docs/fr-ca/customize/email/email-templates/customize-email-templates) pour faciliter le suivi des événements d’authentification qui déclenchent des notifications par courriel, comme les réinitialisations de mot de passe ou les courriels de vérification.

L’exemple suivant montre `{{correlation_id}}` ajouté au corps d’un modèle de courriel.

```liquid wrap lines theme={null}
<p>If you did not initiate this request, please ignore this email.</p>
<p>Tracking reference: {{correlation_id}}</p>
```

<div id="sms-templates">
  ## Modèles SMS
</div>

Vous pouvez inclure `correlation_id` dans les [modèles SMS](/docs/fr-ca/customize/phone-messages/phone-templates) pour retracer les événements d’authentification qui déclenchent des notifications par SMS, comme les demandes de vérification MFA.

L’exemple suivant montre `{{correlation_id}}` ajouté à un modèle SMS.

```liquid wrap lines theme={null}
Your verification code is: {{code}}. Ref: {{correlation_id}}
```

<div id="custom-error-pages">
  ## Pages d’erreur personnalisées
</div>

Vous pouvez inclure `correlation_id` dans les [Pages d’erreur personnalisées](/docs/fr-ca/customize/login-pages/custom-error-pages) pour afficher directement la référence de suivi sur les pages d’erreur, ce qui permet aux utilisateurs de signaler plus facilement les problèmes et à votre équipe de soutien de retracer la transaction en échec.

L’exemple suivant montre `{{correlation_id}}` ajouté à un modèle de page d’erreur personnalisée.

```liquid wrap lines theme={null}
<h1>{{error | escape}}: {{error_description | escape}}</h1>
<p>Si vous avez besoin de soutien, mentionnez cet ID : {{correlation_id}}</p>
```

<div id="auth0-actions">
  ## Auth0 Actions
</div>

Avec les [déclencheurs d’inscription et de connexion](/docs/fr-ca/customize/actions/explore-triggers/signup-and-login-triggers) d’Auth0 Actions, utilisez l’objet `event` pour consigner des événements dans des services tiers ou les transmettre à des API en aval.

Les objets `event` suivants prennent en charge `correlation_id` :

* [Pre-user-registration](/docs/fr-ca/customize/actions/explore-triggers/signup-and-login-triggers/pre-user-registration-trigger/pre-user-registration-event-object)
* [Post-login](/docs/fr-ca/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger/post-login-event-object)
* [Post-challenge](/docs/fr-ca/customize/actions/explore-triggers/password-reset-triggers/post-challenge-trigger/post-challenge-event-object)
* [Post-change-password](/docs/fr-ca/customize/actions/explore-triggers/password-reset-triggers/post-change-password-trigger/post-change-password-event-object)
* [fournisseur de courriel personnalisé](/docs/fr-ca/customize/email/smtp-email-providers/custom/action-triggers-custom-email-provider-event-object)
* [fournisseur de téléphone personnalisé](/docs/fr-ca/customize/phone-messages/configure-phone-messaging-providers/configure-a-custom-phone-provider/actions-triggers-custom-phone-provider-event-object)
* [MFA Notification send-phone-message](/docs/fr-ca/customize/actions/explore-triggers/mfa-notifications-trigger/send-phone-message-event-object)
* [Échange d’identifiants](/docs/fr-ca/customize/actions/explore-triggers/machine-to-machine-trigger/credentials-exchange-event-object)

L’exemple de Post-Login Action montre comment extraire le `correlation_id` de l’objet `event`.

```javascript wrap lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  console.log('PostLogin Action Start');
  const correlation_id = event.transaction?.correlation_id;
  // Vérifier si correlation_id existe
  if (correlation_id) {
    console.log(`Correlation ID found: ${correlation_id}`);
  } else {
    console.log('No correlation_id found in transaction');
  }
  console.log('PostLogin Action End');
};
```

<div id="forms">
  ## Forms
</div>

Vous pouvez utiliser l’ID de corrélation dans Forms et Flows. Forms vous permet de personnaliser l’inscription et la connexion à l’aide de la logique personnalisée que vous créez dans Flows. Pour utiliser l’ID de corrélation dans Forms et Flows, utilisez l’objet `context` dans l’éditeur Flows pour ajouter à votre logique la variable d’événements corrélés `{{context.transaction.correlation_id}}`. Pour en savoir plus, consultez [Variables et fonctions utilitaires](/docs/fr-ca/customize/forms/variables).