Dropbox アプリの設定方法は?
Dropbox アプリを作成し、ワークフローに必要な権限を選択して、Template 認証情報を使って接続します。OAuth リダイレクトとトークン交換は Transloadit が処理するため、独自のコールバックを実装したり、一時的なアクセストークンを Template に貼り付けたりする必要はありません。
アプリの作成
アプリを所有するアカウントで Dropbox App Console にサインインします。Create app、Scoped accessの順に選択します。
ワークフローでアプリ専用フォルダー内のファイルのみが必要な場合は、App folderを選択します。接続先アカウントのほかの場所にあるファイルが必要な場合にのみ、Full Dropboxを選択します。アプリに名前を付け、Create appを選択します。
App folderアクセスでは、Robot のパスは Dropbox アカウントのルートではなく、アプリのフォルダーを基準とする相対パスになります。Robot のパスには、アカウントを基準としたアプリフォルダーへのパスを含めないでください。
権限の選択
アプリのPermissionsタブを開き、ワークフローに必要なスコープを有効にします。
| ワークフロー | スコープ |
|---|---|
| /dropbox/import によるファイルのインポート | files.metadata.read と files.content.read |
| /dropbox/store によるファイルのエクスポート | files.content.write |
create_sharing_link: true を指定したエクスポート | sharing.write も有効化 |
Full Dropboxアクセスで
Dropbox Business のチームスペースからインポートする場合は、Transloadit がアカウントのファイル名前空間を解決できるよう、account_info.read が選択されていることを確認してください。インポートとエクスポートの両方を行うワークフローでは、両方のファイル権限を有効にします。アプリを接続する前に、Submitを選択して変更を保存します。
リダイレクト URI の登録
アプリのSettingsタブで、OAuth 2を見つけ、Redirect URIsに次の値をそのまま追加します。
https://webapi.transloadit.com/credentials/dropbox
Addを選択して登録します。これは Transloadit のコールバックであり、自分のウェブサイトの URL ではありません。次の手順で使うため、アプリのApp keyと App secretを手元に用意しておきます。シークレットは、ブラウザーのコード、スクリーンショット、共有する Template に絶対に含めないでください。
アプリと Transloadit の接続
Assembly を実行する Workspace で、Template 認証情報の作成方法に従って操作します。サービスとして Dropbox を選択し、認証情報にわかりやすい名前を付けます。アプリの設定から Dropbox アプリキーと Dropbox アプリシークレットを入力します。
作成を選択すると、Dropbox の認可ページが開きます。ワークフローで使用するファイルがある Dropbox アカウントにサインインし、要求されたアクセスを承認します。Dropbox から Transloadit に戻ると、認証情報が保存されます。Robot の credentials の値としてその名前を使う前に、Workspace の認証情報ページに表示されていることを確認してください。
アプリの作成と認可は別の操作です。認可をキャンセルした場合やエラーが発生した場合は、認証情報が保存されたと判断しないでください。リダイレクト URI とアプリの権限を確認してから、接続をやり直します。Dropbox の同意画面でアカウントと要求されたアクセスを確認し、付与する意図のあるアクセスのみを承認してください。
後からアプリの権限を変更しても、既存の認可にその権限は追加されません。新しい Template 認証情報を作成してアクセスを再度承認し、その新しい名前を使うように Template を更新してください。置き換えられた認証情報は、どのワークフローでも使われていないことを確認してから廃止します。Transloadit からパスワードの再確認を求められた場合は、その手順を完了してから接続を再開してください。