|
自 2021 年 1 月起，傳統文件類型將不再可用。您可以轉換傳統檔案或下載 PDF。進一步瞭解

Workiva 支援中心

連接到 Microsoft OneDrive 的連接器

連接到 Microsoft OneDrive 的連接器

  • 上次更新時間：

使用 Microsoft® OneDrive® 連接器，您可以在連鎖中使用指令 管理 Microsoft OneDrive 或 SharePoint® 中的檔案和資料夾。例如，使用此連接器，您可以

  • 複製、刪除及搜尋檔案和資料夾
  • 下載和上傳檔案
  • 列出可用的磁碟機
註: 此連接器由 Workiva 建立並連接至第三方系統。雖然我們的支援團隊可協助您在工作區內設定此連接器，但我們無法排除故障或以其他方式協助解決源自 Workiva 平台之外的任何問題。

必要條件

為了啟用連線，連接器使用 Microsoft Graph API。為了確保連線安全，連接器透過Microsoft 應用程式註冊入口網站 或 Azure® Active Directory® 註冊的指定應用程式使用 OAuth 認證。

要設定連接器，您需要：：

Microsoft Azure for OneDrive 設定範例

註冊應用程式

  1. 登入您的 Microsoft Azure 入口網站： https://azure.microsoft.com/en-us/account/
  2. 巡覽 Azure Active Directory 服務。
  3. 巡覽至「管理」(Manage) 下的 App Registrations ，然後按一下 New Registration。
  4. 提供所需的 應用程式名稱 ，然後按 註冊。

配置應用程式驗證

  1. 登入您的 Microsoft Azure 入口網站： https://azure.microsoft.com/en-us/account/
  2. 巡覽 Azure Active Directory 服務。
  3. 導覽至管理下的 應用程式註冊 。
  4. 巡覽至更新後的「管理」面板下的 Authentication 。
  5. 在「支援的帳戶類型」下，選取 任何組織目錄中的帳戶 (任何 Microsoft Entra ID 租用戶 - 多租用戶)。
  6. 在 Add a Platform 下，選取 Web。
  7. 在 Redirect URI 下，輸入上面的有效回傳 URL。
  8. 請務必勾選 支援的帳戶類型 [] 下的 MultiTenant 方塊。
注意： 由於 OneDrive Connector 需要啟用多租戶選項，因此 Azure 管理員必須確保應用程式已針對安全合規性正確配置。如果正確使用 Azure 安全性，此選項不會向所有人開放應用程式。以下是可採取的其他步驟建議。

設定憑證和秘密

  1. 登入您的 Microsoft Azure 入口網站： https://azure.microsoft.com/en-us/account/
  2. 巡覽 Azure Active Directory 服務。
  3. 巡覽至 管理 下的 [ 應用程式註冊 。
  4. 巡覽至更新後的 管理 面板下的 [] 憑證 。
  5. 按一下中央面板中的 New Client Secret 。
  6. 在提供簡短的 說明 和 到期日後，系統會顯示用戶端密碼。這需要儲存以便妥善保存並輸入 Microsoft OneDrive 連接器。

設定 API 權限

  1. 登入您的 Microsoft Azure 入口網站： https://azure.microsoft.com/en-us/account/
  2. 巡覽 Azure Active Directory 服務。
  3. 巡覽至 管理 下的 [ 應用程式註冊 。
  4. 巡覽至更新後的 管理 面板下的 API 權限 。
  5. 按一下中心面板中的 Add a Permission。
  6. 在 Microsoft API 下選擇 Microsoft Graph。
  7. 選擇 Delegate Permissions 作為 Request Type。
  8. 從您需要的權限清單中：
    User.Read、 FILES 和 OpenId.offline_access下的所有權限。
  9. 按一下 Grant Admin Consent。
  10. 定義連接器所需的存取層級。Microsoft OneDrive
    連接器支援以下 範圍 ：
    • Files.ReadWrite.Selected
    • Files.ReadWrite.AppFolder
    • Files.ReadWrite.All
    • Files.ReadWrite
    • Files.Read.Selected
    • Files.Read.All
    • Files.Read
    • offline_access

至少需要 offline_access 範圍。

為什麼需要 Files.Read.All 和 Files.ReadWrite.All

Workiva OneDrive 連接器使用 OAuth 委派權限，透過 Microsoft Graph API 與您的 Microsoft 環境進行通訊，這表示該連接器會代表經過驗證的使用者進行身份驗證並採取行動。

為什麼無法使用 Sites.Selected

Sites.Selected 是專為應用程式層級（純應用程式）存取流程設計的 SharePoint 特定權限；它與 Workiva 連接器使用的委派權限模型不相容。它也限制了對僅預先核准的 SharePoint 網站的存取，從而防止連接器執行搜尋、複製項目及刪除項目等動態、路徑型操作。

 

啟用安全性

  1. 登入您的 Microsoft Azure 入口網站： https://azure.microsoft.com/en-us/account/
  2. 巡覽 Azure Active Directory 服務。
  3. 按一下 管理 下的 [ 企業應用程式 。
  4. 從清單中選擇您的應用程式，以啟動編輯程序。如果預設情況下未列出您的應用程式，請按一下 管理 下的 [ 所有應用程式。
  5. 按一下 管理 [ 下的 屬性。
  6. 在 屬性 畫面上，設定以下屬性以允許使用上面建立的 API 存取權限：

    • 已啟用使用者登入？ = 是

    • 需要使用者指派嗎? = 是

    • (可選) 使用者可以看見嗎？ = 否

  7. 按一下 管理 下的 使用者及群組 [。
  8. 現在，可以根據需要使用標準 Azure AD 流程新增使用者。這
    是允許使用 OneDrive 並擁有適當的 Microsoft OneDrive 授權的使用者清單。

設定 Microsoft OneDrive 連接器

注意：為了使連接器可用於組織的鏈結，組織安全性管理員首先要從組態中啟用它。
  1. 從 Chain Builder中按一下 Connectionscompare_arrows，然後按一下右上角的 Create 。
  2. 在 Connector Connection下，選取 Microsoft OneDrive和預設的 CloudRunner。
    microsoft-onedrive-connector_01.png
  3. 在Basic Info 下，輸入唯一的名稱和描述以協助識別連線器。
  4. 在OAuth 下，輸入連接器 Azure 應用程式的 OAuth 用戶端 ID 和秘密。
    microsoft-onedrive-connector_02.png
  5. 要確定連接器的存取層級，請輸入 Azure 應用程式的身份驗證範圍 。
    至少需要 offline_access 範圍。
  6. 若要授權連線和 OAuth 認證，請按一下Connect 。

  7. 在「屬性」(Properties) 下，輸入連結的詳細資料：
    microsoft-onedrive-connector_03.png

    摘要資訊 詳細資料
    磁碟機類型 選擇要連接的磁碟機類型，例如「磁碟機」、「群組」、「使用者」或「網站」。若要連
    接到您自己的使用者磁碟，請選取 Current User (Me)。
    磁碟機類型 ID 輸入要連接的磁碟機 ID，基於磁碟機類型 。例如，如果 磁碟機類型 為「使用者」，請輸入使用者識別碼；如果是「網站」，請輸入網站 ID。
    注意： 您可以使用 Microsoft 的 圖表總管 從 Sharepoint 擷取這些資料。
  8. 選擇連接使用的環境，然後按一下儲存 。
  9. 若要測試連線，，使用連接器的Download File 指令 建立並執行連線 ，並驗證它是否傳回有效的輸出。

疑難排解

如果與 Microsoft OneDrive 或 SharePoint 的連線失敗：

使用 Microsoft® OneDrive® 連接器，您可以在連鎖中使用指令 管理 Microsoft OneDrive 或 SharePoint® 中的檔案和資料夾。例如，使用此連接器，您可以 複製、刪除及搜尋檔案和資料夾 下載和...