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 |
|
| Mapeo predeterminado de userName de SCIM; a veces NameID |
| Notificación de correo electrónico SAML/OIDC (recomendado) | |
| 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
Verificar correo electrónico SCIM: Navega a Applications → [Claude App] → Provisioning → To App → Attribute Mappings. Localiza la fila
email(ouserName). La columna Value muestra la expresión de Okta que se envía.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.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.
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
Ve a Directory → People → [User] → Profile.
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.
Actualizar mapeo SCIM: En Provisioning → To App → Attribute Mappings, cambia la fuente de
email(ouserName) auser.email.Actualizar notificación SSO (SAML): En Sign On → SAML Settings → Attribute Statements, cambia el valor del atributo de correo electrónico a user.email.
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.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.
En Provisioning → To App, haz clic en «Force Sync» para activar una reevaluación completa de todos los asignados.
Alternativamente, para personas específicas: Provisioning → Push Users → selecciona personas afectadas → Push Now.
Verifica el registro del sistema de Okta (Reports → System Log) para errores de aprovisionamiento.
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:
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.
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.
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.
Si Claude Code se vio afectado, pide a la persona que reejecutar
claude auth login --enterprisey 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. |
| Cambia ambos a |
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 ( | 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.
