使用 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 加入為合作者。