Dropbox の統合

Dropbox アクションコネクタを使用すると、自然言語を通じて Amazon Quick で Dropbox プラットフォームに直接アクセスできます。Amazon Quick を離れることなく、ファイルのアップロード、フォルダ構造の管理、共有リンクの生成、コンテンツの検索を行うことができます。

Amazon Quick は、Dropbox の複数の認証方法をサポートしています。組織のセキュリティ要件に最適な方法を選択します。

• デフォルトの OAuth アプリケーション – AWSが管理する OAuth アプリケーションを使用します。追加の認証情報は必要ありません。Dropbox アカウントで直接認証します。

• カスタム OAuth アプリ – Dropbox に登録されているカスタマー管理の OAuth アプリケーションを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。

• API キー – 認証に Dropbox アクセストークンを使用します。この方法は、個々の使用またはテストに適しています。

Amazon Quick がサポートする認証方法の詳細については、「」を参照してください認証方法。

[開始する前に]

統合を設定する前に、以下があることを確認してください。

• 使用するファイルとフォルダにアクセスできるアクティブな Dropbox アカウント。

• カスタム OAuth アプリの場合: Dropbox ウェブサイトの Dropbox アプリコンソールにアクセスしてアプリを作成します。

• API キーの場合: Dropbox ウェブサイトの Dropbox アプリコンソールから生成されるアクセストークン。

• Amazon Quick サブスクリプションの要件については、「」を参照してくださいコンソールで統合を設定する。

Dropbox の設定

デフォルトの OAuth アプリ認証を使用している場合は、このセクションをスキップして に進みますAmazon Quick でのコネクタのセットアップ。

カスタム OAuth アプリまたは API キー認証の場合は、Amazon Quick を設定する前に Dropbox で該当するステップを完了してください。

カスタム OAuth アプリ用の Dropbox アプリを作成する

Dropbox アプリコンソールでアプリを作成し、Amazon Quick に必要なクライアント認証情報を取得します。

1. Dropbox アカウントにサインインし、Dropbox ウェブサイトの Dropbox アプリコンソールに移動します。

2. [アプリの作成] を選択します。

3. API を選択する で、スコープ付きアクセスを選択します。

4. 必要なアクセスのタイプを選択します。

   • アプリケーションフォルダ – 特定のフォルダにのみアクセスを提供します。

   • Full Dropbox – すべてのファイルとフォルダへのアクセスを提供します。

5. アプリ名を入力し、アプリの作成を選択します。

6. アプリ設定ページで、次の値を記録します。Amazon Quick を設定するときに必要になります。

   • アプリケーションキー – これはクライアント ID です。

   • アプリシークレット – これはクライアントシークレットです。

7. OAuth 2 のリダイレクト URIsセクションで、Amazon Quick コールバック URL を追加します。 https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. アクセス許可タブを選択し、統合に必要なスコープを選択します。推奨されるスコープについては、「」を参照してください推奨されるスコープ。

API キーのアクセストークンを生成する

API キー認証のために Dropbox アプリコンソールからアクセストークンを生成します。

1. Dropbox アカウントにサインインし、Dropbox ウェブサイトの Dropbox アプリコンソールに移動します。

2. アプリを選択するか、必要に応じて新しいアプリを作成します。

3. OAuth 2 で、生成を選択してアクセストークンを作成します。

4. 生成されたトークンをコピーして安全に保存します。Amazon Quick を設定するときに必要になります。

推奨されるスコープ

Dropbox アプリを作成するときは、使用するアクションに基づいて、アクセス許可タブで次のスコープを設定します。

Dropbox が推奨するスコープ

スコープ	説明
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. Connection type で、Public network を選択します。

6. OAuth 設定では、次のいずれかの認証方法を選択し、必須フィールドを設定します。

   1. デフォルトの OAuth アプリの場合:

      追加の認証情報は必要ありません。[次へ] を選択して続行します。

   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 アクセストークン。

      • E メール (オプション) – Dropbox アカウントに関連付けられている E メールアドレス。

7. [次へ] を選択します。

8. デフォルトの OAuth アプリまたはカスタム OAuth アプリを選択した場合、Dropbox 認可ウィンドウが開きます。リクエストされたアクセス許可を確認し、許可を選択します。

9. レビューページで、コネクタで使用可能なアクションを確認します。[次へ] を選択します。

10. 公開ページで、コネクタにアクセスできるユーザーを選択します。組織内のすべてのユーザーに対してアクセスを有効にしたり、特定のチームやグループを検索したりできます。

11. [公開] を選択します。

使用可能なアクション

コネクタを設定すると、次のアクションを使用できます。

Dropbox で使用可能なアクション

Category	[アクション]	説明
ファイル	ファイルのリスト	フォルダ内のファイルを一覧表示します。
ファイル	ファイルの取得	ファイルの内容を読み込みます。
ファイル	ファイルのインポート	Dropbox にファイルをアップロードします。
ファイル	ファイルの検索	名前またはコンテンツでファイルまたはフォルダを検索します。
ファイル	ファイルの場所を更新する	ファイルまたはフォルダを別の場所に移動します。
ファイル	一時リンクの取得	ファイルの一時的なダウンロードリンクを生成します。
ファイル	メタデータを取得する	ファイルまたはフォルダのメタデータを取得します。
ファイル	URL からファイルを保存する	URL から Dropbox にファイルを保存します。
フォルダ	フォルダの作成	新しいフォルダを作成します。
フォルダ	フォルダを一覧表示する	ユーザーがアクセスできるフォルダのリスト。
バッチオペレーション	バッチ移動ステータスの取得	バッチ移動オペレーションのステータスをチェックします。
共有	共有リンクの作成	ファイルまたはフォルダの共有リンクを作成します。
共有	共有リンクを一覧表示する	ファイルまたはフォルダの共有リンクを一覧表示します。
共有	フォルダ共有の更新	フォルダを他のユーザーと共有します。
共有	受信したファイルを一覧表示する	他のユーザーが共有したファイルを一覧表示します。
ファイルリクエスト	ファイルリクエストの作成	他のユーザーがファイルをアップロードするためのファイルリクエストを作成します。
アカウント	ユーザーの取得	認証されたユーザーに関する情報を取得します。
アカウント	スペース使用量の取得	アカウントのストレージスペースの使用状況を取得します。

注記

使用できるアクションは、認証されたユーザーがアクセスできるファイルとフォルダによって異なります。

の管理とトラブルシューティング

コネクタを編集、共有、または削除するには、「」を参照してください既存の統合の管理。

認証問題

• サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ) – Dropbox アカウントがアクティブであり、Dropbox ウェブサイトに直接サインインできることを確認します。カスタム OAuth アプリの場合は、Dropbox アプリのリダイレクト URL が Amazon Quick コールバック URL と一致することを確認します。

• 無効なクライアント認証情報 (カスタム OAuth アプリ) – クライアント ID とクライアントシークレットが Dropbox アプリのアプリキーとアプリシークレットの値と一致していることを確認します。アプリシークレットを再生成した場合は、Amazon Quick の値を更新します。

• API キーが拒否されました – アクセストークンがアクティブであることを確認します。トークンは Dropbox アプリコンソールで期限切れになるか、取り消される可能性があります。

• アクセス許可が不十分 – Dropbox アプリに、使用するアクションに必要なアクセス許可スコープがあることを確認します。