View a markdown version of this page

微软 OneNote 集成 - Amazon Quick
开始前的准备工作配置微软 Entra ID在 Amazon Quick 中设置连接器可用操作管理和故障排除

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

微软 OneNote 集成

借助 Microsoft OneNote 操作连接器，你可以通过自然语言直接在 Amazon Quick 中管理你的 Microsoft 365 账户中的笔记本、分区和页面。连接器使用 Microsoft Graph 进行 OneNote操作。

Amazon Quick 支持微软的两种身份验证方法 OneNote。选择最适合您组织安全要求的方法。

  • 默认 OAuth 应用程序-使用AWS由托管的 OAuth 应用程序。无需其他凭证。用户直接使用其微软 365 帐户进行身份验证。

  • 自定义 OAuth 应用程序 — 使用在 Microsoft Entra ID 中注册的客户管理的应用程序。此选项可让您的组织完全控制 OAuth 配置。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅身份验证方法。

开始前的准备工作

在设置集成之前，请确保您具备以下条件。

  • 一个活跃的 Microsoft 365 帐户，可以访问你要使用的 OneNote笔记本电脑。

  • 对于自定义 OAuth 应用程序：访问微软 Entra ID（前身为 Azure Active Directory）注册应用程序并为其配置微软 Graph 权限。 OneNote

  • 有关 Amazon Quick 订阅要求，请参阅在控制台中设置集成。

配置微软 Entra ID

如果您使用的是默认 OAuth 应用程序身份验证，请跳过本节并继续。在 Amazon Quick 中设置连接器

要进行自定义 OAuth 应用程序身份验证，请在 M icrosoft Entra 管理中心注册应用程序，然后根据需要配置 Microsoft Graph 权限 OneNote （例如Notes.ReadNotes.ReadWrite、或Notes.Read.All）。将 Amazon Quick 回传网址添加https://{region}.quicksight.aws.amazon.com/sn/oauthcallback为重定向 URI。{region}替换为您AWS所在的地区（例如，us-east-1）。有关分步说明，请参阅 Microsoft Graph 文档中的身份验证和授权基础知识。记录应用程序（客户端）ID 和客户端密钥值，您在配置 Amazon Quick 时需要它们。

在 Amazon Quick 中设置连接器

从 “可用” 选项卡连接

如果要使用默认 OAuth 应用程序身份验证，则无需额外配置即可直接从 “可用” 选项卡进行连接。

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 在 “可用” 选项卡上，找到OneNote并选择 Connect。

  3. 完成 Microsoft 登录流程并授予所请求的权限。

要改为使用自定义 OAuth 应用程序配置连接器，请使用为团队创建选项卡，如下所述。

从 “为你的团队创建” 选项卡创建

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 选择 “为你的团队创建” 选项卡。

  3. 查找并选择OneNote。

  4. 输入连接器的名称。（可选）选择 + 添加描述以添加描述。

  5. 对于连接类型，选择公共网络。

  6. 对于 OAuth 配置，请选择以下身份验证方法之一并配置必填字段。

    1. 对于默认 OAuth 应用程序：

      无需其他凭证。选择下一步以继续。

    2. 对于自定义 OAuth 应用程序，请配置以下字段：

      • 基本网址（可选）— 微软 Graph 基础网址。示例：https://graph.microsoft.com/v1.0

      • 客户端 ID — 来自你的 Microsoft Entra ID 应用程序注册的应用程序（客户端）ID。

      • 公共 OAuth 客户端（可选）— 如果您的 Microsoft Entra ID 应用程序配置为公共客户端（无客户端密钥），请选择此选项。

      • 客户密钥 — 来自你的 Microsoft Entra ID 应用程序注册的客户机密值。

      • 令牌网址 — 微软身份平台令牌端点。示例：https://login.microsoftonline.com/common/oauth2/v2.0/token

      • 授权网址-微软身份平台授权端点。示例：https://login.microsoftonline.com/common/oauth2/v2.0/authorize

      • 重定向 URL — Pre-filled 使用 Amazon 快速回传网址。

      注意

      对于租户特定的身份验证，请将令牌网址和授权网址替换common为您的 Microsoft Entra ID 租户 ID。

  7. 选择下一步。

  8. 微软登录窗口打开。查看请求的权限并选择接受。

  9. 在 “查看” 页面上，查看连接器的可用操作。选择下一步。

  10. 在 “发布” 页面上，选择谁可以访问连接器。您可以为组织中的所有人启用访问权限，也可以搜索特定的团队或群组。

  11. 选择发布。

可用操作

设置连接器后，显示的操作便可 OneNote 用。要查看连接器的当前操作集，请转至 Amazon Quick 控制台中连接器的可用操作视图。

管理和故障排除

要编辑、共享或删除您的连接器，请参阅管理现有集成。

身份验证问题

  • Sign-in 失败（默认 OAuth 应用程序或自定义 OAuth 应用程序）— 验证你的 Microsoft 365 帐户是否处于活动状态并且可以直接在网络 OneNote 上登录。对于自定义 OAuth 应用程序，请确认你的 Microsoft Entra ID 应用程序中的重定向 URI 是否与 Amazon Quick 回调网址相匹配。

  • 权限不足 — 验证在你的 Microsoft Entra ID 应用程序上配置的 Microsoft Graph 权限是否包括你要使用的操作所需的 OneNote 范围，并且在需要时已授予管理员同意。

  • 无效的客户端凭据（自定义 OAuth 应用程序）-验证客户端 ID 和客户端密钥是否与你的 Microsoft Entra ID 应用程序注册中的值相匹配。确认客户端密钥尚未过期。