跳至内容
从 NextAuth.js v4 迁移?请阅读 我们的迁移指南.

providers/microsoft-entra-id

内置 Microsoft Entra ID 集成。

MicrosoftEntraIDProfile

扩展

属性

email

email: string;

昵称

nickname: string;

图片

picture: string;

sub: string;

默认()

default(config): OIDCConfig<MicrosoftEntraIDProfile>

将 Microsoft Entra ID 登录添加到您的页面。

设置

回调 URL

https://example.com/auth/callback/microsoft-entra-id

配置

参数

参数类型
配置OIDCUserConfig<MicrosoftEntraIDProfile> & { profilePhotoSize: | 64 | 48 | 96 | 120 | 240 | 360 | 432 | 504 | 648; }

返回

OIDCConfig<MicrosoftEntraIDProfile>

示例

import MicrosoftEntraID from "@auth/core/providers/microsoft-entra-id"
...
providers: [
  MicrosoftEntraID({
    clientId: env.AUTH_MICROSOFT_ENTRA_ID_ID,
    clientSecret: env.AUTH_MICROSOFT_ENTRA_ID_SECRET,
  }),
]
...

资源

允许特定 Active Directory 用户访问:

默认情况下,Entra ID 提供程序允许用户使用任何 Microsoft 帐户(个人、学校或工作)登录。

要只允许您的组织的用户登录,您需要设置 issuer,以及客户端 ID 和密钥。

示例

import MicrosoftEntraID from "@auth/core/providers/microsoft-entra-id"
 
providers: [
  MicrosoftEntraID({
    clientId: env.AUTH_MICROSOFT_ENTRA_ID_ID,
    clientSecret: env.AUTH_MICROSOFT_ENTRA_ID_SECRET,
    issuer: env.AUTH_MICROSOFT_ENTRA_ID_TENANT_ID,
  }),
]

备注

Microsoft Entra ID 将配置文件图片返回为 ArrayBuffer,而不是只是图片的 URL,因此我们的提供程序将其转换为 base64 编码的图像字符串并返回。

默认情况下,Auth.js 假设 Microsoft Entra ID 提供程序基于 Open ID Connect 规范。

💡

Microsoft Entra ID 提供程序附带 默认配置。要为您的用例覆盖默认值,请查看 自定义内置 OAuth 提供程序

免责声明 如果您认为在默认配置中发现了错误,可以 打开一个问题

Auth.js 严格遵守规范,对于提供程序对规范的任何偏差,Auth.js 不承担责任。您可以打开一个问题,但如果问题是非规范合规性问题,我们可能不会寻求解决方案。您可以在 讨论 中寻求更多帮助。

Auth.js © Balázs Orbán 和团队 -2024