Ir para conteúdo principal

Incompatibilidade de email do Microsoft Entra ID SSO/SCIM

Claude usa email como identificador principal para corresponder logins SSO a assentos provisionados. No Microsoft Entra ID, o provisionamento SCIM e a autenticação SSO são configurados em locais separados e podem extrair email de atributos de usuário diferentes—causando uma incompatibilidade que bloqueia o acesso. Este guia mostra como identificar o problema, corrigir o mapeamento de atributos e limpar quaisquer efeitos colaterais.

Aplica-se a: Planos Enterprise e organizações Console usando provisionamento SCIM. Planos Team não têm 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 a criação de organização for 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 e cria ou chega a uma conta pessoal gratuita.

  • “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

As contas de usuário do Microsoft Entra ID têm vários atributos semelhantes a email que podem conter valores diferentes. O provisionamento SCIM e a autenticação SSO são configurados em áreas de administração separadas e cada um pode extrair de um atributo diferente:

Atributo Entra

Valor típico

Comumente usado por

userPrincipalName

[email protected] (pode estar em formato de ID de funcionário)

Mapeamento padrão de userName SCIM

mail

[email protected] (email padrão)

Declaração de email OIDC / SAML

proxyAddresses

Endereço principal do Exchange / M365

otherMails

Pode conter aliases ou endereços secundários

Emails de contato alternativos

A incompatibilidade ocorre quando SCIM extrai email de um atributo enquanto SSO envia o email de outro. Até mesmo uma diferença sutil bloqueia o acesso—Claude requer uma correspondência exata de string.

Confusão comum: Entra tem duas áreas de administração separadas. O aplicativo de provisionamento SCIM fica sob Aplicativos empresariais (termo da Microsoft para aplicativos integrados—não relacionado ao seu plano Claude). O aplicativo SSO/OIDC fica sob Registros de aplicativos. Administradores de TI frequentemente navegam para o local errado.


Etapas de diagnóstico

Etapa 1 — Confirme a incompatibilidade

  1. Verifique o email SCIM: Em Centro de Administração Entra → Aplicativos empresariais → [Aplicativo Claude SCIM] → Provisionamento → Logs de provisionamento, encontre uma pessoa provisionada recentemente e inspecione Atributos modificados. O valor mapeado para emails[type eq “work”].value é o que SCIM enviou para Claude.

  2. Verifique o email SSO: Em Aplicativos empresariais → [Aplicativo Claude] → Logon único → Atributos e declarações, encontre a declaração de email. Para aplicativos OIDC, verifique Registros de aplicativos → [Aplicativo Claude] → Configuração de token.

  3. Se os dois atributos de origem apontarem para campos diferentes, você confirmou a incompatibilidade.

Etapa 2 — Identifique o escopo

  • Se a maioria ou todas as pessoas provisionadas compartilharem o mesmo formato de incompatibilidade, este é um problema de mapeamento de atributo sistêmico. A correção está na configuração de mapeamento de atributo SCIM.

  • Se apenas uma ou duas pessoas forem afetadas, verifique seu perfil de usuário diretamente em Entra.

Etapa 3 — Verifique as declarações de token OIDC (apenas aplicativos OIDC)

  1. No Centro de Administração Entra, vá para Registros de aplicativos (não Aplicativos empresariais).

  2. Encontre o aplicativo Claude OIDC e clique em “Configuração de token.”

  3. Verifique a declaração de email opcional.

  4. Faça referência cruzada com seu mapeamento de atributo SCIM para confirmar se eles correspondem.


Resolução

Corrija o mapeamento de atributo SCIM

Navegue até o aplicativo de provisionamento SCIM — não o aplicativo SSO/OIDC:

  1. Vá para Centro de Administração Entra → Aplicativos empresariais.

  2. Procure pelo aplicativo Claude SCIM. Procure pelo aplicativo com uma seção Provisionamento.

  3. Clique em Provisionamento → Editar provisionamento → Mapeamentos de atributos.

  4. Encontre a linha onde o atributo SCIM é emails[type eq “work”].value. Clique nela para editar.

  5. Altere o Atributo de origem para corresponder ao que SSO envia — normalmente mail.

  6. Também verifique o mapeamento de userName e atualize se necessário.

  7. Clique em “Salvar.”

Acione uma sincronização de provisionamento completa

Sincronização completa necessária — incremental não funcionará. Você deve acionar um reinício completo do ciclo de provisionamento.

  1. Vá para a página de visão geral Provisionamento.

  2. Clique em Reiniciar provisionamento.

  3. Aguarde a conclusão da sincronização.

  4. Verifique nos logs de provisionamento que os emails foram atualizados para o formato correto.


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 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 a correção do mapeamento.

  • 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.


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 depois fazer login via SSO. Ela deve chegar diretamente ao espaço de trabalho da sua organização.

  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

Mapeamento SCIM atualizado mas declaração SSO não verificada (ou vice-versa)

Ambos devem ser atualizados. SCIM sob Aplicativos empresariais → Provisionamento; declarações SSO sob Logon único → Atributos e declarações ou Registros de aplicativos → Configuração de token.

userPrincipalName está em formato de ID de funcionário, não um email real

Mude SCIM para usar o atributo mail em vez disso.

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

Reiniciar provisionamento é necessário após uma alteração de mapeamento de atributo.

Declaração de email do aplicativo OIDC não configurada como declaração opcional

Adicione email sob Registros de aplicativos → Configuração de token.

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.


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 mapeamento de atributos 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 orgs gratuitas não autorizadas.

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

Isto respondeu à sua pergunta?