為 Dropbox 設定 OAuth
本主題介紹如何針對 OAuth 驗證 Dropbox 資料來源。為每個 Tableau Server 執行個體完成這些步驟。
為 Dropbox 設定 OAuth 包括以下任務:
- 在您的 Dropbox 開發人員入口網站應用程式控制台中建立一個新應用程式。
- 使用作為建立新增的應用程式一部分獲得的資訊設定伺服器。
- (可選)設定特定於站台的 OAuth。
步驟 1:建立新的應用程式
- 登入您的 Intuit 開發人員帳戶,然後選擇「應用程式控制台」。
- 按一下「建立應用程式」按鈕。
- 設定並為應用程式命名,然後選擇「建立應用程式」按鈕。
- 建立應用程式後,巡覽到「權限」索引標籤並確訂有選擇檔案內容讀取權限。
- 巡覽到「設定」索引標籤並使用 Tableau Server 的網路網路位址新增重新導向 URI。
- 將以下內容新增至 URI 結尾:auth/add_oauth_token。例如:
- https://your_server_url.com/auth/add_oauth_token
- 從「設定」索引標籤複製應用程式金鑰、應用程式密碼和重新導向 URI。
步驟 2:為 Dropbox 設定 Tableau Server
在 Tableau Server 電腦上,開啟 bash shell 並執行以下命令:
tsm configuration set -k oauth.dropbox.redirect_uri -v <your_authorized_redirect_uri>
tsm configuration set -k oauth.dropbox.client_id -v <your_app_key>
tsm configuration set -k oauth.dropbox.client_secret -v <your_app_secret>
tsm pending-changes apply
如果擱置組態需要重新啟動伺服器,pending-changes apply
命令會顯示提示,讓您知道即將重新啟動。即使伺服器已停止,也會顯示提示,但在這種情況下不會重新啟動。您可以使用 --ignore-prompt
選項隱藏提示,但這樣做不會改變重新啟動行為。如果變更不需要重新啟動,則不會出現提示即可套用變更。有關詳情,請參閱 tsm pending-changes apply。
可以為站台設定自訂 Dropbox OAuth。
考慮將自訂 OAuth 用戶端設定為 1) 如果是為伺服器設定,則覆寫 OAuth 用戶端;或 2) 啟用支援安全連線到需要唯一 OAuth 用戶端的資料。
設定自訂 OAuth 用戶端時,站台等級設定優先於任何伺服器端設定,並且預設情況下建立的所有新 OAuth 憑證都使用站台等級 OAuth 用戶端。無須重新啟動 Tableau Server 即可使設定生效。
重要提示:在設定自訂 OAuth 用戶端之前建立的現有 OAuth 憑證暫時可用,但伺服器管理員和使用者都必須更新其保存的憑證以幫助確保能不間斷存取資料。
1:準備 OAuth 用戶端 ID、用戶端密碼以及重新定向 URL
在設定自訂 OAuth 用戶端之前,需要以下列出的資訊。準備好這些資訊後,就可以為站台註冊自訂 Oauth 用戶端。
OAuth 用戶端 ID 和用戶端密碼:首先向資料提供者(連接器)註冊 OAuth 用戶端以檢索為 Tableau Server 產生的用戶端 ID 和密碼。
重新導向 URL:注意正確的重新導向 URL。您將在下方的步驟 2 註冊過程中需要它。
https://<伺服器名稱> .com/auth/add_oauth_token
例如,https://example.com/auth/add_oauth_token
2:註冊 OAuth 用戶端 ID 與用戶端密碼
按照下面描述的過程將自訂 OAuth 用戶端註冊到站台。
使用管理員認證登入 Tableau 伺服器站台,並轉到「設定」頁面。
在 OAuth 用戶端登錄檔下,按一下「新增 OAuth 用戶端」按鈕。
輸入所需資訊,包括上述步驟 1 中的資訊:
對於「連線類型」,請選取要設定其自訂 OAuth 用戶端的連接器。
若註冊多個 OAuth 用戶端,則需要 OAuth 執行個體 URL。否則,此為可選選項。
而「用戶端 ID」、「用戶端密碼」和「重新導向 URL」,請輸入在上述步驟 1 中準備的資訊。
按一下「新增 OAuth 用戶端」按鈕以完成註冊過程。
(可選)對所有支援的連接器重複步驟 3。
- 按一下「設定」頁面底部或頂部的「儲存」按鈕以儲存變更。
3:驗證和更新儲存的憑證
為幫助確保能不間斷存取資料,您(和您的站台使用者)必須刪除之前儲存的憑證並再次新增憑證,以使用站台的自訂 OAuth 用戶端。
巡覽至「我的帳戶設定」頁面。
在「儲存的資料來源憑證」下,執行以下動作:
按一下上述步驟 2 中設定的自訂 OAuth 用戶端連接器的現有已儲存憑證旁邊的「刪除」。
在連接器名稱旁邊,按一下「新增」並按照提示,1) 連線到在上述步驟 2 中設定的自訂 OAuth 用戶端,以及 2) 儲存最新的憑證。
4:通知使用者更新已儲存的認證
確保通知站台使用者更新他們為連接器儲存的憑證,該連接器的自訂 OAuth 用戶端即為上述步驟 2 中設定的。站台使用者可以使用更新儲存的認證中描述的過程來更新他們保存的憑證。
用於 OAuth 身份驗證的正向 Proxy
有關為 Tableau Server(僅限 Windows)設定具有 OAuth 身份驗證的正向 Proxy 的詳細資訊,請參見 Tableau 說明中的為 OAuth 身份驗證配置正向 Proxy。(連結在新視窗開啟)