Ir al contenido

Conectar Auth0

Auth0 envía los eventos a Identiguard mediante un log stream. Primero se crea el tenant en Identiguard y después se crea el stream en Auth0 con el endpoint y el token que Identiguard le facilita.

Identiguard no necesita credenciales de la API de Auth0 y no almacena ninguna. No crea nada en el tenant de Auth0.

Se necesita:

  • Acceso al panel de Auth0 con permiso para crear streams en Monitoring.
  • El rol Admin en el workspace de Identiguard. Los Member y los Viewer ven Only workspace admins can create tenants. (Solo los administradores del workspace pueden crear tenants.) y un botón Admin Access Required deshabilitado.
  • El dominio canónico del tenant, como acme.eu.auth0.com. No use un dominio personalizado.
  • Un hueco de tenant libre en el plan. Consulte el límite de tenants del plan.

Un tenant de Auth0 en Identiguard puede tener hasta tres endpoints independientes. Cada uno tiene su propio token. Cada token se muestra una sola vez.

Token Para qué sirve Cuándo se obtiene Si lo pierde
Token del log stream Eventos de log de Auth0. Todos los tenants de Auth0 tienen uno. En la pantalla que aparece después de crear el tenant No se puede volver a emitir. Elimine el tenant y créelo de nuevo.
Token del metric stream Tráfico de API para la página Métricas de la API de Auth0. Opcional, beta. En la creación, o más adelante desde la página API Metrics No hay ninguna pantalla para emitir uno nuevo. Contacte con el equipo de producto.
Token de Action logs Líneas de log enviadas por sus propias Actions de Auth0. Opcional. Solo en la creación No hay ninguna pantalla para emitir uno nuevo. Contacte con el equipo de producto.
  1. Abra el workspace y vaya a Tenants.
  2. En Create a tenant, busque la tarjeta Auth0 (subtítulo Customer identity) y elija Connect. Se abre la página Add New Auth0 Tenant.
  3. En Setup Method, elija cómo va a crear el log stream:
    • Manual: Identiguard facilita un endpoint de ingesta y un token. Usted crea el log stream en el panel de Auth0.
    • Deploy via Terraform: Identiguard genera una configuración de Terraform que usted mismo aplica.
  4. En Basic Details, rellene los campos de la tabla siguiente.
  5. En Event Subscriptions, revise los tipos de evento. El conjunto recomendado ya está marcado cuando se abre la página.
  6. Solo con Deploy via Terraform: en Obscure Log Stream Data, elija si Auth0 oculta los datos personales. Consulte Ocultar datos personales.
  7. Si lo desea, marque Set up a metric stream now y Set up Action logs now.
  8. Elija Create Auth0 Tenant. El botón muestra Creating… mientras Identiguard trabaja.
Sección Campo Reglas
Setup Method Manual o Deploy via Terraform Manual está seleccionado de forma predeterminada. No se puede cambiar después de la creación.
Basic Details Tenant Name Obligatorio. 100 caracteres como máximo. Sin saltos de línea ni caracteres de control.
Basic Details Customer Name Obligatorio. El campo sugiere nombres de cliente ya usados en el workspace.
Basic Details Auth0 Domain Obligatorio. El dominio canónico del tenant, como acme.eu.auth0.com. Sin ruta, sin espacios, y no un dominio personalizado. No se puede cambiar después de la creación.
Basic Details Environment Obligatorio. Production o Development.
Event Subscriptions Subscribed Event Types Al menos uno. El contador muestra N of M selected.
Obscure Log Stream Data Obfuscation method, Log data to obscure Solo con Terraform. Si elige un método, marque al menos un campo.
Metric stream (distintivo Beta) Set up a metric stream now Opcional. Desactivado de forma predeterminada. El formulario indica Can also be set up later. (También se puede configurar más adelante.)
Metric stream Set up Action logs now Opcional. Desactivado de forma predeterminada. No se puede activar más adelante desde ninguna pantalla.

No hay campos Client ID ni Client Secret para Auth0.

Auth0 publica 185 códigos de evento de log. Cada uno se muestra como una descripción seguida de su código entre corchetes.

  • El conjunto recomendado está marcado cuando se abre la página.
  • Select Recommended sustituye toda su selección por el conjunto recomendado. Deja fuera los códigos de gran volumen y los códigos que Auth0 no documenta.
  • Search event types… filtra la lista por código o por descripción.
  • Select All marca todos los códigos. Mientras busca, pasa a ser Select All Visible.
  • Clear All lo desmarca todo.

La lista controla lo que Identiguard conserva. No configura el stream en Auth0. Con la configuración manual, seleccione usted mismo en el stream de Auth0 las categorías de evento correspondientes.

Después de la creación, el formulario se sustituye por una pantalla de configuración. No se le devuelve a la página Tenants.

La pantalla muestra la alerta Tenant <nombre> created. Next, create the stream(s) in Auth0. (Tenant creado. A continuación, cree los streams en Auth0.) y Copy these values now. They are shown once. (Copie estos valores ahora. Se muestran una sola vez.)

Panel Valores Se muestra cuando
Log stream Endpoint URL, Authorization token (shown once) Siempre
Metric stream (distintivo Beta) OTLP endpoint URL, Bearer token (shown once) Marcó Set up a metric stream now
Action logs Endpoint URL, Token (shown once), el fragmento de código de la Action Marcó Set up Action logs now
identiguard.tf La configuración de Terraform, con Copy configuration El método de configuración es Deploy via Terraform
terraform.tfvars (se muestra una sola vez) El token de ingesta, con Copy ingestion token El método de configuración es Deploy via Terraform

Cada valor tiene un botón Copy. Un aviso emergente lo confirma con “<etiqueta> copied to clipboard” (copiado al portapapeles). Cuando todos los valores estén guardados, elija Back to Tenants.

  1. En Auth0, vaya a Monitoring → Streams → Create Stream y elija Custom Webhook.
  2. Introduzca la Endpoint URL de Identiguard como URL de carga (payload URL).
  3. Introduzca el Authorization token de Identiguard como valor de la cabecera Authorization.
  4. Seleccione las categorías de evento que correspondan a los tipos de evento que marcó en Identiguard.
  5. Guarde el stream.
  1. Copie identiguard.tf con Copy configuration y añádalo a su propio proyecto de Terraform para Auth0.
  2. Copie el valor de terraform.tfvars con Copy ingestion token. El token es una variable de Terraform. No está dentro de identiguard.tf.
  3. Ejecute terraform apply.

Puede volver a ver identiguard.tf más adelante en la página Edit del tenant. El token no se vuelve a mostrar nunca. Consulte Gestionar tenants.

Inicie sesión en cualquier aplicación del tenant y después abra Dashboard en Identiguard. El inicio de sesión aparece en Real-time events en cuestión de segundos.

Auth0 puede ocultar los campos elegidos antes de que los eventos salgan del tenant.

Con Deploy via Terraform, la sección Obscure Log Stream Data aparece en el formulario de creación. No aparece con Manual.

  1. Elija un Obfuscation method:
    • None - stream in clear text
    • XXHash - replace with a unique string (Recommended by Auth0)
    • Mask - replace with *****
  2. Si eligió XXHash o Mask, marque los campos en Log data to obscure: First name, Last name, Username, Email, Phone, Address. Select all y Clear all marcan o desmarcan los seis. Marque al menos uno.

Elija XXHash en lugar de Mask si todavía quiere correlacionar los eventos del mismo usuario (oculto). La elección se escribe en la configuración de Terraform generada.

Con la configuración Manual, defina Obscure log stream data en el stream, en el panel de Auth0.

Un metric stream añade el tráfico de API a la página API Metrics del tenant y a la tarjeta Auth0 API metrics del Dashboard. Necesita un plan de Auth0 compatible con Metric Streams, que normalmente es Enterprise. El proveedor de Terraform de Auth0 no admite metric streams, así que este stream siempre se crea a mano.

En un tenant nuevo:

  1. En el formulario de creación, marque Set up a metric stream now.
  2. Después de la creación, copie la OTLP endpoint URL y el Bearer token (shown once) del panel Metric stream.
  3. En Auth0, vaya a Monitoring → Streams → Create Stream y elija Metric Stream de tipo HTTP.
  4. Introduzca la URL del endpoint OTLP.
  5. Elija Bearer Token como método de autenticación y pegue el token. Pegue solo el token. Auth0 añade por sí mismo la palabra Bearer.

En un tenant existente, la configuración está en la página API Metrics, no en la página Edit. Consulte Métricas de la API de Auth0.

No hay ninguna pantalla para desactivar un metric stream ni para emitir un token nuevo.

Las líneas de log de sus propias Actions de Auth0 pueden llegar a Identiguard. Cada línea se convierte en un evento.

  1. En el formulario de creación, marque Set up Action logs now.
  2. Después de la creación, copie la Endpoint URL, el Token (shown once) y el Action snippet del panel Action logs.
  3. En Auth0, vaya a Actions → Library y abra la Action desde la que quiere registrar.
  4. Añada el token como un secreto llamado IDENTIGUARD_TOKEN.
  5. Añada el fragmento de código a la Action y llámelo donde quiera una línea de log.

Lo que conviene saber antes de usarlo:

  • Niveles. Una línea enviada con el nivel error abre un incidente en Identiguard, así que reserve error para los fallos reales. Las líneas con el nivel info no se aceptan hasta que ese nivel se active, y no hay ninguna pantalla para ello.
  • Datos personales. La pantalla de configuración indica: “Identiguard stores whatever your Action sends. Auth0’s “Obscure log stream data” setting does not apply to this endpoint, and Identiguard cannot mask or filter these lines. It is the integrator’s responsibility to ensure no personal data is placed in the message or data fields.” (Identiguard almacena todo lo que envía su Action. El ajuste “Obscure log stream data” de Auth0 no se aplica a este endpoint, e Identiguard no puede enmascarar ni filtrar estas líneas. Es responsabilidad del integrador asegurarse de que no se incluyan datos personales en los campos message o data.) Asegúrese de que la persona que escribe la Action lo sabe.
  • La entrega no está garantizada. Los inicios de sesión nunca esperan a Identiguard. Una línea que todavía se está enviando cuando la Action termina se pierde.

Un tenant de Auth0 solo se puede usar en un periodo de prueba de Identiguard. Si el tenant ya se usó en otro periodo de prueba, Identiguard lo crea igualmente, pero no acepta sus eventos. La página Tenants muestra entonces el banner Some tenants are not being monitored on this trial (Algunos tenants no se están supervisando en este periodo de prueba) con el nombre del tenant. Consulte Estado de los tenants.

Los errores de campo se muestran en rojo debajo del campo. Los demás errores se muestran como un aviso emergente rojo. Un aviso que empieza por Failed to create tenant: (No se ha podido crear el tenant) procede del servidor.

Qué ve Por qué Qué hacer
“Only workspace admins can create tenants.” y un botón Admin Access Required deshabilitado Su rol es Member o Viewer Pida a un Admin del workspace que cree el tenant.
“Tenant name cannot be empty” (El nombre del tenant no puede estar vacío), “Tenant name must be 100 characters or fewer” (El nombre del tenant debe tener 100 caracteres como máximo) o “Tenant name cannot contain line breaks or control characters” (El nombre del tenant no puede contener saltos de línea ni caracteres de control) El nombre del tenant incumple una regla Corrija el nombre.
“Customer name is required” (El nombre del cliente es obligatorio) Customer Name está en blanco Introduzca el cliente.
“Auth0 domain is required” (El dominio de Auth0 es obligatorio) Auth0 Domain está en blanco Introduzca el dominio canónico.
“Enter the canonical Auth0 tenant domain (e.g., acme.eu.auth0.com)” (Introduzca el dominio canónico del tenant de Auth0) El dominio tiene una ruta o un espacio, o no es un dominio Introduzca solo el dominio canónico, no un dominio personalizado ni una URL.
“Environment is required” (El entorno es obligatorio) No se ha elegido ningún entorno Elija Production o Development.
“At least one event type must be selected” (Debe seleccionarse al menos un tipo de evento) No hay nada marcado Marque al menos un tipo, o elija Select Recommended.
“Invalid event type submitted” (Se ha enviado un tipo de evento no válido) La página envió un código que no está en la lista permitida Recargue la página y seleccione de nuevo.
“Select at least one field to obscure, or choose None” (Seleccione al menos un campo que ocultar, o elija None) Configuración con Terraform. Eligió XXHash o Mask pero no marcó ningún campo. Marque al menos un campo, o elija None - stream in clear text.
Qué ve Por qué Qué hacer
“Failed to create tenant: The <Plan> plan allows up to N tenants per workspace, and this workspace already has M. Upgrade the plan to add more.” (No se ha podido crear el tenant: el plan permite hasta N tenants por workspace, y este workspace ya tiene M. Suba de plan para añadir más.) El workspace ha llegado al límite de tenants de su plan Elimine un tenant que ya no necesite, o suba de plan. Consulte Planes y facturación.
“The tenant was created, but no ingestion endpoint was returned. Delete the tenant and try again.” (El tenant se ha creado, pero no se ha devuelto ningún endpoint de ingesta. Elimine el tenant e inténtelo de nuevo.) El tenant se guardó, pero falta su endpoint o su token Elimine ese tenant en la página Tenants y créelo de nuevo.
“Failed to create tenant: Failed to store Auth0 tenant.” (No se ha podido almacenar el tenant de Auth0.) No se ha podido guardar el tenant Inténtelo de nuevo. Escale si se repite.
“Forbidden: You do not have permission to create tenants.” (Prohibido: no tiene permiso para crear tenants.) Su rol cambió mientras la página estaba abierta Pregunte a un Admin del workspace.
“Failed to create tenant: Bad Request” (Solicitud incorrecta) El servidor rechazó el formulario Revise de nuevo todos los campos. Escale si continúa.
“Failed to create tenant: API error” (Error de API) o “An unexpected error occurred: …” (Se ha producido un error inesperado) Un error inesperado Inténtelo de nuevo y después escale al equipo de producto.
“Failed to create tenant: Server configuration error…” (Error de configuración del servidor) Un problema de la plataforma Escale a un operador de la plataforma.
“Could not copy; select the text and copy it manually.” (No se ha podido copiar. Seleccione el texto y cópielo manualmente.) El navegador bloqueó el acceso al portapapeles Seleccione el valor con el ratón y cópielo a mano.
Qué ve Por qué Qué hacer
No hay eventos después de crear el stream, y no hay ningún mensaje El token se pegó mal, el stream está en pausa en Auth0, o el evento es de un tipo que no está marcado en Identiguard En Auth0, compruebe el estado del stream y su valor de Authorization. En Identiguard, compruebe los tipos marcados en Event Subscriptions.
Ha perdido el token del log stream El token se muestra una sola vez y no se puede volver a emitir Elimine el tenant y créelo de nuevo. Consulte Rotar credenciales.
Banner Some tenants are not being monitored on this trial Este tenant de Auth0 ya se usó en otro periodo de prueba de Identiguard. Sus eventos no se aceptan. Elija Go to the Billing page y elija un plan, o contacte con el soporte de Identiguard.
API Metrics muestra Stale o “nothing received yet” (todavía no se ha recibido nada) El metric stream no está entregando datos Consulte Métricas de la API de Auth0.
Las líneas de una Action no llegan El secreto IDENTIGUARD_TOKEN falta o es incorrecto, la línea tiene el nivel info, o la línea se perdió cuando la Action terminó Compruebe el secreto en la Action. Envíe una línea de prueba con el nivel warn.
Siguen apareciendo eventos como fallos en el estado del stream de Auth0 después de eliminar el tenant El stream de Auth0 sigue apuntando a un endpoint revocado Elimine el stream en Auth0, o ejecute terraform destroy.