> ## 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.

> Aprenda a usar el ID de correlación para hacer el seguimiento de eventos en el flujo de autenticación.

# Configurar el ID de correlación

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "Acceso anticipado"
  };
  const stageText = stageTextMap[stage] || "una etapa de lanzamiento del producto";
  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 && <>Esta funcionalidad está disponible en los {linkify(`planes ${plans}`, "https://auth0.com/pricing")}. </>}
            {contact && "Para participar, ponte en contacto con " + contact + ". "}
            {terms && <>Al usar esta funcionalidad, aceptas los términos aplicables de la prueba gratuita incluidos en el {linkify("Master Subscription Agreement", "https://www.okta.com/legal")} de Okta.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>La funcionalidad {feature} está en {linkify(stageText, prsLink)}.</strong>
            </span>

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

<ReleaseStageNotice feature="ID de correlación" stage="ea" terms="true" contact="Soporte de Auth0 o su gerente técnico de cuentas" />

<Card title="Prerrequisitos">
  Para usar `correlation_id`, debe contar con lo siguiente:

  * **Universal Login de Auth0 configurado**: El ID de correlación está disponible en los flujos de Universal Login.
  * **Una aplicación capaz de generar ID únicos**: Su aplicación debe poder generar UUID o ID de transacción. (Ejemplo: `txn_12345_xyz`, ID de sesión o ID de pedido)

  <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
    Si `correlation_id` no está disponible en sus solicitudes de autorización, es posible que esta función no esté habilitada en su inquilino.
  </Callout>
</Card>

Auth0 permite rastrear transacciones de autenticación mediante el ID de correlación. Esta capacidad de seguimiento puede reducir el tiempo de respuesta del soporte y proporcionarle trazabilidad entre varios sistemas después de los eventos de autenticación.

El parámetro `correlation_id` agrega a la URL de autorización un identificador único generado por su aplicación. Este ID se registra automáticamente, lo que le permite rastrear y filtrar eventos en los [registros del inquilino de Auth0](/es/docs/deploy-monitor/logs).

El ID de correlación se conserva en los siguientes eventos:

* Registro
* Inicio de sesión
* Inscripción en la autenticación multifactor (MFA) y desafíos
* Restablecimiento de contraseña

Puede usar el ID de correlación con Universal Login, las plantillas de página de Universal Login, las plantillas de correo electrónico, las plantillas de SMS, las páginas de error personalizadas, Flows y Auth0 Actions.

<div id="configure-correlation-id">
  ## Configurar el ID de correlación
</div>

Los valores de `correlation_id` tienen las siguientes limitaciones:

* **Caracteres permitidos**: caracteres alfanuméricos y caracteres especiales que coincidan con `/^[-\w.*~@+/:]{1,64}$/`.
* **Longitud máxima**: 64 caracteres
* **No debe** contener ninguna información de identificación personal (PII)

Pase el parámetro `correlation_id` en el objeto `authorizationParams` para añadir el ID único a la URL de autorización, como en el siguiente ejemplo:

```javascript wrap lines theme={null}
const { loginWithRedirect } = useAuth0();
loginWithRedirect({
  authorizationParams: {
    // Agrega "&correlation_id=..." a la URL para rastreo
    correlation_id: "YOUR_CORRELATION_ID"
  }
});
```

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

Todos los flujos de Universal Login admiten `correlation_id`. Una vez que pases el valor del ID de correlación al endpoint `/authorize`, los eventos de autenticación generan registros del inquilino con ese ID de correlación, que puedes usar para hacer seguimiento. Usa el SDK de Management API para recuperar y filtrar eventos recientes a fin de aislar una transacción específica.

La siguiente llamada de ejemplo usa el SDK de Management API para recuperar los eventos de autenticación más recientes. Luego, los filtra localmente para aislar un evento específico:

```javascript wrap lines theme={null}
// 1. Llamar a la Management API (sintaxis de SDK v5)
const { data: logs } = await management.logs.list({
  per_page: 100,
  sort: 'date:-1'
});
// 2. Filtrar el array en el lado del cliente para encontrar tu 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">
  ### Plantilla de la página de inicio de sesión
</div>

Si personaliza la experiencia de inicio de sesión con [plantillas de página de Universal Login](/es/docs/customize/login-pages/universal-login/customize-templates), agregue `correlation_id` a su plantilla para rastrear eventos de autenticación con un inicio de sesión personalizado.

El siguiente ejemplo muestra `correlationId: "{{correlation_id}}"` agregado a `{%- auth0:widget -%}`.

```html wrap lines theme={null}
<!-- Ejemplo: Inyectar el ID en un script del lado del cliente -->
<!-- Nota: {{ }} es sintaxis de plantilla Liquid evaluada en el servidor por Auth0, no son marcadores de posición de documentación -->
<script>
  window.addEventListener("load", function () {
    const loginContext = {
      application: "{{application.name}}",
      // Accede al correlation_id directamente mediante sintaxis Liquid
      correlationId: "{{correlation_id}}"
    };

    console.log("Tracking Context:", loginContext);
    // Ahora puedes pasar loginContext.correlationId a tu herramienta de análisis
  });
</script>
```

<div id="email-templates">
  ## Plantillas de correo electrónico
</div>

Puede incluir `correlation_id` en [Plantillas de correo electrónico](/es/docs/customize/email/email-templates/customize-email-templates) para ayudar a rastrear los eventos de autenticación que desencadenan notificaciones por correo electrónico, como restablecimientos de contraseña o correos electrónicos de verificación.

El siguiente ejemplo muestra `{{correlation_id}}` agregado al cuerpo de una plantilla de correo electrónico.

```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">
  ## Plantillas de SMS
</div>

Puede incluir `correlation_id` en [Plantillas de SMS](/es/docs/customize/phone-messages/phone-templates) para rastrear los eventos de autenticación que desencadenan notificaciones por SMS, como los desafíos de MFA.

En el siguiente ejemplo, se muestra `{{correlation_id}}` agregado a una plantilla de SMS.

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

<div id="custom-error-pages">
  ## Páginas de error personalizadas
</div>

Puede incluir `correlation_id` en [Páginas de error personalizadas](/es/docs/customize/login-pages/custom-error-pages) para mostrar la referencia de seguimiento directamente en las páginas de error, lo que facilita a los usuarios informar problemas y a su equipo de soporte rastrear la transacción fallida.

El siguiente ejemplo muestra `{{correlation_id}}` añadido a una plantilla de página de error personalizada.

```liquid wrap lines theme={null}
<h1>{{error | escape}}: {{error_description | escape}}</h1>
<p>Si necesita asistencia, haga referencia a este ID: {{correlation_id}}</p>
```

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

En [Signup and Login Triggers](/es/docs/customize/actions/explore-triggers/signup-and-login-triggers) de Auth0 Actions, use el objeto `event` para registrar eventos en servicios de terceros o enviarlos a API de destino.

Los siguientes objetos de evento admiten `correlation_id`:

* [Pre-user-registration](/es/docs/customize/actions/explore-triggers/signup-and-login-triggers/pre-user-registration-trigger/pre-user-registration-event-object)
* [Post-login](/es/docs/customize/actions/explore-triggers/signup-and-login-triggers/login-trigger/post-login-event-object)
* [Post-challenge](/es/docs/customize/actions/explore-triggers/password-reset-triggers/post-challenge-trigger/post-challenge-event-object)
* [Post-change-password](/es/docs/customize/actions/explore-triggers/password-reset-triggers/post-change-password-trigger/post-change-password-event-object)
* [Proveedor de correo electrónico personalizado](/es/docs/customize/email/smtp-email-providers/custom/action-triggers-custom-email-provider-event-object)
* [Proveedor de teléfono personalizado](/es/docs/customize/phone-messages/configure-phone-messaging-providers/configure-a-custom-phone-provider/actions-triggers-custom-phone-provider-event-object)
* [MFA Notification send-phone-message](/es/docs/customize/actions/explore-triggers/mfa-notifications-trigger/send-phone-message-event-object)
* [Credential Exchange](/es/docs/customize/actions/explore-triggers/machine-to-machine-trigger/credentials-exchange-event-object)

La Action de ejemplo Post-Login muestra cómo extraer `correlation_id` del objeto `event`.

```javascript wrap lines theme={null}
exports.onExecutePostLogin = async (event, api) => {
  console.log('PostLogin Action Start');
  const correlation_id = event.transaction?.correlation_id;
  // Verificar si existe correlation_id
  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">
  ## Formularios
</div>

Puede usar ID de correlación en Formularios y Flows. Formularios le permite personalizar el registro y el inicio de sesión con lógica personalizada que cree en Flows. Para usar ID de correlación en Formularios y Flows, use el objeto `context` en el editor de Flows para agregar la variable de eventos correlacionados `{{context.transaction.correlation_id}}` a su lógica. Para obtener más información, consulte [Variables and helper functions](/es/docs/customize/forms/variables).