> ## 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 l’ID de corrélation pour faire le suivi des événements dans le flux d’authentification.

# Configurer l’ID de corrélation

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Bêta",
    "ea": "Accès anticipé"
  };
  const stageText = stageTextMap[stage] || "une étape du cycle de publication";
  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 {linkify(`${plans} forfaits`, "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="l’assistance Auth0 ou votre gestionnaire de compte technique" />

<Card title="Prérequis">
  Pour utiliser `correlation_id`, vous devez disposer de ce qui suit :

  * **Universal Login d’Auth0 configuré** : l’ID de corrélation est disponible dans les flux Universal Login.
  * **Une application capable de générer des identifiants 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, cette fonctionnalité n’est peut-être pas activée pour votre locataire.
  </Callout>
</Card>

Auth0 permet de retracer les transactions d’authentification au moyen d’un ID de corrélation. Cette capacité de suivi peut réduire le délai de réponse de l’assistance et vous offrir un suivi 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 enregistré automatiquement, ce qui vous permet de suivre et de filtrer les événements dans les [journaux du locataire Auth0](/fr-CA/docs/deploy-monitor/logs).

L’ID de corrélation est conservé lors des événements suivants :

* Inscription
* Connexion
* Inscription à l’authentification multifacteur (MFA) et vérifications
* Réinitialisation du mot de passe

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

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

Les valeurs de `correlation_id` sont soumises aux 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 identifiables (PII)

Passez 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 journaux du locataire contenant l’ID de corrélation, que vous pouvez utiliser pour le 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 d’appel suivant utilise le SDK de la Management API pour récupérer les événements d’authentification les plus récents. Il applique ensuite un filtrage local pour isoler un événement précis :

```javascript wrap lines theme={null}
// 1. Appeler le 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 [modèles de page Universal Login](/fr-CA/docs/customize/login-pages/universal-login/customize-templates), ajoutez `correlation_id` à votre modèle afin de suivre les événements d’authentification dans le cadre d’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 au 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 les [modèles de courriel](/fr-CA/docs/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](/fr-CA/docs/customize/phone-messages/phone-templates) pour suivre les événements d’authentification qui déclenchent des notifications par SMS, comme les demandes 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](/fr-CA/docs/customize/login-pages/custom-error-pages) afin d’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 d’assistance de retracer la transaction ayant échoué.

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 d'aide, mentionnez cet ID : {{correlation_id}}</p>
```

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

Avec les [déclencheurs d’inscription et de connexion](/fr-CA/docs/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` :

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

L’exemple d’Action Post-login 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 l’ouverture de session à l’aide d’une 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 la variable des événements corrélés, `{{context.transaction.correlation_id}}`, à votre logique. Pour en savoir plus, consultez [Variables et fonctions utilitaires](/fr-CA/docs/customize/forms/variables).