跳转到主要内容

SSO/SCIM 电子邮件不匹配 — Microsoft Entra ID

本指南涵盖的内容:Claude 使用电子邮件作为主要标识符来匹配 SSO 登录与已配置的席位。在 Microsoft Entra ID 中,SCIM 配置和 SSO 身份验证配置在不同的位置,可能从不同的用户属性中提取电子邮件——导致不匹配,从而阻止访问。本指南将介绍如何识别问题、修复属性映射以及清理任何副作用。

症状

用户在尝试通过 SSO 访问 Claude for Enterprise 时可能会遇到以下一个或多个问题:

  • "账户创建被阻止"——用户通过 SSO 进行身份验证,但 Claude 找不到匹配的已配置账户。如果限制了组织创建(推荐),用户将被完全阻止。

  • 登陆到免费个人账户——如果未限制组织创建,用户将绕过企业组织,创建或登陆到免费个人账户。

  • "请确认您的电子邮件"不匹配——SSO 回调显示的电子邮件与用户在登录时输入的电子邮件不同。

  • Claude Code 身份验证失败——Claude Code CLI 在身份验证流程中显示电子邮件不匹配错误。

发生原因

Microsoft Entra ID 用户账户有多个类似电子邮件的属性,可以保存不同的值。SCIM 配置和 SSO 身份验证在不同的管理区域中配置,每个都可以从不同的属性中提取:

Entra 属性

典型值

常见用途

userPrincipalName

[email protected](可能是员工 ID 格式)

默认 SCIM userName 映射

mail

[email protected](标准电子邮件)

OIDC / SAML 电子邮件声明

proxyAddresses

Exchange / M365 主地址

otherMails

可能包含别名或辅助地址

替代联系电子邮件

当 SCIM 从一个属性提取电子邮件,而 SSO 从另一个属性发送电子邮件时,就会发生不匹配。即使是细微的差异也会阻止访问——Claude 需要完全字符串匹配

常见混淆:Entra 有两个独立的管理区域。SCIM 配置应用位于企业应用程序下。SSO/OIDC 应用位于应用注册下。IT 管理员经常导航到错误的位置。

诊断步骤

步骤 1——确认不匹配

  1. 检查 SCIM 电子邮件:在 Entra 管理中心 → 企业应用程序 → [Claude SCIM 应用] → 配置 → 配置日志中,找到最近配置的用户并检查修改的属性。映射到 emails[type eq "work"].value 的值是 SCIM 发送给 Claude 的内容。

  2. 检查 SSO 电子邮件:企业应用程序 → [Claude 应用] → 单一登录 → 属性和声明中,找到电子邮件声明。对于 OIDC 应用,检查应用注册 → [Claude 应用] → 令牌配置

  3. 如果两个源属性指向不同的字段,您已确认了不匹配。

步骤 2——确定范围

  • 如果大多数或所有已配置的用户共享相同的格式不匹配,这是一个系统性属性映射问题。修复方案在 SCIM 属性映射配置中。

  • 如果只有一两个用户受影响,请直接在 Entra 中检查他们的用户配置文件。

步骤 3——检查 OIDC 令牌声明(仅限 OIDC 应用)

  1. 在 Entra 管理中心,转到应用注册(不是企业应用程序)。

  2. 找到 Claude OIDC 应用并点击令牌配置

  3. 检查 email 可选声明。

  4. 与您的 SCIM 属性映射交叉参考,以确认它们是否匹配。

解决方案

修复 SCIM 属性映射

导航到 SCIM 配置应用——不是 SSO/OIDC 应用:

  1. 转到Entra 管理中心 → 企业应用程序

  2. 搜索 Claude SCIM 应用。查找具有配置部分的应用。

  3. 点击配置 → 编辑配置 → 属性映射

  4. 找到 SCIM 属性为 emails[type eq "work"].value 的行。点击它进行编辑。

  5. 源属性更改为与 SSO 发送的内容匹配——通常是 mail

  6. 同时检查 userName 映射,如果需要则更新。

  7. 点击保存

触发完整配置同步

需要完整同步——增量同步不起作用。您必须触发配置周期的完整重启

  1. 转到配置概览页面。

  2. 点击重启配置

  3. 等待同步完成。

  4. 在配置日志中验证用户电子邮件已更新为正确的格式。

这是否解答了您的问题?