Ir al contenido

Rotar credenciales

Sustituya el secreto de cliente que Identiguard usa para conectarse a Okta o a Entra ID. Los mismos pasos reanudan un monitor que se ha puesto en pausa por sí solo.

  • El rol de administrador en el workspace. Los miembros y los lectores no pueden abrir la página de edición.
  • Acceso de administrador a la plataforma de identidad, para crear el nuevo secreto.
  • Cualquier plan.
  1. Cree el nuevo secreto en la plataforma de identidad. No elimine todavía el antiguo.
    • Okta: abra la integración de Identiguard en la Okta Admin Console y genere un nuevo secreto de cliente.
    • Entra ID: abra el registro de aplicación, vaya a Certificates & secrets y cree un nuevo secreto de cliente. Copie su Value, no el Secret ID. Anote su fecha de caducidad.
  2. En Identiguard, abra Tenants.
  3. En Tenant overview, elija el icono del lápiz (Edit) en la fila del tenant.
  4. Desplácese hasta la tarjeta Credentials. Rotate credentials es el título del formulario que hay dentro.
  5. Pegue el nuevo secreto en Client Secret.
  6. Deje Client ID (optional) en blanco para conservar el ID de cliente actual. Rellénelo solo si el ID de cliente ha cambiado, por ejemplo con un nuevo registro de aplicación.
  7. Elija Validate & save credentials. El botón muestra Validating… mientras Identiguard comprueba el secreto con Okta o con Microsoft.
  8. Confirme la alerta Verified con “Credentials updated and verified against Okta.” (credenciales actualizadas y verificadas con Okta) o “Credentials updated and verified against Microsoft.” (credenciales actualizadas y verificadas con Microsoft).
  9. Elimine el secreto antiguo en la plataforma de identidad.

Identiguard comprueba las nuevas credenciales con la plataforma antes de guardarlas. Si la comprobación falla, verá la alerta Credentials rejected (credenciales rechazadas) con el motivo, el secreto antiguo sigue en su sitio y la monitorización continúa como antes.

Identiguard pone en pausa un monitor de agentes de Okta o la consulta de Entra ID después de 5 comprobaciones fallidas seguidas. Consulte Estado del tenant. Una rotación correcta es la única forma de reanudarlo. No hay un botón de reanudación aparte.

Sabe que un monitor está en pausa cuando ve una de estas señales:

  • El aviso emergente <nombre del tenant> connection unhealthy (conexión no saludable).
  • La alerta Monitoring paused (monitorización en pausa) en la tarjeta Credentials.
  • Para los agentes de Okta, Status: Paused after repeated failures (en pausa tras fallos repetidos) y una casilla bloqueada en Agent Monitoring.
  • Un correo con el asunto Monitoring disabled for <nombre del tenant> (monitorización desactivada para el tenant).

Pasos:

  1. Elija Review settings en el aviso emergente. O abra Tenants y elija el icono del lápiz (Edit) en el tenant.
  2. Desplácese hasta la tarjeta Credentials y confirme la alerta Monitoring paused.
  3. Cree un nuevo secreto en Okta o en Entra ID. Si el secreto sigue siendo válido y el fallo estaba en otra parte, tenga a mano el secreto actual.
  4. Introduzca Client Secret. Introduzca Client ID (optional) solo si ha cambiado.
  5. Elija Validate & save credentials.
  6. Espere a la alerta Verified.

La monitorización se reinicia al momento. La alerta Monitoring paused desaparece, las casillas de los agentes se desbloquean y el estado del monitor dice “Credentials updated. Awaiting next check.” (credenciales actualizadas; a la espera de la siguiente comprobación) hasta que se ejecuta la siguiente comprobación.

Identiguard no guarda ninguna credencial de Auth0. La página de edición de un tenant de Auth0 no tiene tarjeta Credentials, y no hay nada que rotar en el lado de Auth0.

Lo que existe son hasta tres tokens que Auth0 usa para enviar datos a Identiguard. Cada uno se muestra una sola vez, cuando se crea.

Token ¿Puede sustituirlo usted mismo?
Token del log stream No. No se puede volver a emitir. Elimine el tenant y créelo de nuevo.
Token del metric stream No existe ninguna pantalla para esto. Contacte con el equipo de producto.
Token de Action logs No existe ninguna pantalla para esto. Contacte con el equipo de producto.

Sustituir un token de log stream perdido o expuesto

Sección titulada «Sustituir un token de log stream perdido o expuesto»
  1. Abra Tenants y elija el icono del lápiz (Edit) en el tenant de Auth0. Anote el nombre del tenant, el nombre del cliente y los tipos marcados en Event Subscriptions.
  2. Vuelva a Tenants y elimine el tenant con el icono de la papelera (Delete tenant). Consulte Gestionar tenants.
  3. En Create a tenant, elija Connect en la tarjeta Auth0 y cree el tenant de nuevo. Consulte Conectar Auth0.
  4. Copie la nueva Endpoint URL y el nuevo Authorization token (shown once).
  5. En Auth0, edite el log stream existente. Sustituya la URL del payload y el valor de la cabecera Authorization. Con Terraform, aplique de nuevo con los nuevos valores de identiguard.tf y terraform.tfvars.
  6. Si el tenant antiguo tenía un metric stream o Action logs, configúrelos de nuevo. Sus endpoints y tokens también son nuevos.
  • La alerta Verified justo después de guardar.
  • Ningún aviso emergente <nombre del tenant> connection unhealthy después de recargar la aplicación.
  • Para Okta, en Agent Monitoring, un Status: distinto de Paused after repeated failures después de la siguiente comprobación.
  • Para Entra ID, eventos nuevos después de la siguiente consulta.

Los secretos de Entra ID tienen fecha de caducidad. Ponga un recordatorio en el calendario del servicio un mes antes.

Todos estos mensajes aparecen en la alerta Credentials rejected, salvo que se indique otra cosa. Cuando la vea, no se ha guardado nada y el secreto antiguo sigue guardado.

Qué ve Por qué Qué hacer
“Client secret is required.” (el secreto de cliente es obligatorio) Client Secret está en blanco Pegue el secreto.
“Client ID is required.” (el ID de cliente es obligatorio) El tenant de Okta no tiene guardado ningún ID de cliente Introduzca también el ID de cliente en Client ID (optional).
“Okta rejected these credentials: authentication failed. Check the client ID and secret.” (Okta ha rechazado estas credenciales: la autenticación ha fallado; compruebe el ID y el secreto de cliente) Okta ha rechazado el inicio de sesión, o la integración no puede leer los grupos de agentes Compruebe el secreto y el ID de cliente. Compruebe que la integración concede okta.agentPools.read.
“Could not verify these credentials with Okta. Try again shortly.” (no se han podido verificar estas credenciales con Okta; inténtelo de nuevo en unos instantes) Okta no ha respondido Inténtelo de nuevo en unos minutos.
“Microsoft rejected these credentials: <descripción>” o “Microsoft rejected these credentials: Credentials rejected” (Microsoft ha rechazado estas credenciales) Microsoft ha rechazado el inicio de sesión Compruebe que ha pegado el Value del secreto y que no ha caducado. Si el registro de aplicación ha cambiado, introduzca también el nuevo ID de cliente.
“Microsoft tenant configuration is missing the stored client ID; provide a new client ID.” (a la configuración del tenant de Microsoft le falta el ID de cliente guardado; indique un nuevo ID de cliente) o “Failed to read the stored Microsoft client ID; provide a new client ID.” (no se ha podido leer el ID de cliente de Microsoft guardado; indique un nuevo ID de cliente) Identiguard no puede leer el ID de cliente guardado Introduzca también el ID de cliente en Client ID (optional).
“Microsoft tenant configuration is missing the directory tenant ID; recreate the tenant.” (a la configuración del tenant de Microsoft le falta el ID de tenant del directorio; vuelva a crear el tenant) La configuración guardada está dañada Elimine el tenant y créelo de nuevo. Escale al equipo de producto.
“Okta tenant configuration is missing the domain; recreate the tenant.” (a la configuración del tenant de Okta le falta el dominio; vuelva a crear el tenant), “Okta tenant configuration is missing its encryption key; recreate the tenant.” (le falta su clave de cifrado) o “Failed to access the Okta tenant encryption key; recreate the tenant.” (no se ha podido acceder a la clave de cifrado del tenant de Okta) La configuración guardada está dañada Elimine el tenant y créelo de nuevo. Escale al equipo de producto.
“Identiguard stores no Auth0 credentials. Manage the log stream in the Auth0 dashboard or in your Terraform configuration.” (Identiguard no guarda credenciales de Auth0; gestione el log stream en el panel de Auth0 o en su configuración de Terraform) Se ha enviado una rotación para un tenant de Auth0 No hay nada que rotar. Consulte Auth0.
“Forbidden: Insufficient permissions. Admin role required to rotate credentials.” (prohibido: permisos insuficientes; se necesita el rol de administrador para rotar credenciales) Usted no es administrador Pídaselo a un administrador del workspace.
La casilla de Agent Monitoring sigue bloqueada La rotación no se ha completado, o la página no está actualizada Compruebe que aparece la alerta Verified y después recargue la página.
El aviso emergente vuelve después de una rotación correcta Un fallo distinto, como un permiso o una licencia que falta en un flujo de Entra ID Lea el texto del aviso y consulte Estado del tenant.