大网数据广告活动
Microsoft Graph 接口

MSAL 提供程序

· 52CE 我爱测

MSAL 提供程序使用 MSAL.js 登录用户并获取与 Microsoft Graph 一Graph。

MSAL 提供程序msal.js登录用户并获取与 Microsoft Graph 一Graph。

若要了解更多信息,请参阅 提供程序。

MSAL2 提供程序和 MSAL 提供程序的区别

尽管用法相似,但 MSAL 提供程序和 MSAL2 提供程序构建在不同的 OAuth 流上。 MSAL 提供程序基于实现 OAuth2.0 隐式msal.js的 Flow。 MSAL2 提供程序基于 msal-browser 构建,它使用 PKCE 实现 OAuth 2.0 Flow代码。 由于授权代码Flow Web 应用程序的隐式授权权限Flow,因此我们建议使用 MSAL2 Provider over MSAL Provider。 有关与隐式授予流相关的安全问题的详细信息,请参阅 隐式流的缺点。

所有新应用程序应尽可能使用 MSAL2 提供程序。 有关迁移信息,请参阅 MSAL2 提供程序。

入门

可以使用 HTML 或 JavaScript 初始化 MSAL 提供程序。

在 HTML 页中初始化

使用 HTML 初始化 MSAL 提供程序是创建新提供程序的最简单方法。 mgt-msal-provider使用该组件设置 client-id 和其他属性。 这将创建一个 UserAgentApplication 将用于所有身份验证和获取令牌的新实例。

<mgt-msal-provider client-id="<YOUR_CLIENT_ID>"
                   login-type="redirect/popup"
                   scopes="user.read,people.read"
                   redirect-uri="https://my.redirect/uri"
                   authority=""
                   domainHint="mydomain.com"
                   prompt="consent"></mgt-msal-provider>
属性 说明
client-id 字符串客户端 ID (创建应用/客户端 ID) 。 必需项。
login-type 和 之间的枚举 redirect popup - 默认值为 redirect。 可选。
scopes 用户登录时必须同意的范围的逗号分隔字符串。 可选。
authority 颁发机构字符串 - 默认为公共颁发机构。 对于单租户应用,请使用租户 ID 或租户名称。 例如,https://login.microsoftonline.com/[your-tenant-name].onmicrosoft.com 或 https://login.microsoftonline.com/[your-tenant-id]。 可选。
redirect-uri 重定向 URI 字符串 - 默认情况下,使用当前窗口 URI。 可选。
depends-on 另一个优先级较高的提供程序组件的元素选择器字符串。 可选。
域提示 用于转发登录体验的域位置的查询字符串。 可选。
提示 选择登录所需的用户交互类型。 有效选项包括: <ul><li>login 强制用户在请求时输入凭据 </li><li>none 无交互提示</li> <li>select_account 将用户发送到帐户选取器</li><li>consent 将用户发送到 OAuth 同意对话框</li></ul> 有关更多提示信息,请参阅本文 中的MSAL.js 行为。 可选。

在 JavaScript 中初始化

可以通过在 JavaScript 中初始化提供程序来提供更多选项。

import {Providers, MsalProvider} from '@microsoft/mgt'
import {UserAgentApplication} from "msal";

Providers.globalProvider = new MsalProvider(config: MsalConfig);

您可以通过两种方式 MsalProvider 配置构造函数参数,如以下各节所述。

clientId提供 以创建新UserAgentApplication

此选项在用户负责Graph Toolkit身份验证时有意义。

interface MsalConfig {
  clientId: string;
  scopes?: string[];
  authority?: string;
  redirectUri?: string;
  loginType?: LoginType; // LoginType.Popup or LoginType.Redirect (redirect is default)
  loginHint?: string
  options?: Configuration; // msal js Configuration object
  domainHint?: string;
  prompt?: string; // "login", "none", "select_account", "consent"
}
在 属性中 UserAgentApplication 传递 userAgentApplication 现有的 。

当你的应用使用 MSAL 功能(MsalProvider除了由 Microsoft 和其他 Microsoft 服务公开的功能Graph Toolkit此功能。 当框架自动 UserAgentApplication 实例化并公开 时,这尤其适用;例如,在使用 msal-angular 时。

请务必了解使用此选项时发生冲突的机会。 从本质上说 MsalProvider ,存在可以更改会话状态的风险,例如,让用户登录或同意其他范围。 请确保应用和其他框架在状态中流畅地响应这些更改,或考虑改为使用 自定义提供程序 。

interface MsalConfig {
  userAgentApplication: UserAgentApplication;
  scopes?: string[];
  loginType?: LoginType; // LoginType.Popup or LoginType.Redirect (redirect is default)
  loginHint?: string;
}

若要详细了解MSAL.js以及初始化 MSAL 库时可以使用的其他选项,请参阅 MSAL 文档。

创建应用/客户端 ID

若要详细了解如何注册应用和获取客户端 ID,请参阅创建Azure Active Directory应用。

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 sebastienlevert)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。