Ir para conteúdo principal

Incompatibilidade de email entre Okta SSO/SCIM

Claude usa o email como identificador principal para corresponder logins SSO a assentos provisionados. No Okta, o provisionamento SCIM e SSO são configurados separadamente e podem extrair email de diferentes campos de perfil de usuário. Este guia explica como identificar e resolver a incompatibilidade.

Aplica-se a: Planos Enterprise e organizações Console que usam provisionamento SCIM. Planos Team não têm provisionamento SCIM, portanto este cenário de incompatibilidade não se aplica—consulte Configurar provisionamento JIT ou SCIM para saber 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 autenticação SSO é bem-sucedida, mas Claude não consegue localizar uma conta provisionada correspondente. Se sua organização tiver a criação de organização restrita (recomendado), a pessoa é bloqueada completamente.

  • Chegando a 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 chega a 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 do Claude Code — O CLI do Claude Code mostra um erro de incompatibilidade de email durante o fluxo de autenticação.


Como isso acontece

Os perfis de usuário do Okta contêm vários campos que representam identidade. O provisionamento SCIM (em Provisioning → To App) e SSO SAML/OIDC (em Sign On) são configurados independentemente.

Atributo Okta

Valor típico

Comumente usado por

user.login

testuser1 ou [email protected]

Mapeamento padrão de userName SCIM; às vezes NameID

user.email

Declaração de email SAML/OIDC (recomendado)

appuser.email

Substituição de email de usuário no nível do aplicativo

Mapeamento de atributo personalizado no nível do aplicativo

Uma incompatibilidade comum: SCIM usa user.login enquanto SAML envia user.email. Claude requer uma correspondência exata de string.

Confusão comum: Os mapeamentos de atributo SCIM do Okta e as declarações de atributo SAML estão em duas abas diferentes — Provisioning → To App para SCIM e Sign On para SSO.


Etapas de diagnóstico

Etapa 1 — Confirmar a incompatibilidade

  1. Verificar email SCIM: Navegue até Applications → [Claude App] → Provisioning → To App → Attribute Mappings. Localize a linha email (ou userName). A coluna Value mostra a expressão Okta sendo enviada.

  2. Verificar email SSO (SAML): Vá para Applications → [Claude App] → Sign On → SAML Settings → Edit → Attribute Statements. Encontre o atributo email. A coluna Value indica qual campo Okta é afirmado.

  3. Verificar email SSO (OIDC): Vá para Applications → [Claude App] → Sign On → OpenID Connect ID Token e revise a seção Claims para email.

  4. Se os valores SCIM e SSO fazem referência a campos Okta diferentes, a incompatibilidade é confirmada.

Etapa 2 — Identificar o escopo do problema

  • A maioria ou todas as pessoas provisionadas afetadas: Este é um problema de mapeamento de atributo sistêmico. A correção está no mapeamento de atributo SCIM do seu IdP.

  • Uma ou duas pessoas afetadas: O problema é específico dessas contas. Verifique seu perfil de usuário diretamente.

Etapa 3 — Verificar perfis de usuário Okta diretamente

  1. Vá para Directory → People → [User] → Profile.

  2. Compare os valores dos campos Login e Email. Diferenças entre esses campos produzirão incompatibilidades de mapeamento.


Resolução

Alinhar ambos os mapeamentos ao mesmo campo Okta

A correção mais segura é usar user.email para SCIM e SSO, pois este campo contém o endereço de email canônico no Okta.

  1. Atualizar mapeamento SCIM: Em Provisioning → To App → Attribute Mappings, altere a origem email (ou userName) para user.email.

  2. Atualizar declaração SSO (SAML): Em Sign On → SAML Settings → Attribute Statements, altere o valor do atributo de email para user.email.

  3. Atualizar declaração SSO (OIDC): Em Sign On → OpenID Connect ID Token → Claims, atualize a declaração de email para mapear para user.email.

  4. Clique em “Salvar.”

Forçar uma ressincronização completa

Crítico — Ressincronização completa necessária: Uma sincronização incremental não atualizará registros existentes após você alterar um mapeamento de atributo.

  1. Em Provisioning → To App, clique em “Force Sync” para disparar uma reavaliação completa de todos os atribuídos.

  2. Alternativamente, para pessoas específicas: Provisioning → Push Users → selecione pessoas afetadas → Push Now.

  3. Verifique o Log do Sistema Okta (Reports → System Log) para erros de provisionamento.

  4. Verifique se os valores de email atualizados aparecem nos logs de provisionamento antes que as pessoas tentem fazer login novamente.


Limpeza pós-correção

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

  • Contas gratuitas não autorizadas: Se a criação de organização não foi restrita antes da correção, algumas pessoas podem ter criado contas Claude pessoais gratuitas. Entre em contato com nossa equipe de Suporte para remoção.

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

  • Disponibilidade de assento: 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 a remoção de contas fantasma, 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 para evitar que pessoas não provisionadas criem contas gratuitas.


Verificação

Após concluir a correção e qualquer limpeza:

  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. Ela deve chegar diretamente ao workspace da sua organização sem erros.

  3. Confirme que as pessoas não estão criando contas gratuitas—com a criação de organização restrita, pessoas bloqueadas veem um erro claro em vez de chegar a uma conta pessoal.

  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

Admin atualiza declarações SAML mas esquece mapeamentos de atributo SCIM (ou vice-versa)

Ambos devem ser atualizados. Mapeamentos SCIM em Provisioning → To App; declarações SAML em Sign On → SAML Settings.

user.login contém um nome de usuário (não email) para algumas pessoas

Mude ambos para user.email e verifique se os campos de email estão preenchidos para todos.

Sincronização incremental é executada mas emails não são atualizados

Force Sync ou Push Users é necessário após uma alteração de mapeamento de atributo.

Atributo de perfil no nível do aplicativo (appuser.email) difere do perfil de usuário (user.email)

Verifique se mapeamentos de atributo no nível do aplicativo substituem valores de perfil de usuário.

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

Procure por orgs gratuitas não autorizadas ou contas fantasma. Limpe cookies do navegador e tente novamente. Entre em contato com Suporte se persistir.

Aplicativos OIDC e SAML são aplicativos Okta separados para Claude

Algumas organizações configuram ambos. Garanta alinhamento de atributo em ambos os aplicativos.


Quando entrar em contato com 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 mapeamento de atributo quando:

  • 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 não autorizadas.

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

Isto respondeu à sua pergunta?