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

使用 Microsoft Graph Toolkit

· 52CE 我爱测

本主题介绍如何在用 vanilla JavaScript 编写的 Web Graph Toolkit Microsoft 应用程序入门。 有关分步教程,请尝试开始 Microsoft Graph Toolkit模块。 如果你想要了解如何将 web 应用程序与 web Toolkit,请参阅生成 Web 应用 (React) 或生成 Web (Angular) 。

本主题介绍如何在用 vanilla JavaScript 编写的 Web Graph Toolkit Microsoft 应用程序入门。 有关分步教程,请尝试开始 Microsoft Graph Toolkit模块。 如果你想要了解如何将 web 应用程序与 web Toolkit,请参阅生成 Web 应用 (React) 或生成 Web (Angular) 。

Microsoft Graph Toolkit入门包括以下步骤:

  1. 将 Microsoft Graph Toolkit添加到你的项目中。
  2. 初始化 MSAL2 提供程序。
  3. 添加组件。
  4. 测试应用程序。

将 Microsoft Graph 工具包添加到项目

可以通过直接引用加载程序 (通过 unpkg) 或安装 npm 包,在应用程序中使用 Microsoft Graph 工具包。

unpkg

若要通过 mgt-loader 使用工具包,请将脚本中的引用添加到代码中:

<script src="https://unpkg.com/@microsoft/mgt/dist/bundle/mgt-loader.js"></script>

npm

通过 ES6 模块使用工具包可以完全控制捆绑过程,并允许仅捆绑应用程序所需的代码。 若要使用 ES6 模块,请将 npm 包添加到项目中:

npm install @microsoft/mgt

初始化 MSAL2 提供程序

Microsoft Graph 工具包提供程序为组件启用身份验证和对 Microsoft Graph 的访问。 若要了解详细信息,请参阅使用提供程序。 MSAL2 提供程序使用 msal-browser 登录用户并获取令牌。 可以在 HTML 或 JavaScript 中初始化此提供程序。

注意:如果当前使用的是 MSAL 提供程序,并且要更新到 MSAL2 提供程序,请按照此处列出的 步骤操作。 如果要使用自己的后端身份验证,请使用代理 提供程序 替代 MSAL2 提供程序。

可以选择在 HTML 或 JavaScript 代码中初始化提供程序。

HTML

将组件 mgt-msal2-provider 添加到 HTML 页面,将 设置为 client-id 应用程序 client-id。

<mgt-msal2-provider client-id="<YOUR_CLIENT_ID>"></mgt-msal2-provider>

JavaScript

若要在 JavaScript 中初始化 MSAL 提供程序,请向应用程序添加以下代码:

import { Providers, Msal2Provider } from '@microsoft/mgt';

Providers.globalProvider = new Msal2Provider({
  clientId: "<YOUR_CLIENT_ID>"
});

客户端 ID 是初始化提供程序所需的唯一属性,但您可以设置其他选项。 有关完整列表,请参阅 MSAL2 提供程序。

创建应用/客户端 ID

若要获取客户端 ID,需要在客户端 ID 中注册Azure AD。

添加组件

初始化 MSAL2 提供程序后,可以开始使用任何Toolkit组件。

HTML

下面是使用 mgt-loader 的完整工作示例、HTML 中初始化的 MSAL2 提供程序和登录组件:

<script src="https://unpkg.com/@microsoft/mgt/dist/bundle/mgt-loader.js"></script>
<mgt-msal2-provider client-id="<YOUR_CLIENT_ID>"></mgt-msal2-provider>
<mgt-login></mgt-login>

这是使用 ES6 模块、HTML 中初始化的 MSAL2 提供程序和登录组件的示例:

<script type="module" src="node_modules/@microsoft/mgt/dist/es6/index.js"></script>
<mgt-msal2-provider client-id="<YOUR_CLIENT_ID>"></mgt-msal2-provider>
<mgt-login></mgt-login>

JavaScript

这是使用 ES6 模块、在 JavaScript 中初始化的 MSAL2 提供程序和登录组件的示例:

import { Providers, Msal2Provider } from '@microsoft/mgt';

Providers.globalProvider = new Msal2Provider({
  clientId: "<YOUR_CLIENT_ID>"
});

function component() {
  const element = document.createElement('div');
  element.innerHTML = '<mgt-login></mgt-login>';
  return element;
}

document.body.appendChild(component());

测试应用

为了测试你的应用,MSAL 要求将页面托管在 Web 服务器中,以便进行身份验证重定向。

如果刚开始操作并且想要玩游戏,可以在 Visual Studio Code或任何类似的轻型开发服务器中使用 Live Server。 下载扩展名,然后使用实时服务器打开 HTML 文件。

注意: 确保应用 注册中的重定向 URI 设置为托管应用程序的 localhost 端口。 转到应用中的应用注册Azure 门户"管理 "下的"身份验证",然后添加正确的 重定向 URI。

跟踪用户的登录状态

你可以检测用户何时成功登录,并相应地显示特定组件。 例如,如果用户已登录,则显示议程组件。 否则,显示登录界面。

若要正确检查用户的登录状态,使用 函数向 providerUpdated 事件添加事件 Providers.onProviderUpdated 处理程序。 在处理程序中,检查存储在 属性上的提供程序 Providers.globalProvider.state 状态。

HTML

如果使用的是 库mgt-loader,可以从全局Provider``ProviderState属性访问 和 mgt 。

<!DOCTYPE html>
<html>
<head>
  <script src="https://unpkg.com/@microsoft/mgt/dist/bundle/mgt-loader.js"></script>
</head>
<body>
  <mgt-msal2-provider client-id="<YOUR_CLIENT_ID>"></mgt-msal2-provider>
  <div id="main">
    <mgt-login></mgt-login>
  </div>
  <script>
    const loadAgenda = () => {
      if (mgt.Providers.globalProvider.state === mgt.ProviderState.SignedIn) {
        document.getElementById('main').innerHTML = '<mgt-agenda></mgt-agenda>';
      }
    }
    mgt.Providers.onProviderUpdated(loadAgenda);
  </script>
</body>
</html>

JavaScript

如果你通过 npm 包使用工具包,你可以从 导入 Provider 和 ProviderState @microsoft/mgt。

import { Providers, ProviderState, Msal2Provider } from '@microsoft/mgt';

Providers.globalProvider = new Msal2Provider({
  clientId: "<YOUR_CLIENT_ID>"
});

const loadAgenda = () => {
  if (Providers.globalProvider.state === ProviderState.SignedIn) {
    document.getElementById('main').innerHTML = '<mgt-agenda></mgt-agenda>';
  }
};

Providers.onProviderUpdated(loadAgenda);

后续步骤

历史资料。此文对应 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(示例代码)

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

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