dejiren TOP/よくある質問

FAQ

よくある質問

boxとdejirenの接続設定の方法

(※記事更新日 2022/08/22)

本記事では、dejirenとboxとの接続連携方法について解説します。

※boxとの連携には、事前にboxのアカウント作成が必要です。
※設定途中でbox管理者によるカスタムアプリの承認が必要となり、未承認の場合は設定を完了しても接続を行うことができません

手順1 boxアカウントの2段階認証を設定する

接続用アプリを作成する開発者コンソールを使用する前提条件として、設定担当者のアカウントを2段階認証が有効な状態にする必要があります。

boxにログインして、画面右上のアカウント画像をクリック
[アカウント設定] を選択
2段階認証の[設定]をクリック
認証方法を選択し、[次へ]をクリック

二種類の設定方法があるため、設定方法ごとに説明を行います

[認証アプリ] で2段階認証を行う手順

事前にインストールした認証アプリでQRコードを読み取り、
認証アプリに表示される認証コードを入力して[送信]をクリック

アカウント設定画面に上記のように表示されれば設定完了

[SMSテキストメッセージ] で認証を行う手順

SMSメッセージを送信する携帯電話番号を入力して[続行]をクリック
アカウント設定画面に上記のように表示されれば設定完了

手順2 開発コンソールでboxアプリを作成する

boxの開発コンソール を開き、[アプリの新規作成] をクリック
[カスタムアプリ] を選択
[サーバー認証(JWT使用)] を選択し、アプリ名を設定して [アプリの作成] をクリック

手順3 アプリ構成の設定を行う

[構成]タブを下にスクロールし、[アプリアクセスレベル] で [アプリ+Enterpriseアクセス] を選択
[アプリケーションスコープ] を画像のように設定
[高度な設定] をすべてチェック
[公開キーの追加と管理] で [公開/秘密キーペアを生成] をクリック
ダウンロードした構成ファイルを保存
※後ほど、dejirenの接続設定で使用します
画面右上の [変更を保存] をクリック

手順3 Webhookの設定を行う

タブを [webhook] に切り替え、[プライマリキー] と [セカンダリキー] の [キーを生成] をクリック
生成した [プライマリキー] と [セカンダリキー] をコピーして、クリップボードなどに保存
※後ほど、dejirenの接続設定で使用します

手順4 アプリの承認を依頼する

タブを [承認] に切り替え、[確認して送信] をクリック
[アプリの説明] を記入して、[送信] をクリック

Tips box管理者によるカスタムアプリの承認手順

  1. 管理コンソールを開きます。
  2. 左のサイドバーで、[アプリ] をクリックします。
  3. ウィンドウの上部で、[カスタムアプリマネージャ] をクリックします。
  4. [サーバー認証アプリ] をクリックします。使用可能なアプリに関する情報 (承認や有効化のステータスを含む) が表示されます。
  5. アプリの名前にカーソルを合わせ、[表示] をクリックします。  承認および有効化のオプションが表示されます。
  6. 適用する承認および有効化のオプションを確認した後、[適用] をクリックします。

手順5 個人認証用のアプリを作成する

開発コンソールの画面左側メニューからマイアプリを選択し、[アプリの新規作成] をクリック
[カスタムアプリ] を選択
[ユーザー認証(Oauth 2.0)] を選択し、アプリ名を設定して [アプリを作成] をクリック

手順6 アプリ構成の設定を行う(個人認証用)

[構成]タブを下にスクロールし、[Oauth 2.0資格情報] の [クライアントID] と
[クライアントシークレット] をコピーして、クリップボードなどに保存
※後ほど、dejirenの接続設定で使用します
[Oauth 2.0リダイレクトURL] に 「https://www.dejiren.com/api/va/v1/oauth-callback」を入力
[アプリケーションスコープ]内の [Boxに格納されているすべてのファイルとフォルダの読み取り]
にチェックが入っていることを確認
画面右上の [変更を保存] をクリック

手順7 dejirenの接続設定を作成する

dejirenの接続設定を開き、画面右上の [新しい接続設定をつくる] をクリック
連携先の一覧から [box] を選択し、[つぎへ] をクリック
接続設定の名称を入力
[アプリ構成設定のJSONファイル] に、構成ファイルをBase64形式に変換したものを入力
※構成ファイルの変換手順は次のTipsを参照

Tips 構成ファイルの変換方法

変換方法の一例として、https://www.base64encode.org/ を使用した場合の手順をご案内します。

構成ファイルの変換方法については、以上となります。

手順6で保存した [クライアントID] と [クライアントシークレット] をコピー&ペースト
VAが使用するメールアドレスを入力
※VAがbox上でファイル編集などを行った場合の操作ユーザとなります

手順3で保存した[プライマリキー]と[セカンダリキー]をコピー&ペースト
[ユーザーごとに認証が必要] にチェック
[接続確認] をクリック
接続確認のメッセージが表示されます
接続成功のメッセージを確認したら、画面右下の[作成する] をクリック

以上でboxの接続設定は完了です。


キーワードから探す

キーワードから探す


カテゴリから探す

カテゴリから探す