通过

Exchange 标识令牌揭秘

  • 项目

重要

旧版 Exchange 令牌已弃用。 从 2025 年 2 月开始，我们将开始关闭 Exchange Online 租户的旧版 Exchange 用户标识和回调令牌。 有关时间线和详细信息，请参阅常见问题解答页面。 这是 Microsoft的“安全未来计划”的一部分，该计划为组织提供了应对当前威胁环境所需的工具。 Exchange 用户标识令牌仍适用于本地 Exchange。 嵌套应用身份验证是今后令牌的建议方法。

由 getUserIdentityTokenAsync 方法返回的 Exchange 用户标识令牌为加载项代码提供了一种将用户的标识包含在后端服务调用中的方法。 本文将探讨令牌的格式和内容。

Exchange 用户标识令牌是一个 Base 64 URL 编码的字符串，由发送它的 Exchange 服务器签名。 该令牌未加密，用于验证签名的公钥存储在颁发该令牌的 Exchange 服务器上。 该令牌由三部分组成：标头、有效负载和签名。 在令牌字符串中，各部分由句点字符 (.) 分隔，以便于拆分令牌。

Exchange 使用标识令牌的 JSON Web 令牌 (JWT) 格式。 有关 JWT 令牌的信息，请参阅 RFC 7519 JSON Web 令牌 (JWT)。

标识令牌标头

标头提供令牌的格式和签名的相关信息。 令牌标头如以下示例所示。

{
  "typ": "JWT",
  "alg": "RS256",
  "x5t": "Un6V7lYN-rMgaCoFSTO5z707X-4"
}

下表描述了令牌标头的各个部分。
声明 值 说明
typ JWT 将令牌识别为 JSON Web 令牌。 Exchange 服务器提供的所有标识令牌均是 JWT 令牌。
alg RS256 用于创建签名的哈希算法。 Exchange 服务器提供的所有令牌均结合使用了 RSASSA-PKCS1-v1_5 和 SHA-256 哈希算法。
x5t 证书指纹 令牌的 X.509 指纹。

标识令牌有效负载

有效负载包含身份验证声明，标识电子邮件帐户和发送令牌的 Exchange 服务器。 下面的示例显示有效负载部分的形式。

{ 
  "aud": "https://mailhost.contoso.com/IdentityTest.html", 
  "iss": "00000002-0000-0ff1-ce00-000000000000@mailhost.contoso.com", 
  "nbf": "1331579055", 
  "exp": "1331607855", 
  "appctxsender": "00000002-0000-0ff1-ce00-000000000000@mailhost.context.com",
  "isbrowserhostedapp": "true",
  "appctx": { 
    "msexchuid": "53e925fa-76ba-45e1-be0f-4ef08b59d389@mailhost.contoso.com",
    "version": "ExIdTok.V1",
    "amurl": "https://mailhost.contoso.com:443/autodiscover/metadata/json/1"
  } 
}

下表列出标识令牌有效负载的各个部分。
声明 说明
aud 请求该令牌的加载项的 URL。 仅当令牌是从客户端 Webview 控件中运行的加载项发送的时，令牌才有效。 外接程序的 URL 在清单中指定。 标记取决于清单的类型。

仅外接程序清单：如果外接程序使用 Office 外接程序清单架构 v1.1，则此 URL 是在窗体类型 ItemRead 或 ItemEdit下的第一个 <SourceLocation> 元素中指定的 URL，以作为外接程序清单中 FormSettings 元素的一部分先出现者为准。

Microsoft 365 的统一清单：URL 在“extensions.audienceClaimUrl”属性中指定。
iss 颁发令牌的 Exchange 服务器的唯一标识符。 此 Exchange 服务器颁发的所有令牌将具有相同标识符。
nbf 令牌开始生效的日期和时间。 值是自 1970 年 1 月 1 日以来的秒数。
exp 令牌有效期至的日期和时间。 值是自 1970 年 1 月 1 日以来的秒数。
appctxsender 发送应用程序上下文的 Exchange 服务器的唯一标识符。
isbrowserhostedapp 指示加载项是否托管在浏览器中。
appctx 令牌的应用程序上下文。

appctx 声明中的信息提供了帐户的唯一标识符和用于为令牌签名的公钥的位置。 下表列出了 appctx 声明的各部分。

应用程序上下文属性 说明
msexchuid 与电子邮件帐户和 Exchange 服务器关联的唯一标识符。
version 令牌的版本号。 对于 Exchange 提供的所有令牌，值为 ExIdTok.V1。
amurl 身份验证元数据文档（包含用于登录该令牌的 X.509 证书的公钥）的 URL。

有关如何使用身份验证元数据文档的详细信息，请参阅验证 Exchange 标识令牌。

标识令牌签名

通过使用标头中指定的算法，并使用有效负载中指定的服务器位置处的自签名 X 509 证书，对标头和有效负载部分进行哈希处理来创建签名。 Web 服务可以验证此签名，以帮助确保标识令牌来自预期的服务器。

另请参阅

有关解析 Exchange 用户标识令牌的示例，请参阅 Outlook-Add-In-Token-Viewer。