View a markdown version of this page

Dropbox 整合 - Amazon Quick
開始之前設定 Dropbox在 Amazon Quick 中設定連接器可用動作管理和疑難排解

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

Dropbox 整合

使用 Dropbox 動作連接器，您可以透過自然語言直接在 Amazon Quick 中存取 Dropbox 平台。您可以上傳檔案、管理資料夾結構、產生共用連結，以及搜尋內容，而無需離開 Amazon Quick。

Amazon Quick 支援 Dropbox 的多種身分驗證方法。選擇最適合您組織安全需求的方法。

  • 預設 OAuth 應用程式 – 使用 AWS受管 OAuth 應用程式。不需要額外的登入資料。您使用 Dropbox 帳戶直接進行身分驗證。

  • 自訂 OAuth 應用程式 – 使用在 Dropbox 中註冊的客戶受管 OAuth 應用程式。此選項可讓您的組織完全控制 OAuth 組態。

  • API 金鑰 – 使用 Dropbox 存取字符進行身分驗證。此方法適用於個別使用或測試。

如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 身分驗證方法。

開始之前

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

設定 Dropbox

如果您使用的是預設 OAuth 應用程式身分驗證，請略過本節並前往 在 Amazon Quick 中設定連接器。

對於自訂 OAuth 應用程式或 API 金鑰身分驗證，請先完成 Dropbox 中的適用步驟，再設定 Amazon Quick。

為自訂 OAuth 應用程式建立 Dropbox 應用程式

在 Dropbox 應用程式主控台中建立應用程式，以取得 Amazon Quick 所需的用戶端登入資料。

  1. 登入您的 Dropbox 帳戶，然後前往 Dropbox 網站上的 Dropbox 應用程式主控台。

  2. 選擇建立應用程式。

  3. 針對選擇 API，選取範圍存取。

  4. 選擇您需要的存取類型：

    • 應用程式資料夾 – 僅提供特定資料夾的存取權。

    • 完整 Dropbox – 提供存取所有檔案和資料夾的權限。

  5. 輸入應用程式名稱，然後選擇建立應用程式。

  6. 在應用程式設定頁面上，記錄下列值。您在設定 Amazon Quick 時需要它們。

    • 應用程式金鑰 – 這是您的用戶端 ID。

    • 應用程式秘密 – 這是您的用戶端秘密。

  7. 在 OAuth 2 下，於重新導向 URIs區段中，新增 Amazon Quick 回呼 URL： https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  8. 選擇許可索引標籤，然後選取整合所需的範圍。如需建議的範圍，請參閱 建議範圍。

產生 API 金鑰的存取字符

從 Dropbox 應用程式主控台產生存取字符，以進行 API 金鑰身分驗證。

  1. 登入您的 Dropbox 帳戶，然後前往 Dropbox 網站上的 Dropbox 應用程式主控台。

  2. 選擇您的應用程式，或視需要建立新的應用程式。

  3. 在 OAuth 2 下，選擇產生以建立存取權杖。

  4. 複製並安全地存放產生的字符。您在設定 Amazon Quick 時需要它。

建議範圍

當您建立 Dropbox 應用程式時，請根據您要使用的動作，在許可索引標籤上設定下列範圍。

Dropbox 建議範圍
Scope (範圍) Description
account_info.read 讀取帳戶資訊。
account_info.write 更新帳戶資訊。
contacts.read 讀取聯絡資訊。
contacts.write 更新聯絡資訊。
events.read 讀取事件日誌項目。
events.write 建立事件日誌項目。
file_requests.read 讀取檔案請求。
file_requests.write 建立和管理檔案請求。
files.content.read 讀取檔案內容。
files.content.write 建立、修改和刪除檔案。
files.metadata.read 讀取檔案和資料夾中繼資料。
files.metadata.write 編輯檔案和資料夾中繼資料。
files.permanent_delete 永久刪除檔案。
files.team_metadata.read 讀取團隊檔案中繼資料。
files.team_metadata.write 編輯團隊檔案中繼資料。
groups.read 讀取群組資訊。
groups.write 管理 群組。
members.delete 移除團隊成員。
members.read 讀取團隊成員資訊。
members.write 管理團隊成員。
sessions.list 列出作用中工作階段。
sessions.modify 修改作用中工作階段。
sharing.read 讀取共用設定和共用連結。
sharing.write 建立和管理共用連結和資料夾共用。
team_data.content.read 讀取團隊內容。
team_data.content.write 管理團隊內容。
team_data.governance.read 讀取團隊資料控管設定。
team_data.governance.write 管理團隊資料控管設定。
team_data.team_space 存取團隊空間資料。
team_info.read 讀取團隊資訊。
team_info.write 更新團隊資訊。

在 Amazon Quick 中設定連接器

從可用索引標籤連線

如果您想要使用預設 OAuth 應用程式身分驗證，您可以直接從可用索引標籤連線，而不需要其他組態。

  1. 在 Amazon Quick 主控台中，選擇連接器。

  2. 在可用索引標籤上，尋找 Dropbox 並選擇連線。

  3. 完成 Dropbox 登入流程，並授予請求的許可。

若要改為使用自訂 OAuth 應用程式或 API 金鑰設定連接器，請使用為您的團隊建立索引標籤，如下所述。

從為您的團隊建立索引標籤建立

完成任何必要的 Dropbox 組態後，請在 Amazon Quick 中建立連接器。

  1. 在 Amazon Quick 主控台中，選擇連接器。

  2. 選擇為您的團隊建立索引標籤。

  3. 尋找並選擇 Dropbox。

    注意

    如果 Dropbox 連接器已存在，則會顯示一個對話方塊，其中包含您現有的連接器。若要使用現有的連接器，請選擇它。若要建立新的，請選擇否，建立新的。

  4. 輸入連接器的名稱。或者，選擇 + 新增描述以新增描述。

  5. 針對連線類型，選擇公有網路。

  6. 針對 OAuth 組態，選擇下列其中一種身分驗證方法，並設定必要欄位。

    1. 對於預設 OAuth 應用程式：

      不需要額外的登入資料。選擇 Next (下一步) 繼續。

    2. 對於自訂 OAuth 應用程式，請設定下列欄位：

      • 基本 URL （選用） – Dropbox API 基本 URL。範例：https://api.dropboxapi.com

      • 用戶端 ID – 來自 Dropbox 應用程式的應用程式金鑰。

      • 用戶端秘密 – 來自 Dropbox 應用程式的應用程式秘密。

      • 權杖 URL – 權杖端點。範例：https://api.dropboxapi.com/oauth2/token

      • 授權 URL – 授權端點。範例：https://www.dropbox.com/oauth2/authorize

      • 重新導向 URL – 預先填入 Amazon Quick 回呼 URL。

    3. 針對 API 金鑰，設定下列欄位：

      • 基本 URL （選用） – Dropbox API 基本 URL。範例：https://api.dropboxapi.com

      • API 金鑰 – 您的 Dropbox 存取字符。

      • 電子郵件 （選用） – 與您的 Dropbox 帳戶相關聯的電子郵件地址。

  7. 選擇下一步。

  8. 如果您選擇預設 OAuth 應用程式或自訂 OAuth 應用程式，就會開啟 Dropbox 授權視窗。檢閱請求的許可，然後選擇允許。

  9. 在檢閱頁面上，檢閱連接器的可用動作。選擇下一步。

  10. 在發佈頁面上，選擇誰可以存取連接器。您可以為組織中的每個人開啟存取權，或搜尋特定的團隊或群組。

  11. 選擇發布。

可用動作

設定連接器之後，可以使用下列動作。

Dropbox 可用的動作
Category Action Description
檔案 列出檔案 列出資料夾中的檔案。
檔案 取得檔案 讀取檔案的內容。
檔案 匯入檔案 將檔案上傳至 Dropbox。
檔案 搜尋檔案 依名稱或內容搜尋檔案或資料夾。
檔案 更新檔案位置 將檔案或資料夾移至不同的位置。
檔案 取得暫時連結 產生檔案的暫時下載連結。
檔案 取得中繼資料 擷取檔案或資料夾的中繼資料。
檔案 從 URL 儲存檔案 從 URL 將檔案儲存至 Dropbox。
資料夾 建立資料夾 建立新的資料夾。
資料夾 列出資料夾 使用者可以存取的資料夾清單。
批次操作 取得批次移動狀態 檢查批次移動操作的狀態。
共用 建立共用連結 建立檔案或資料夾的共用連結。
共用 列出共用連結 列出檔案或資料夾的共用連結。
共用 更新資料夾共用 與其他使用者共用資料夾。
共用 列出收到的檔案 列出其他使用者已與您共用的檔案。
檔案請求 建立檔案請求 建立檔案請求供其他人上傳檔案。
帳戶 取得使用者 擷取已驗證使用者的相關資訊。
帳戶 取得空間用量 擷取帳戶的儲存空間用量。
注意

您可以使用的動作取決於已驗證使用者可存取的檔案和資料夾。

管理和疑難排解

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

驗證問題

  • 登入失敗 （預設 OAuth 應用程式或自訂 OAuth 應用程式） – 確認您的 Dropbox 帳戶處於作用中狀態，而且您可以直接登入 Dropbox 網站。對於自訂 OAuth 應用程式，請確認 Dropbox 應用程式中的重新導向 URL 符合 Amazon Quick 回呼 URL。

  • 無效用戶端登入資料 （自訂 OAuth 應用程式） – 驗證用戶端 ID 和用戶端秘密是否符合 Dropbox 應用程式中的應用程式金鑰和應用程式秘密值。如果您重新產生應用程式秘密，請更新 Amazon Quick 中的值。

  • API 金鑰遭拒 – 驗證您的存取字符是否處於作用中狀態。在 Dropbox 應用程式主控台中，權杖可能會過期或遭到撤銷。

  • 許可不足 – 確認您的 Dropbox 應用程式具有您要使用的動作所需的許可範圍。