Ir al contenido principal

Desajuste de correo electrónico en Okta SSO/SCIM

Claude utiliza el correo electrónico como identificador principal para hacer coincidir los inicios de sesión SSO con los asientos aprovisionados. En Okta, el aprovisionamiento SCIM y SSO se configuran por separado y pueden extraer el correo electrónico de diferentes campos de perfil de usuario. Esta guía explica cómo identificar y resolver el desajuste.

Se aplica a: Planes Enterprise y organizaciones de Console que utilizan aprovisionamiento SCIM. Los planes Team no tienen aprovisionamiento SCIM, por lo que este escenario de desajuste no se aplica—consulta Configurar aprovisionamiento JIT o SCIM para ver qué está disponible en cada plan.


Síntomas

Las personas pueden experimentar uno o más de los siguientes al intentar acceder a tu organización a través de SSO:

  • «La creación de cuenta está bloqueada» — La autenticación SSO se realiza correctamente pero Claude no puede localizar una cuenta aprovisionada coincidente. Si tu organización tiene restringida la creación de organizaciones (recomendado), la persona está completamente bloqueada.

  • Aterrizaje en una cuenta personal gratuita — Si la creación de organizaciones no está restringida, la persona omite tu organización por completo y crea o aterriza en una cuenta personal gratuita en lugar de su asiento aprovisionado.

  • «Verifica en qué cuenta has iniciado sesión» desajuste — La devolución de llamada SSO muestra un correo electrónico diferente al que la persona ingresó en el inicio de sesión.

  • Error de autenticación de Claude Code — La CLI de Claude Code muestra un error de desajuste de correo electrónico durante el flujo de autenticación.


Cómo sucede esto

Los perfiles de usuario de Okta contienen múltiples campos que representan la identidad. El aprovisionamiento SCIM (en Provisioning → To App) y SSO SAML/OIDC (en Sign On) se configuran de forma independiente.

Atributo de Okta

Valor típico

Comúnmente utilizado por

user.login

testuser1 o [email protected]

Mapeo predeterminado de userName de SCIM; a veces NameID

user.email

Notificación de correo electrónico SAML/OIDC (recomendado)

appuser.email

Anulación a nivel de aplicación del correo electrónico del usuario

Mapeo de atributos personalizado a nivel de aplicación

Un desajuste común: SCIM utiliza user.login mientras que SAML envía user.email. Claude requiere una coincidencia exacta de cadena.

Confusión común: Los mapeos de atributos SCIM de Okta y las declaraciones de atributos SAML se encuentran en dos pestañas diferentes — Provisioning → To App para SCIM, y Sign On para SSO.


Pasos de diagnóstico

Paso 1 — Confirmar el desajuste

  1. Verificar correo electrónico SCIM: Navega a Applications → [Claude App] → Provisioning → To App → Attribute Mappings. Localiza la fila email (o userName). La columna Value muestra la expresión de Okta que se envía.

  2. Verificar correo electrónico SSO (SAML): Ve a Applications → [Claude App] → Sign On → SAML Settings → Edit → Attribute Statements. Encuentra el atributo email. La columna Value indica qué campo de Okta se afirma.

  3. Verificar correo electrónico SSO (OIDC): Ve a Applications → [Claude App] → Sign On → OpenID Connect ID Token y revisa la sección Claims para correo electrónico.

  4. Si los valores de SCIM y SSO hacen referencia a diferentes campos de Okta, el desajuste se confirma.

Paso 2 — Identificar el alcance del problema

  • La mayoría o todas las personas aprovisionadas afectadas: Este es un problema de mapeo de atributos sistémico. La solución está en el mapeo de atributos SCIM de tu IdP.

  • Una o dos personas afectadas: El problema es específico de esas cuentas. Verifica su perfil de usuario directamente.

Paso 3 — Verificar perfiles de usuario de Okta directamente

  1. Ve a Directory → People → [User] → Profile.

  2. Compara los valores de los campos Login y Email. Las diferencias entre estos campos producirán desajustes de mapeo.


Resolución

Alinear ambos mapeos al mismo campo de Okta

La solución más segura es utilizar user.email tanto para SCIM como para SSO, ya que este campo contiene la dirección de correo electrónico canónica en Okta.

  1. Actualizar mapeo SCIM: En Provisioning → To App → Attribute Mappings, cambia la fuente de email (o userName) a user.email.

  2. Actualizar notificación SSO (SAML): En Sign On → SAML Settings → Attribute Statements, cambia el valor del atributo de correo electrónico a user.email.

  3. Actualizar notificación SSO (OIDC): En Sign On → OpenID Connect ID Token → Claims, actualiza la notificación de correo electrónico para que se asigne a user.email.

  4. Haz clic en «Guardar.»

Forzar una resincronización completa

Crítico — Se requiere sincronización completa: Una sincronización incremental no actualizará los registros existentes después de cambiar un mapeo de atributos.

  1. En Provisioning → To App, haz clic en «Force Sync» para activar una reevaluación completa de todos los asignados.

  2. Alternativamente, para personas específicas: Provisioning → Push Users → selecciona personas afectadas → Push Now.

  3. Verifica el registro del sistema de Okta (Reports → System Log) para errores de aprovisionamiento.

  4. Verifica que los valores de correo electrónico actualizados aparezcan en los registros de aprovisionamiento antes de que las personas reintenten el inicio de sesión.


Limpieza posterior a la corrección

Después de corregir el mapeo de atributos y completar la sincronización completa:

  • Cuentas gratuitas no autorizadas: Si la creación de organizaciones no estaba restringida antes de la corrección, algunas personas pueden haber creado cuentas personales gratuitas de Claude. Contacta con nuestro equipo de soporte para su eliminación.

  • Cuentas fantasma (asientos con correo electrónico incorrecto): Las cuentas aprovisionadas originalmente con el correo electrónico incorrecto pueden seguir existiendo en tu organización, ocupando asientos que nunca se pueden usar. Contacta con nuestro equipo de soporte para desaprovisionamiento.

  • Disponibilidad de asientos: Si las cuentas fantasma ocupan todos los asientos contratados, los nuevos inicios de sesión fallarán con un error de falta de asientos incluso después de que se corrija el mapeo.

  • Readición de personas afectadas: Después de la eliminación de cuentas fantasma, las personas con el correo electrónico corregido pueden necesitar ser reinvitadas o reaprovisionadas.

  • Prevenir ocurrencias futuras: Habilita «Restringir creación de organizaciones» en la configuración de Identidad y acceso de tu organización para evitar que personas no aprovisionadas creen cuentas gratuitas.


Verificación

Después de completar la corrección y cualquier limpieza:

  1. Verifica una muestra de personas aprovisionadas—confirma que su correo electrónico en el registro de aprovisionamiento coincida con el formato de correo electrónico que envía SSO.

  2. Pide a una persona afectada que borre las cookies del navegador para claude.ai, luego inicia sesión a través de SSO. Debería aterrizar directamente en el espacio de trabajo de tu organización sin errores.

  3. Confirma que las personas no están creando cuentas gratuitas—con la creación de organizaciones restringida, las personas bloqueadas ven un error claro en lugar de aterrizar en una cuenta personal.

  4. Si Claude Code se vio afectado, pide a la persona que reejecutar claude auth login --enterprise y confirma que el correo electrónico coincida con su asiento aprovisionado.


Problemas comunes

Problema

Solución

El administrador actualiza las notificaciones SAML pero olvida los mapeos de atributos SCIM (o viceversa)

Ambos deben actualizarse. Mapeos SCIM en Provisioning → To App; notificaciones SAML en Sign On → SAML Settings.

user.login contiene un nombre de usuario (no correo electrónico) para algunas personas

Cambia ambos a user.email y verifica que los campos de correo electrónico estén completos para todos.

La sincronización incremental se ejecuta pero los correos electrónicos no se actualizan

Force Sync o Push Users es necesario después de un cambio de mapeo de atributos.

El atributo de perfil a nivel de aplicación (appuser.email) difiere del perfil de usuario (user.email)

Verifica si los mapeos de atributos a nivel de aplicación anulan los valores del perfil de usuario.

Los correos electrónicos se actualizaron pero la persona aún no puede iniciar sesión

Busca organizaciones gratuitas no autorizadas o cuentas fantasma. Borra las cookies del navegador e intenta de nuevo. Contacta con soporte si persiste.

Las aplicaciones OIDC y SAML son aplicaciones Okta separadas para Claude

Algunas organizaciones configuran ambas. Asegúrate de la alineación de atributos en ambas aplicaciones.


Cuándo contactar con soporte

Contacta con nuestro equipo de soporte con el dominio de tu organización, el correo electrónico de la persona afectada y capturas de pantalla de mapeo de atributos cuando:

  • Los atributos SCIM y SSO parecen idénticos pero las personas aún no pueden acceder a sus asientos.

  • Necesitas confirmación del correo electrónico que Claude registró durante el aprovisionamiento SCIM para personas específicas.

  • Necesitas ayuda para limpiar cuentas fantasma u organizaciones gratuitas no autorizadas.

  • Las personas están recibiendo un error de falta de asientos a pesar de los asientos contratados disponibles.

¿Ha quedado contestada tu pregunta?