Ir para conteúdo principal

Incompatibilidade de email OneLogin SSO/SCIM

Claude usa o email como identificador principal para corresponder logins SSO a assentos provisionados. No OneLogin, o provisionamento SCIM e o SSO SAML são configurados em abas separadas do aplicativo e podem referenciar campos de perfil de usuário diferentes, causando uma incompatibilidade que bloqueia o acesso.

Aplica-se a: Planos Enterprise e organizações Console usando provisionamento SCIM. Planos Team não possuem provisionamento SCIM, portanto este cenário de incompatibilidade não se aplica—veja Configurar provisionamento JIT ou SCIM para o que está disponível em cada plano.


Sintomas

As pessoas podem experimentar um ou mais dos seguintes ao tentar acessar sua organização via SSO:

  • “Criação de conta bloqueada” — A pessoa se autentica via SSO, mas Claude não consegue encontrar uma conta provisionada correspondente. Se sua organização tiver a criação de organização restrita (recomendado), a pessoa é bloqueada completamente.

  • Caindo em uma conta pessoal gratuita — Se a criação de organização não for restrita, a pessoa ignora sua organização completamente e cria ou cai em uma conta pessoal gratuita em vez de seu assento provisionado.

  • “Verifique em qual conta você está conectado” incompatibilidade — O retorno de chamada SSO mostra um email diferente do que a pessoa inseriu no login.

  • Falha de autenticação Claude Code — O CLI Claude Code mostra um erro de incompatibilidade de email durante o fluxo de autenticação.


Como isso acontece

Os perfis de usuário OneLogin contêm campos distintos para nome de usuário e email, que podem conter valores diferentes. Os parâmetros de provisionamento SCIM e as declarações de atributo SAML são configurados independentemente e podem extrair de campos diferentes:

Campo OneLogin

Valor típico

Comumente usado por

Nome de usuário

testuser1 ou [email protected]

Às vezes usado no mapeamento userName SCIM

Email

Recomendado para SCIM e SAML

Nome de login

Pode diferir do email se SSO for usado para logins não-email

Configurações legadas ou personalizadas

Campos de usuário personalizados

Atributos personalizados definidos por organização

Mapeamentos de atributos avançados

Uma incompatibilidade comum: a aba de parâmetros SCIM mapeia o atributo de email para Nome de usuário (que pode ser um ID de funcionário ou nome curto) enquanto a declaração de atributo SAML envia o campo Email. Claude requer uma correspondência exata de string.

Confusão comum: Os parâmetros SCIM e as declarações de atributo SAML do OneLogin estão em abas diferentes do mesmo aplicativo — Parâmetros para SCIM e SSO (ou Parâmetros com campos específicos de SAML) para SSO. Ambos devem ser verificados e alinhados.


Etapas de diagnóstico

Etapa 1 — Confirme a incompatibilidade

  1. Verifique o email SCIM: No portal de administração OneLogin, vá para Aplicativos → [Aplicativo Claude] → Parâmetros. Encontre o campo mapeado para o email que Claude recebe. Observe a coluna Valor OneLogin — isso mostra qual campo de usuário é enviado.

  2. Verifique o email SAML: No mesmo aplicativo, vá para a aba SSO. Clique em Mais ações → Editar resposta SAML ou verifique a seção Declarações de atributo SAML. Encontre o atributo para email e observe seu campo de origem.

  3. Verifique uma pessoa específica: Em Usuários → [Usuário], compare os campos Nome de usuário e Email. Se forem diferentes, qualquer mapeamento usando um ou outro causará uma incompatibilidade.

Etapa 2 — Identifique o escopo do problema

  • Se a maioria ou todas as pessoas provisionadas compartilharem a mesma incompatibilidade de formato de email, este é um problema de mapeamento de atributo sistêmico. A correção está no mapeamento de atributo SCIM do seu IdP.

  • Se apenas uma ou duas pessoas forem afetadas, o problema provavelmente é específico dessas contas. Verifique seu perfil diretamente.

Etapa 3 — Revise os valores dos campos de usuário

  1. Vá para Usuários → [Usuário afetado] → Informações do usuário.

  2. Verifique os campos Nome de usuário e Email.

  3. Se o Nome de usuário estiver em um formato que não corresponda a um email válido, o SCIM pode estar enviando um valor inválido ou não correspondente.


Resolução

Alinhe ambos os mapeamentos ao campo Email

O campo Email do OneLogin é a fonte mais confiável para SCIM e SAML, pois foi projetado para conter um endereço de email válido.

  1. Atualize o parâmetro SCIM: Em Aplicativos → [Aplicativo Claude] → Parâmetros, encontre a linha do atributo de email que Claude recebe. Altere o Valor para Email (o campo Email do OneLogin).

  2. Atualize a declaração de atributo SAML: Na aba SSO (ou Parâmetros para atributos SAML), atualize o valor do atributo de email para usar o mesmo campo Email.

  3. Clique em “Salvar.”

Acione uma ressincronização completa

Crítico — Sincronização completa necessária: Uma sincronização incremental não atualizará registros existentes após você alterar um mapeamento de atributo. Você deve acionar um reinício completo do ciclo de provisionamento.

  1. Na aba Provisionamento do aplicativo, procure por uma opção Ressincronizar ou Sincronizar tudo e execute-a.

  2. Para reprovisionar pessoas individuais: Vá para Usuários → [Usuário] → Aplicativos, encontre o aplicativo Claude e use Reprovisionar.

  3. Verifique o log de atividade de provisionamento do OneLogin para erros.

  4. Verifique se os valores de email atualizados aparecem no log antes de pedir às pessoas para tentar fazer login novamente.


Limpeza pós-correção

Após corrigir o mapeamento de atributo e concluir a sincronização completa:

  • Contas gratuitas indesejadas: Se a criação de organização não foi restrita antes da correção, algumas pessoas podem ter criado inadvertidamente contas Claude pessoais gratuitas. Entre em contato com nossa equipe de suporte para removê-las.

  • Contas fantasma (assentos com email incorreto): As contas originalmente provisionadas com o email incorreto podem ainda existir em sua organização, ocupando assentos que nunca podem ser usados. Entre em contato com nossa equipe de suporte para desprovisionar estes.

  • Disponibilidade de assentos: Se contas fantasma estão ocupando todos os assentos contratados, novos logins falharão com um erro de falta de assentos mesmo após o mapeamento ser corrigido.

  • Re-adicionando pessoas afetadas: Após contas fantasma serem removidas, pessoas com o email corrigido podem precisar ser re-convidadas ou re-provisionadas.

  • Prevenir ocorrências futuras: Ative “Restringir criação de organização” nas configurações de Identidade e acesso da sua organização.


Verificação

  1. Verifique uma amostra de pessoas provisionadas—confirme que seu email no log de provisionamento corresponde ao formato de email que SSO envia.

  2. Peça a uma pessoa afetada para limpar cookies do navegador para claude.ai e fazer login via SSO.

  3. Confirme que as pessoas não estão criando contas gratuitas.

  4. Se Claude Code foi afetado, peça à pessoa para executar novamente claude auth login --enterprise e confirme que o email corresponde ao seu assento provisionado.


Problemas comuns

Problema

Solução

O campo Nome de usuário contém um nome curto ou ID de funcionário, não um email

Mude SCIM para usar o campo Email.

Atributos SAML atualizados mas parâmetros SCIM não foram alterados

Tanto a aba Parâmetros (para SCIM) quanto os atributos SSO/SAML devem ser atualizados independentemente.

A ressincronização não parece ser acionada

Tente remover e reatribuir pessoas afetadas do aplicativo.

Campos de usuário personalizados são mapeados mas em branco para algumas pessoas

Mude para o campo Email padrão.

Emails atualizados em SCIM mas a pessoa ainda não consegue fazer login

Verifique contas gratuitas indesejadas ou contas fantasma. Limpe cookies do navegador e tente novamente.

“Domínio de convite não permitido” ao tentar re-adicionar pessoas

O domínio da sua organização pode não estar verificado em Claude. Entre em contato com o suporte.


Quando entrar em contato com o suporte

Entre em contato com nossa equipe de suporte com o domínio da sua organização, o email da pessoa afetada e capturas de tela de seus mapeamentos de atributo quando:

  • Os atributos SCIM e SSO parecem idênticos mas as pessoas ainda não conseguem acessar seus assentos.

  • Você precisa de confirmação do email que Claude registrou durante o provisionamento SCIM para pessoas específicas.

  • Você precisa de ajuda para limpar contas fantasma ou organizações gratuitas indesejadas.

  • As pessoas estão recebendo um erro de falta de assentos apesar de assentos contratados disponíveis.

Isto respondeu à sua pergunta?