View a markdown version of this page

Microsoft OneDrive 動作整合 - Amazon Quick
開始之前設定 Microsoft Entra在 Amazon Quick 中設定整合可用動作管理和疑難排解

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

Microsoft OneDrive 動作整合

使用 Microsoft OneDrive 動作連接器，透過自然語言直接在 Amazon Quick 中管理 OneDrive 檔案、資料夾和 Excel 工作手冊。

設定此整合包含兩個步驟。首先，在 Microsoft Entra 中註冊應用程式並設定其許可。然後，您可以在 Amazon Quick 中建立整合，並將其連接到您的 Entra 應用程式。如需有關 Amazon Quick 支援的身分驗證方法的資訊，請參閱 身分驗證方法。

開始之前

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

設定 Microsoft Entra

設定 Amazon Quick 之前，請在 Microsoft Entra 中建立應用程式註冊。在移至 Amazon Quick 主控台之前，請先完成 Entra 中的所有以下步驟。

如需應用程式註冊的詳細資訊，請參閱 Microsoft 文件中的使用 Microsoft 身分平台註冊應用程式。

註冊應用程式

  1. 開啟 Microsoft Entra 管理中心。

  2. 在左側導覽中，選擇 Entra ID，然後選擇應用程式註冊。

  3. 選擇新增註冊。

  4. 在名稱中，輸入整合的描述性名稱。

  5. 對於支援的 帳戶類型，僅選擇此組織目錄中的帳戶。

  6. 針對重新導向 URI，選取 Web 並輸入 https://{region}.quicksight.aws.amazon.com/sn/oauthcallback。將 {region} 取代為部署 Amazon Quick 執行個體 AWS 的區域。

  7. 選擇註冊。

  8. 在概觀頁面上，複製應用程式 （用戶端） ID 和目錄 （租戶） ID。您需要這些值才能進行 Amazon Quick 組態。

建立用戶端秘密

Amazon Quick 需要用戶端秘密才能向 Microsoft Entra 進行身分驗證。此秘密可做為應用程式註冊的密碼。

  1. 從您的應用程式註冊中，選擇憑證和秘密。

  2. 選擇新增用戶端秘密。

  3. 輸入描述並選擇過期期間。

  4. 選擇新增。

  5. 立即複製 值。此值只會顯示一次。

重要

複製秘密值，而不是秘密 ID。值是用於身分驗證的較長字串。

設定 API 許可

此整合使用委派的許可，允許應用程式代表登入的使用者採取行動。如需詳細資訊，請參閱 Microsoft 文件中的 Microsoft Graph 許可概觀。

  1. 從您的應用程式註冊中選擇 API 許可。

  2. 選擇新增許可，然後選擇 Microsoft Graph。

  3. 選擇委派許可，然後從下表新增許可。

  4. 選擇授予 【您的租戶名稱】 管理員同意以核准許可。

在 Entra 應用程式註冊中將以下內容新增為委派許可。如需完整許可參考，請參閱 Microsoft 文件中的 Microsoft Graph 許可參考。

OneDrive 動作整合 – 委派許可
權限 Description
Files.ReadWrite 允許應用程式讀取、建立、更新和刪除登入使用者的檔案。
User.Read.All 允許應用程式代表登入使用者讀取組織中所有使用者的完整設定檔屬性集。
offline_access 允許應用程式重新整理存取權杖，而不需要使用者再次登入。這可減少使用者需要重新驗證身分的頻率。

記錄您的登入資料

離開 Microsoft Entra 管理中心之前，請確認您有下列值。您需要它們才能進行 Amazon Quick 組態。

Microsoft Entra 的必要登入資料
Value 在哪裡找到它
應用程式 (用戶端) ID 應用程式註冊概觀頁面
目錄 （租戶） ID 應用程式註冊概觀頁面
用戶端秘密值 憑證與秘密頁面

在 Amazon Quick 中設定整合

完成 Entra 組態後，請在 Amazon Quick 中建立整合。

  1. 在 Amazon Quick 主控台中，選擇整合。

  2. 選擇 Microsoft OneDrive，然後選擇新增 （加 "+") 按鈕。

  3. 選擇動作索引標籤。

  4. 選擇在 Microsoft OneDrive 中執行動作。

  5. 填寫整合詳細資訊：

    • 名稱 – OneDrive 整合的描述性名稱。

    • 描述 （選用） – 整合的目的。

  6. 填寫連線設定：

    • 基本 URL – https://graph.microsoft.com/v1.0

    • 用戶端 ID – 來自您 Entra 應用程式註冊的應用程式 （用戶端） ID。

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

    • 字符 URL – https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token

    • 驗證 URL – https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize

    • 重新導向 URL – https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  7. 選擇建立並繼續。

  8. 選擇要與之共用整合的使用者。

  9. 選擇下一步。

可用動作

設定整合之後，可以使用下列動作。

Microsoft OneDrive 可用的動作
Category Action Description
磁碟機和項目 取得磁碟機 擷取磁碟機的屬性和關係。
磁碟機和項目 列出項目 取得磁碟機中包含的所有項目。
磁碟機和項目 取得項目 取得包含在磁碟機中的項目。
磁碟機和項目 建立資料夾 在使用者的磁碟機中建立新的資料夾。
磁碟機和項目 更新項目 更新檔案或資料夾的中繼資料。
磁碟機和項目 刪除項目 刪除檔案或資料夾。將項目移至資源回收筒。
磁碟機和項目 列出子資料夾 傳回資料夾子項中的項目集合。
磁碟機和項目 複製項目 建立檔案或資料夾的副本到另一個位置。
磁碟機和項目 新增許可 傳送檔案或資料夾的共用邀請。
磁碟機和項目 上傳檔案 上傳新檔案或更新現有檔案。支援高達 250 MB 的檔案。
Excel 工作手冊 清單工作表 擷取工作表物件的清單。
Excel 工作手冊 新增工作表 將新的工作表新增至工作手冊。
Excel 工作手冊 閱讀工作表 擷取工作表物件的屬性。
Excel 工作手冊 更新工作表 更新工作表物件的屬性。
Excel 工作手冊 刪除工作表 從工作手冊中刪除工作表。
Excel 工作手冊 讀取儲存格 依資料列和資料欄號碼取得單一儲存格的值。
Excel 工作手冊 寫入儲存格 依資料列和資料欄號碼設定單一儲存格的值。
Excel 工作手冊 讀取範圍 取得範圍的值。
Excel 工作手冊 寫入範圍 更新範圍的值。
Excel 工作手冊 清除範圍 清除範圍值、格式、填充和邊界。
Excel 工作手冊 刪除範圍 刪除與範圍相關聯的儲存格。
Excel 工作手冊 取得使用範圍 取得包含具有值或格式之儲存格的最小範圍。

管理和疑難排解

若要編輯、共用或刪除整合，請參閱 管理現有的整合。

驗證問題

  • 不正確的應用程式註冊 – 驗證 Microsoft Entra 中的應用程式註冊包含必要的 API 許可，並且已授予管理員同意。

  • 過期的用戶端秘密 – 檢查用戶端秘密是否已在憑證和秘密中過期，並視需要產生新的秘密。

  • 不正確的重新導向 URI – 驗證 Microsoft Entra 中的重新導向 URI 符合 https://{region}.quicksight.aws.amazon.com/sn/oauthcallback。

常見錯誤訊息

  • Access denied. You do not have permission to perform this action – 已驗證的使用者沒有必要的許可。請聯絡您的管理員以驗證並授予適當的許可。

  • AADSTS50020: User account from identity provider does not exist in tenant – 使用者帳戶未在正確的 Microsoft Entra 租用戶中設定。確認使用者帳戶存在於符合應用程式註冊中目錄 （租用戶） ID 的租用戶中。