Ir al contenido principal

Desajuste de correo electrónico en Ping Identity SSO/SCIM

Claude utiliza el correo electrónico como identificador principal para hacer coincidir los inicios de sesión SSO con los asientos aprovisionados. Los productos de Ping Identity (PingOne y PingFederate) tienen una configuración de atributos flexible y en capas. Cuando el aprovisionamiento SCIM y SSO/OIDC extraen de diferentes atributos de usuario, un desajuste bloquea el acceso.

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 persona se autentica a través de SSO pero Claude no puede encontrar una cuenta aprovisionada coincidente.

  • Aterrizaje en una cuenta personal gratuita — Si la creación de organización no está restringida, la persona omite tu organización por completo.

  • «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 productos de Ping Identity permiten asignación de atributos granular en múltiples niveles (directorio, adaptador IdP, conector SP, aplicación). SCIM y SSO pueden recorrer diferentes rutas a través de estas capas, lo que resulta en diferentes valores de correo electrónico que llegan a Claude:

Atributo de Ping

Valor típico

Comúnmente utilizado por

email (PingOne)

Recomendado para SCIM y SAML/OIDC

username (PingOne)

testuser1 o [email protected]

Identificador de inicio de sesión predeterminado; puede diferir del correo electrónico

Atributo del adaptador IdP (PingFederate)

Varía según el tipo de adaptador (LDAP, formulario HTML, etc.)

Fuentes de identidad de PingFederate

Atributo LDAP mail

Correo electrónico de origen de directorio en PingFederate

LDAP sAMAccountName o uid

Puede ser ID de empleado o nombre de usuario corto

A veces asignado al correo electrónico por error

Atributos de población personalizados

Campos personalizados definidos por entorno

Configuraciones avanzadas de PingOne

Claude requiere una coincidencia exacta de cadena entre el correo electrónico aprovisionado por SCIM y el correo electrónico afirmado por SSO.

Nota de PingFederate: El sistema de contrato de atributos de PingFederate es especialmente complejo—el correo electrónico puede pasar por múltiples capas (LDAP → adaptador IdP → contrato de adaptador → conector SP → aserción). Un desajuste en cualquier capa hará que el valor incorrecto llegue a Claude. Rastrea el valor de extremo a extremo.


Pasos de diagnóstico

Paso 1 — Confirmar el desajuste (PingOne)

  1. Verificar asignación de atributos SCIM: En PingOne Admin, ve a Conexiones → Aplicaciones → [Aplicación Claude] → Asignaciones de atributos. Encuentra el atributo asignado a emails[primary].value o email. Anota el atributo de usuario de PingOne utilizado como fuente.

  2. Verificar asignación de atributos SSO: En la misma aplicación, ve a la pestaña SAML u OIDC y encuentra el atributo o reclamación asignado al correo electrónico. Anota su atributo de fuente.

  3. Si SCIM y SSO hacen referencia a diferentes atributos de PingOne, has confirmado el desajuste.

Paso 1 (alternativo) — Confirmar el desajuste (PingFederate)

  1. En la consola de administración de PingFederate, localiza la Conexión SP para Claude.

  2. En Cumplimiento del contrato de atributos, encuentra el atributo de correo electrónico y rastrea su fuente de vuelta al adaptador IdP o almacén de datos LDAP.

  3. Por separado, verifica el conector de aprovisionamiento SCIM o el canal de aprovisionamiento saliente para Claude y rastrea la fuente del atributo de correo electrónico que se envía.

  4. Si los dos rastros conducen a diferentes atributos de directorio, has confirmado el desajuste.

Paso 2 — Identificar el alcance del problema

  • Si la mayoría o todas las personas aprovisionadas comparten el mismo desajuste de formato de correo electrónico, este es un problema de asignación de atributos sistémico. La solución está en la asignación de atributos SCIM de tu IdP.

  • Si solo una o dos personas se ven afectadas, el problema probablemente sea específico de esas cuentas. Verifica su perfil directamente.

Paso 3 — Verificar valores de atributos para una persona específica

  1. PingOne: Ve a Identidades → Usuarios → [Usuario] y compara los valores de los campos Nombre de usuario y Correo electrónico.

  2. PingFederate con LDAP: Verifica el registro LDAP de la persona y compara mail, userPrincipalName, sAMAccountName y cualquier otro atributo que se utilice en la asignación de tu adaptador.


Resolución

PingOne — Alinear ambas asignaciones al atributo de correo electrónico

  1. En Conexiones → Aplicaciones → [Aplicación Claude], abre Asignaciones de atributos.

  2. Para SCIM: Asegúrate de que emails[primary].value se asigne al atributo Dirección de correo electrónico de PingOne.

  3. Para SAML/OIDC: Asegúrate de que el atributo o reclamación de correo electrónico también se asigne al atributo Dirección de correo electrónico de PingOne.

  4. Guarda los cambios.

PingFederate — Alinear contrato de atributos en todas las capas

  1. En la Conexión SP para Claude, ve a Cumplimiento del contrato de atributos.

  2. Encuentra el atributo de correo electrónico. Asegúrate de que su fuente sea el mismo atributo LDAP o almacén de datos utilizado en tu canal de aprovisionamiento saliente SCIM.

  3. Si utilizas un adaptador IdP personalizado, asegúrate de que el contrato del adaptador incluya el atributo de correo electrónico canónico y que esté correctamente asignado a través de la conexión SP.

  4. Actualiza el aprovisionamiento SCIM para utilizar el mismo atributo de fuente.

Activar una resincronización completa

Crítico — Se requiere sincronización completa: Una sincronización incremental no actualizará los registros existentes después de cambiar una asignación de atributos. Debes activar un reinicio completo del ciclo de aprovisionamiento.

  1. PingOne: En la configuración de aprovisionamiento de la aplicación, activa un ciclo de aprovisionamiento completo. Es posible que debas desactivar y reactivar el aprovisionamiento para forzar un re-envío completo.

  2. PingFederate: Activa una sincronización completa en tu canal de aprovisionamiento saliente. Verifica tus registros de aprovisionamiento para confirmar que se están enviando los valores de correo electrónico actualizados.

  3. Verifica que los valores de correo electrónico actualizados aparezcan en los registros de aprovisionamiento antes de pedir a las personas que reintentar el inicio de sesión.


Limpieza posterior a la corrección

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

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

  • Cuentas fantasma (asientos con correo electrónico incorrecto): Contacta con nuestro equipo de soporte para desaprovisionarlas.

  • Disponibilidad de asientos: Si las cuentas fantasma ocupan todos los asientos contratados, los nuevos inicios de sesión fallarán. Contacta con nuestro equipo de soporte.

  • Re-agregar personas afectadas: Después de que se eliminen las cuentas fantasma, es posible que las personas deban ser re-invitadas o re-aprovisionadas.

  • Prevenir futuras ocurrencias: Habilita «Restringir creación de organización» en la configuración de Identidad y acceso de tu organización.


Verificación

  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 y luego inicie sesión a través de SSO.

  3. Confirma que las personas no están creando cuentas gratuitas.

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


Problemas comunes

Problema

Solución

Campo username de PingOne utilizado en lugar de email

Cambia la asignación SCIM al atributo Dirección de correo electrónico de PingOne.

Desajuste de atributos de PingFederate en capas de contrato

Rastrea el atributo de correo electrónico de extremo a extremo: fuente LDAP → adaptador IdP → contrato de adaptador → conector SP → aserción.

LDAP sAMAccountName o uid asignado como fuente de correo electrónico

Utiliza el atributo LDAP mail en su lugar.

La sincronización de aprovisionamiento incremental no actualiza los registros existentes

Se requiere una resincronización completa después de cambiar las asignaciones de atributos.

Contrato de atributos actualizado en PingFederate pero conector SCIM no actualizado

Tanto la conexión SP como el canal de aprovisionamiento SCIM saliente deben actualizarse de forma independiente.

Correos electrónicos actualizados en SCIM pero la persona aún no puede iniciar sesión

Verifica si hay organizaciones gratuitas no autorizadas o cuentas fantasma. Borra las cookies del navegador e intenta de nuevo.


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 tus asignaciones 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 tener asientos contratados disponibles.

¿Ha quedado contestada tu pregunta?