Ir al contenido principal

Desajuste de correo electrónico en Google Workspace 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 Google Workspace, el aprovisionamiento automático SCIM y SSO SAML pueden enviar valores de correo electrónico diferentes, especialmente cuando las personas tienen alias de correo electrónico, lo que causa un desajuste que 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. 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 — Claude Code CLI muestra un error de desajuste de correo electrónico durante el flujo de autenticación, impidiendo que la persona se conecte a tu organización.


Cómo sucede esto

Las cuentas de Google Workspace tienen un correo electrónico principal y pueden tener múltiples alias. El aprovisionamiento SCIM y SSO SAML se configuran por separado en la consola de administración de Google y pueden extraer de diferentes campos de dirección:

Atributo de Google

Valor típico

Comúnmente utilizado por

primaryEmail

Recomendado para SCIM y SAML

Alias de correo electrónico

A veces asignado por error en SCIM

Campos de esquema personalizado

Atributos personalizados definidos por organización

Asignaciones de atributos avanzadas

Correo electrónico de unidad organizativa

Variantes de dirección derivadas de OU

Raramente, en estructuras organizativas complejas

El desajuste más común: SCIM está configurado para enviar una dirección de alias mientras que SAML envía el correo electrónico principal (o viceversa). Dado que los alias y los correos electrónicos principales son cadenas diferentes, Claude no puede hacerlos coincidir. Claude requiere una coincidencia exacta de cadena.

Confusión común: En Google Admin, la configuración de aprovisionamiento automático SCIM y la asignación de atributos SAML están en pestañas separadas dentro de la misma aplicación. Los administradores a veces actualizan una y pierden la otra. Verifica ambas ubicaciones.


Pasos de diagnóstico

Paso 1 — Confirmar el desajuste

  1. Verifica el correo electrónico SCIM: En la consola de administración de Google, ve a Aplicaciones → Aplicaciones web y móviles → [Aplicación Claude] → Aprovisionamiento automático. Verifica qué atributo está asignado al campo de correo electrónico que se envía a Claude.

  2. Verifica el correo electrónico SAML: En la misma aplicación, ve a la sección Asignación de atributos SAML. Encuentra el atributo asignado al correo electrónico y anota su origen.

  3. Verifica una persona específica: En Directorio → Usuarios → [Usuario], compara el Correo electrónico principal con cualquier Correo electrónico de alias listado.

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 Name ID en la configuración SAML

  1. En la configuración de la aplicación, ve a SAML → Detalles del proveedor de servicios.

  2. Confirma que Name ID esté configurado en Información básica → Correo electrónico principal.

  3. Si Name ID está configurado en un campo de esquema personalizado o alias, puede enviar un valor diferente al de SCIM.


Resolución

Alinear ambas asignaciones a primaryEmail

El primaryEmail de Google Workspace es la fuente más confiable para SCIM y SAML.

  1. Actualizar aprovisionamiento SCIM: En Aplicaciones → Aplicaciones web y móviles → [Aplicación Claude] → Aprovisionamiento automático → Asignación de atributos, asegúrate de que el atributo de correo electrónico esté asignado a primaryEmail.

  2. Actualizar Name ID de SAML: En SAML → Detalles del proveedor de servicios, configura Name ID en Información básica → Correo electrónico principal.

  3. Actualizar asignación de atributos SAML: En el paso Asignación de atributos, asegúrate de que el atributo de correo electrónico esté asignado a Información básica → Correo electrónico principal.

  4. Guarda todos los cambios.

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. En la consola de administración de Google, ve a la configuración de Aprovisionamiento automático de la aplicación.

  2. Suspende temporalmente el aprovisionamiento y luego vuelve a habilitarlo. Esto activa una sincronización completa de todos los asignados.

  3. Alternativamente, elimina y vuelve a agregar las personas afectadas de la asignación de la aplicación para forzar que sus registros individuales se reaprovisionen.

  4. Monitorea los registros de aprovisionamiento para detectar errores y confirma que los correos electrónicos se actualizaron para coincidir con el formato SAML antes de pedir a las personas que reintentar.


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 organizaciones no estaba restringida antes de la corrección, algunas personas pueden haber creado inadvertidamente cuentas personales gratuitas de Claude. Contacta a nuestro equipo de soporte para que las eliminen.

  • 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. Contacta a nuestro equipo de soporte para desaprovisionar estas.

  • Disponibilidad de asientos: Si las cuentas fantasma están ocupando todos los asientos contratados, los nuevos inicios de sesión fallarán con un error de falta de asientos. Desaprovisionar las cuentas fantasma libera esos asientos.

  • Reagregar personas afectadas: Después de que se eliminen las cuentas fantasma, es posible que las personas con el correo electrónico corregido necesiten ser reinvitadas o reaprovisadas.

  • Prevenir futuras ocurrencias: Habilita «Restringir creación de organizaciones» en la configuración de Identidad y acceso de tu organización. Esto evita que las personas que aún no están aprovisionadas creen accidentalmente cuentas personales gratuitas.


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. Debería aterrizar directamente en el espacio de trabajo de tu organización sin ningún error.

  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 ejecute nuevamente claude auth login --enterprise y confirma que el correo electrónico coincida con su asiento aprovisionado.


Problemas comunes

Problema

Solución

SCIM envía un alias mientras que SAML envía el correo electrónico principal

Siempre usa primaryEmail para ambos.

Name ID en la configuración SAML no fue verificado

El campo Name ID determina el correo electrónico enviado en el inicio de sesión. Esto es independiente de la sección de asignación de atributos. Verifica ambos.

El campo de esquema personalizado está en blanco para algunas personas

Adhiérete a atributos estándar de Google como primaryEmail.

El reaprovisionamiento no se activa automáticamente después del cambio de asignación

Es posible que debas suspender y volver a habilitar manualmente el aprovisionamiento para forzar una sincronización completa.

El correo electrónico principal de alguien cambió pero el correo electrónico anterior sigue apareciendo en Claude

Se necesita una resincronización completa después de cambios en el correo electrónico principal.

Los correos electrónicos se actualizaron 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 al soporte

Contacta a 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?