练习 - 使用自定义连接器的图形 API

  • 15 分钟

在本练习中，您将创建自定义连接器并了解如何使用 Microsoft Entra ID 身份验证进行配置以便访问 Microsoft Graph API。 重点关注身份验证，因此本练习仅配置名为上次使用的单项操作。

重要提示

使用已预配 Microsoft Dataverse 的测试环境。 如无社区计划，您可以注册社区计划。

任务 1：新建解决方案

要创建新解决方案，请按照以下步骤操作：

  1. 转到 Power Apps 制作者门户并确保您处于正确的环境中。

  2. 选择解决方案 > + 新建解决方案。

  3. 为显示名称输入Contoso 图，为发布者选择 CDS 默认发布者，然后选择创建。 注意：使用真实项目时，最好创建自己的自定义发布者。

    新建解决方案窗口屏幕截图。

  4. 选择创建后，请勿离开本页面。

任务 2：使用 Graph 浏览器测试 API

在本任务中，您将使用 Graph 浏览器执行要在自定义连接器中配置的 API 操作。

  1. 在另一个新的浏览器选项卡中，转到 Graph 浏览器。

  2. 选择登录。

    “登录 Graph 浏览器”按钮的屏幕截图。

  3. 使用您的用户信息登录。

  4. 阅读请求的权限，在同意后继续。

  5. 确保为动词选择GET，在URL中添加/insights/used，然后选择运行查询。

    “获取菜单、URL 和运行查询”按钮屏幕截图。

  6. 您应收到403错误，指示 Graph 浏览器无权执行本操作。

  7. 选择修改权限选项卡，为 Graph 浏览器授予权限。

  8. 为 Sites.Read.All 选择同意。

  9. 阅读请求的权限，在同意后继续。

  10. 再次选择运行查询。

    您现在应获得确定 - 200状态。

    查询响应预览屏幕截图。

  11. 启动新的浏览器会话选项卡。

  12. 转到 OneDrive 个人云存储 并登录。

  13. 选择+ 新建并选择Word 文档。 您正在创建本文档，以便在上次使用列表中包含一些内容。

    “新建 Word 文档”按钮屏幕截图。

  14. 在 Word 文件中输入一些测试文本。 将自动为您保存文档。

  15. 返回 Graph 浏览器。

  16. 再次运行同一查询。

    您现在应获得包含值的响应。 如果没有看到响应，请返回您在 OneDrive 中创建的文档并进行更改，然后再次运行查询。

  17. 选择响应 JSON，右键单击并选择复制，然后保存。

    选定“复制”功能的 JSON 响应屏幕截图。

    您稍后将在本练习中使用本响应，将在自定义连接器中配置响应时使用。

任务 3：注册新应用程序并添加权限

在本任务中，您将配置从自定义连接器访问图形 API 的新应用程序。 您还将配置特定图形 API 操作的权限，类似于在 Graph 浏览器中修改权限的操作。

  1. 转到 Microsoft Azure 并使用管理员用户凭据登录。

  2. 选择显示门户菜单，然后选择 Microsoft Entra ID。

    Microsoft Entra ID 导航按钮屏幕截图。

  3. 选择应用注册 > + 新建注册。

    “新建应用程序注册”按钮屏幕截图。

  4. 在名称中输入获取上次使用的连接器，选择 Web，在重定向 URI 中输入 https://global.consent.azure-apim.net/redirect，然后选择注册。

    “注册应用程序”窗口的屏幕截图。

  5. 选择API 权限，然后选择+ 添加权限。

  6. 选择Microsoft Graph。

  7. 选择委托的权限。

  8. 搜索站点，然后展开站点。

  9. 选择Sites.Read.All、Sites.ReadWrite.All，然后选择添加权限。

    选择权限窗口屏幕截图。

  10. 您现在应拥有三项 API 权限。 选择证书和密码。

    包含三项 API 权限的证书和密码菜单屏幕截图。

  11. 选择+ 新建客户端密码。

    “新建客户端密码”按钮的屏幕截图。

  12. 在说明中输入上次使用的连接器操作，为过期选择 90 天，然后选择添加。

  13. 复制值并保存以便稍后使用，因为此后将不再显示该值。 您将在创建连接器时使用此用户密码。

    “客户端密码”窗口的屏幕截图。

  14. 选择概述。

  15. 复制应用程序（客户端）ID 并将其保存到记事本中。 您将在创建连接器时使用本客户端 ID。

    包含复制功能的应用程序（客户端）ID 屏幕截图。

任务 4：创建自定义连接器

请按照以下步骤操作创建自定义连接器：

  1. 转到 Power Apps 管理员门户 并确保您处于正确的环境中。

  2. 选择解决方案，然后选择打开您在任务 1：新建解决方案中创建的 Contoso 图解决方案。

  3. 选择 + 新建 > 自动化 > 自定义连接器。

    选定“自定义连接器”的“新建”菜单屏幕截图。

  4. 在连接器名称中输入Contoso 图。

    输入“Contoso 图”作为连接器名称的屏幕截图。

  5. 向下滚动，在主机中输入graph.microsoft.com，在基本 URL中输入/v1.0。

  6. 选择安全性。

    包含“安全性”按钮的主机和基本 URL 字段屏幕截图。

  7. 为身份验证选择 OAuth 2.0。

  8. 选择 Microsoft Entra ID 作为标识提供者。

  9. 将从 Azure 复制的 ID 粘贴到客户端 id 字段中，然后将从 Azure 复制的值粘贴到客户端密码字段中。

  10. 在资源 URL中输入 https://graph.microsoft.com，然后选择创建连接器。

    “创建连接器”按钮屏幕截图。

  11. 请勿离开本页面。

任务 5：添加操作

在本任务中，您将配置名为“图形 API”的上次使用的操作提示。

  1. 选择定义 > + 新建操作。

    “定义”窗口中“新建操作”按钮屏幕截图。

  2. 在摘要中输入上次使用，在操作 ID中输入LastUsed。

  3. 转到请求部分并选择+ 从示例导入。

    请求部分中“从示例导入”按钮屏幕截图。

  4. 动词选择获取，在URL中输入/me/insights/used，然后选择导入。

  5. 向下滚动并选择默认响应。

    响应部分中的默认响应屏幕截图。

  6. 选择+ 从示例导入。

    “从示例导入”按钮屏幕截图。

  7. 在正文字段中粘贴从 Graph 浏览器复制的响应，然后选择导入。

    “正文”字段中的响应和“导入”按钮屏幕截图。

  8. 选择更新连接器。

  9. 请勿离开本页面。

任务 6：测试连接器

按照以下步骤测试连接器：

  1. 选择测试选项卡，然后选择 + 新建连接。

    “测试”选项卡“新建连接”按钮屏幕截图。

  2. 提供您的凭据。

  3. 阅读请求的权限并继续。

  4. 选择刷新连接。

  5. 选择测试操作。

    突出显示“测试操作”按钮的屏幕截图。

    您应看到200状态，响应应与下图相似。

    200 状态和响应示例屏幕截图。