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

使用 Microsoft Microsoft Teams生成一个"Graph Toolkit

· 52CE 我爱测

本主题介绍如何开始在解决方案Graph Toolkit Microsoft Microsoft Teams Microsoft 应用程序。 本指南适用于在 SSO 应用中没有单一登录 (单页) 不需要后端。 如果要使用自定义后端实现 SSO,请参阅使用 SSO Microsoft Teams生成 (选项卡) 。

本主题介绍如何开始在解决方案Graph Toolkit Microsoft Microsoft Teams Microsoft 应用程序。 本指南适用于在 SSO 应用中没有单一登录 (单页) 不需要后端。 如果要使用自定义后端实现 SSO,请参阅使用 SSO Microsoft Teams生成 (选项卡) 。

生成选项卡涉及以下步骤:

  1. 添加 Microsoft Graph Toolkit。
  2. 创建身份验证弹出窗口页面。
  3. 创建应用/客户端 ID
  4. 初始化 MSAL2 Teams。
  5. 添加组件。
  6. 测试你的应用。

添加 Microsoft Graph Toolkit

可以在应用程序中使用 Microsoft Graph Toolkit,方法为直接通过 unpkg (加载程序) 安装 npm 包。 若要使用Toolkit,你还需要 Microsoft Teams SDK。

unpkg

若要通过Toolkit使用 Teams SDK,请向代码添加脚本中的引用:

<!-- Microsoft Teams sdk must be referenced before the toolkit -->
<script src="https://unpkg.com/@microsoft/teams-js/dist/MicrosoftTeams.min.js" crossorigin="anonymous"></script>
<script src="https://unpkg.com/@microsoft/mgt/dist/bundle/mgt-loader.js"></script>

npm

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

npm install @microsoft/teams-js @microsoft/mgt-element @microsoft/mgt-teams-msal2-provider @microsoft/mgt-components

创建身份验证弹出页

为了允许用户登录,你需要在应用中打开一个页面Teams弹出窗口中打开该页面以遵循身份验证流。 页面的路径可以是任何内容,只要它位于你的应用应用路径 (例如, https://yourdomain.com/tabauth)。 此页面的唯一要求是调用 方法 TeamsMsal2Provider.handleAuth() ,但您可以添加任何内容或加载您想要的进度。

下面是处理弹出窗口中的身份验证流的基本页面示例。

unpkg

<!DOCTYPE html>
<html>
  <head>
    <script src="https://unpkg.com/@microsoft/teams-js/dist/MicrosoftTeams.min.js" crossorigin="anonymous"></script>
    <script src="https://unpkg.com/@microsoft/mgt/dist/bundle/mgt-loader.js"></script>
  </head>

  <body>
    <script>
      mgt.TeamsMsal2Provider.handleAuth();
    </script>
  </body>
</html>

npm

import { TeamsMsal2Provider } from '@microsoft/mgt-teams-msal2-provider';

TeamsMsal2Provider.handleAuth();

创建应用/客户端 ID

若要获取客户端 ID,您需要注册一个Azure Active Directory应用程序。 按照创建应用应用Azure Active Directory中的步骤操作。

请确保在应用 redirect URI 注册中将 设置为指向你在上一步中创建的身份验证页面。 例如,https://localhost:3000/tabauth。

注意: 请确保将 设置为 redirect URI Single Page Application (SPA)。 Teams MSAL2 提供程序在后台使用 MSAL2 提供程序。

初始化 MSAL2 Teams

Microsoft Graph 工具包提供程序为组件启用身份验证和对 Microsoft Graph 的访问。 若要了解详细信息,请参阅使用提供程序。 MSAL2 提供程序Teams MSAL2 提供程序处理需要通过 Teams SDK 实现以对用户进行身份验证的所有逻辑和交互。

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

html

将组件 mgt-teams-msal2-provider 添加到 HTML 页面,如下所示。

<mgt-teams-msal2-provider 
  client-id="<YOUR_CLIENT_ID>"
  auth-popup-url="/tabauth"
  scopes="User.Read,Mail.ReadBasic"
  ></mgt-teams-msal2-provider>

将 <YOUR_CLIENT_ID> 替换为应用程序的客户端 ID,将 替换为 auth-popup-url 身份验证页面的完整路径或相对路径。

js

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

import {Providers} from '@microsoft/mgt-element';
import {TeamsMsal2Provider} from '@microsoft/mgt-teams-msal2-provider';
import * as MicrosoftTeams from "@microsoft/teams-js";

TeamsMsal2Provider.microsoftTeamsLib = MicrosoftTeams;

Providers.globalProvider = new TeamsMsal2Provider({
  clientId: `<YOUR_CLIENT_ID>`,
  authPopupUrl: '/tabauth',
  scopes: ['User.Read','Mail.ReadBasic'],
});

将 <YOUR_CLIENT_ID> 替换为应用程序的客户端 ID,将 替换为 authPopupUrl 身份验证页面的完整路径或相对路径。


添加组件

现在,你已准备好添加任何 Microsoft Graph Toolkit组件。 可能需要添加的第一个组件是登录组件。

<mgt-login></mgt-login>

登录组件呈现"登录"按钮,该按钮将指导用户完成登录过程,并集成任何提供程序以处理身份验证。 用户登录后,所有其他工具包组件将能够自动调用 Microsoft Graph。 提供程序还会公开经过身份验证的 Microsoft Graph客户端,以执行 API 调用或获取访问令牌。 有关详细信息,请参阅 使用提供程序。

如果你使用的是 React,我们建议改为React库中的组件mgt-react。 若要了解更多信息,请参阅将 Microsoft Graph Toolkit与 React

后续步骤

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

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

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