首页
/ Microsoft Authentication Library for JS 中的 knownAuthorities 配置解析

Microsoft Authentication Library for JS 中的 knownAuthorities 配置解析

2025-06-18 14:34:48作者:钟日瑜

什么是 knownAuthorities

在 Microsoft Authentication Library for JS (MSAL.js) 配置中,knownAuthorities 是一个用于指定已知身份验证机构列表的属性。这个属性主要用于定义应用程序信任的身份提供者(Identity Providers)。

适用场景

knownAuthorities 主要设计用于以下两种场景:

  1. Azure AD B2C 应用:当应用程序使用 Azure AD B2C 作为身份提供者时,需要明确指定信任的 B2C 策略域。

  2. 非标准 Microsoft 身份提供者:当应用程序集成了非标准的 Microsoft 身份提供者服务时,需要在此列出这些自定义的授权机构。

重要注意事项

对于标准的 Azure Active Directory (Azure AD) 应用,不应该login.microsoftonline.com 或其他 Azure AD 别名添加到 knownAuthorities 中,原因如下:

  1. 自动发现机制:MSAL.js 默认已经内置了对标准 Azure AD 授权机构的发现机制,无需额外配置。

  2. 多租户应用限制:如果开发者希望限制应用只能被特定租户访问,不应该依赖客户端配置来实现。因为客户端验证很容易被绕过,这不是一种安全的做法。

最佳实践

对于需要限制访问权限的多租户应用,建议采用以下方法:

  1. 使用条件访问策略:在 Azure AD 中配置条件访问(Conditional Access)策略,这是服务端的安全控制方式。

  2. 令牌验证:在应用后端验证令牌中的 tid(租户ID)声明,确保请求来自允许的租户。

  3. API 权限控制:在 API 层面实施租户级别的访问控制,而非在前端实现。

配置示例

虽然不推荐对标准 Azure AD 使用 knownAuthorities,但对于 B2C 场景,配置示例如下:

{
  auth: {
    clientId: "你的客户端ID",
    authority: "https://yourtenant.b2clogin.com/yourtenant.onmicrosoft.com/B2C_1_signupsignin",
    knownAuthorities: ["yourtenant.b2clogin.com"]
  }
}

总结

理解 knownAuthorities 的正确使用场景对于构建安全的身份验证流程至关重要。开发者应当避免将其用于标准 Azure AD 场景,而应该采用服务端的安全控制机制来实现租户访问限制。对于 B2C 或自定义身份提供者场景,才需要合理配置此属性。

登录后查看全文
热门项目推荐
相关项目推荐