使用 Box® 連接器，您可以使用指令 與 Box 磁碟機互動，例如：搜尋和管理檔案：
- 搜尋和管理檔案
- 建立和刪除資料夾
- 擷取檔案與資料夾 URL
註: 此連接器由 Workiva 建立並連接至第三方系統。雖然我們的支援團隊可協助您在工作區內設定此連接器，但我們無法排除故障或協助解決任何源自 Workiva 平台以外的問題。
必要條件
若要設定連接器，您需要
- 整合服務帳號的自訂 Box 應用程式
- 自訂應用程式的企業 ID、客戶 ID 和密碼，以及私人密碼匙
在 Box 中建立服務帳戶整合
在設定 Box 連接器之前，為服務帳戶整合建立自訂 Box 應用程式。 若要設定應用程式的公鑰/私鑰對，您需要
- OpenSSL
- 純文字編輯器，例如Windows Notepad
- 在 Box 中啟用雙重因素驗證 (2FA)
步驟 1：建立自訂 Box 應用程式
- 從Dev Console in Box ，點選Create New App 。
- 選擇自訂應用程式 ，然後按一下下一步 。
- 在Authentication Method 下，選擇OAuth 2.0 with JWT ，然後按一下Next 。
- 輸入唯一的名稱以協助識別應用程式，例如 Workiva Box App，然後按一下Create App，然後按View Your App 。
步驟 2：建立應用程式的 RSA 金鑰對
為了確保連線安全，Box 連接器會使用自訂應用程式的 Rivest-Shamir-Adleman (RSA) 公鑰/私鑰對進行驗證。要在OpenSSL 中建立此密鑰對，請輸入這些指令：
openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -outform PEM -pubout -out public.pem
這些指令會產生兩個檔案：
-
private.pem，包含連接器用來與 Box 進行驗證的用戶端金鑰。 -
public.pem，自訂應用程式的設定需要使用此金鑰。
步驟 3：設定自訂應用程式
- 從Dev Console in Box ，為自訂應用程式選擇Configuration 。
- 在Authentication Method 下，驗證是否已選擇OAuth 2.0 with JWT。
- 在Application Access 下，選擇Enterprise ，然後按一下 Save Changes。
- 在純文字編輯器中，開啟
public.pem檔案，並複製其全部內容，包括標頭行-----BEGIN PUBLIC KEY-----、頁尾行-----END PUBLIC KEY-----，以及任何尾部空格。 - 從Dev Console 中的 Box，選擇Configuration 自訂應用程式，然後按一下Add a Public Key下的Add and Manage Public Keys。
- 貼上
public.pem檔案中的全部內容，然後按一下Verify and Save 。 - 出現提示時，輸入您 Box 帳戶的 2FA 代碼，然後按一下Submit 。
- 在OAuth 2.0 Credentials 下，複製自訂應用程式的用戶端 ID。
步驟 4：在 Box 中授權自訂應用程式
- 從Admin Console in Box ，按一下Apps 。
- 在Custom Apps 標籤上，按一下Authorize New App 。
- 貼上自訂應用程式的用戶端 ID，然後按一下下一步 。
- 在App Authorization 下 ，驗證應用程式是否已授權所有使用者，然後按一下Authorize 。
步驟 5：將服務帳號 ID 新增為 Box 資料夾的合作者
- 從Dev Console 在 Box ，為自訂應用程式選擇Configuration 。
- 複製服務帳號 ID。
- 移至要共用的 Box 資料夾。在 Sharing（共用）一節中，尋找 Collaborators（合作者）一節，然後按一下Invite People 以加入服務帳號 ID。
設定 Box 連接器
注意：為了使連接器可用於組織的鏈結，組織安全性管理員首先要從組態中啟用它。
- 在「鏈結產生器」中，按一下「連線」，然後按一下右上角的「建立」。
- 在Connector Connection 下 ，選擇Box 和預設 CloudRunner。
- 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別連結。
- 在「屬性」(Properties) 下，輸入連結的詳細資料：
摘要資訊 詳細資料 用戶端 ID 輸入自訂 Box 應用程式的用戶端 ID，以用作連接器的服務帳戶整合。 注意： 從Dev Console in Box ，客戶端 ID 會出現在自訂應用程式Configuration 標籤的OAuth 2.0 Credentials 下。
用戶端密碼 輸入自訂應用程式的用戶端秘密。 注意： 從 Box 中的Dev Console ，客戶端秘密會出現在自訂應用程式Configuration 頁籤的OAuth 2.0 Credentials 下方。
用戶端金鑰 輸入為自訂應用程式建立的 private.pem檔案的全部內容，包括標頭行-----BEGIN RSA PRIVATE KEY-----、頁尾行-----END RSA PRIVATE KEY-----，以及任何尾端空格。企業 ID 輸入自訂應用程式的企業 ID。 注意： 從Dev Console in Box，企業 ID 會出現在自訂應用程式General 標籤的App Info 下。
注意：所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。
- 請選取要使用連結的環境，然後按一下「儲存」(Save)。
- 若要測試連線，建立並執行連線 與連接器的Get Folder Info 指令 ，並驗證它是否傳回有效的輸出。
疑難排解
如果與 Box 的連線失敗：
- 確保自訂應用程式已在 Box 中授權。
- 驗證自訂應用程式為連接器輸入的用戶端 ID 和密碼。從 Box 中的Dev Console ，用戶端 ID 和密碼會出現在自訂應用程式Configuration 標籤的OAuth 2.0 Credentials 下。若要重設憑證，請按一下Reset 。
- 確保整個 自訂應用程式的
public.pem和private.pem檔案的內容分別輸入到應用程式和連接器的設定中。包括頁首行、頁尾行及任何尾端空格。如有必要，在 OpenSSL 中建立新的公開/私人金鑰對，並在應用程式和連接器的設定中輸入其內容。 - 確認為連接器輸入的自訂應用程式企業 ID。從 Box 中的Dev Console ，企業 ID 會出現在自訂應用程式General 索引標籤的App Info 下。
- 確認共用的資料夾已將服務帳號 ID 加入為合作者。