View a markdown version of this page

Microsoft OneNote 整合 - Amazon Quick

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Microsoft OneNote 整合

使用 Microsoft OneNote 動作連接器,您可以透過自然語言直接從 Microsoft 365 帳戶管理筆記本、區段和頁面。連接器使用 Microsoft Graph for OneNote 操作。

Amazon Quick 支援 Microsoft OneNote 的兩種身分驗證方法。選擇最適合您組織安全需求的方法。

  • 預設 OAuth 應用程式 – 使用AWS受管 OAuth 應用程式。不需要額外的登入資料。使用者直接透過其 Microsoft 365 帳戶進行身分驗證。

  • 自訂 OAuth 應用程式 – 使用在 Microsoft Entra ID 中註冊的客戶受管應用程式。此選項可讓您的組織完全控制 OAuth 組態。

如需 Amazon Quick 支援的身分驗證方法的詳細資訊,請參閱 身分驗證方法

開始之前

在設定整合之前,請確定您有下列項目。

  • 作用中的 Microsoft 365 帳戶,可存取您要使用的 OneNote 筆記本。

  • 對於自訂 OAuth 應用程式:存取 Microsoft Entra ID (先前稱為 Azure Active Directory) 以註冊應用程式並設定 OneNote 的 Microsoft Graph 許可。

  • 如需 Amazon Quick 訂閱需求,請參閱 在主控台中設定整合

設定 Microsoft Entra ID

如果您使用的是預設 OAuth 應用程式身分驗證,請略過本節並繼續 在 Amazon Quick 中設定連接器

對於自訂 OAuth 應用程式身分驗證,請在 Microsoft Entra 管理中心註冊應用程式,並為 OneNote 設定 Microsoft Graph 許可 (例如 Notes.ReadNotes.ReadWriteNotes.Read.All,視需要)。新增 Amazon Quick 回呼 URL https://{region}.quicksight.aws.amazon.com/sn/oauthcallback 做為重新導向 URI。將 {region} 取代為您的AWS區域 (例如 us-east-1)。如需step-by-step說明,請參閱 Microsoft Graph 文件中的身分驗證和授權基本概念。記錄應用程式 (用戶端) ID 和用戶端秘密值 — 您在設定 Amazon Quick 時需要它們。

在 Amazon Quick 中設定連接器

從可用索引標籤連線

如果您想要使用預設 OAuth 應用程式身分驗證,您可以直接從可用索引標籤連線,而不需要其他組態。

  1. 在 Amazon Quick 主控台中,選擇連接器

  2. 可用索引標籤上,尋找 OneNote 並選擇連線

  3. 完成 Microsoft 登入流程,並授予請求的許可。

若要改為使用自訂 OAuth 應用程式設定連接器,請使用為您的團隊建立索引標籤,如下所述。

從為您的團隊建立索引標籤建立

  1. 在 Amazon Quick 主控台中,選擇連接器

  2. 選擇為您的團隊建立索引標籤。

  3. 尋找並選擇 OneNote

  4. 輸入連接器的名稱。或者,選擇 + 新增描述以新增描述。

  5. 針對連線類型,選擇公有網路

  6. 針對 OAuth 組態,選擇下列其中一種身分驗證方法,並設定必要欄位。

    1. 對於預設 OAuth 應用程式

      不需要額外的登入資料。選擇 Next (下一步) 繼續。

    2. 對於自訂 OAuth 應用程式,請設定下列欄位:

      • 基本 URL (選用) – Microsoft 圖形基本 URL。範例:https://graph.microsoft.com/v1.0

      • 用戶端 ID – 來自您 Microsoft Entra ID 應用程式註冊的應用程式 (用戶端) ID。

      • Public OAuth 用戶端 (選用) – 如果您的 Microsoft Entra ID 應用程式設定為公有用戶端 (無用戶端秘密),請選取此選項。

      • 用戶端秘密 – 來自您 Microsoft Entra ID 應用程式註冊的用戶端秘密值。

      • 權杖 URL – Microsoft 身分平台權杖端點。範例:https://login.microsoftonline.com/common/oauth2/v2.0/token

      • 授權 URL – Microsoft 身分平台授權端點。範例:https://login.microsoftonline.com/common/oauth2/v2.0/authorize

      • 重新導向 URL – 預先填入 Amazon Quick 回呼 URL。

      注意

      對於租戶特定的身分驗證,請將字符 URL 和授權 URL common中的 取代為您的 Microsoft Entra ID 租戶 ID。

  7. 選擇下一步

  8. Microsoft 登入視窗隨即開啟。檢閱請求的許可,然後選擇接受

  9. 檢閱頁面上,檢閱連接器的可用動作。選擇下一步

  10. 發佈頁面上,選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權,或搜尋特定的團隊或群組。

  11. 選擇發布

可用動作

設定連接器之後,就可以使用 OneNote 公開的動作。若要查看連接器目前的動作集,請前往 Amazon Quick 主控台中連接器的可用動作檢視。

管理和疑難排解

若要編輯、共用或刪除連接器,請參閱 管理現有的整合

驗證問題

  • 登入失敗 (預設 OAuth 應用程式或自訂 OAuth 應用程式) – 確認您的 Microsoft 365 帳戶處於作用中狀態,而且您可以直接在 Web 上登入 OneNote。對於自訂 OAuth 應用程式,請確認 Microsoft Entra ID 應用程式中的重新導向 URI 符合 Amazon Quick 回呼 URL。

  • 許可不足 – 確認在 Microsoft Entra ID 應用程式中設定的 Microsoft Graph 許可包含您要使用之操作所需的 OneNote 範圍,並視需要授予管理員同意。

  • 無效用戶端登入資料 (自訂 OAuth 應用程式) – 驗證用戶端 ID 和用戶端秘密是否符合 Microsoft Entra ID 應用程式註冊中的值。確認用戶端秘密尚未過期。