Boxとreckonerを連携するには、選択する認証方式（OAuth認証 または JWT認証）に応じた設定が必要です。

事前確認

• OAuth認証の場合： 画面上のログイン操作のみで完了します（config.json の準備やコラボレーション設定は不要です）。ログインしたユーザーがアクセス権を持つフォルダをそのまま操作できます。
  ※ただし「Box管理コネクタ」はご利用いただけません。

• JWT認証の場合： Box開発者コンソールで接続キー（config.json）の発行・承認作業のほか、自動生成される専用サービスアカウントへのコラボレーション（フォルダ共有）設定が必要です。

必要情報

OAuth認証の場合

※OAuth認証の場合は、Box管理コネクタは利用できません。
※OAuth認証の場合、config.json の取得やファイル添付は不要です。

JWT_AUTH認証の場合

操作方法

注意 
以下の手順は JWT_AUTH認証を利用する場合のみ必要な手順です。（OAuth認証の場合は、reckoner画面上でBoxにログイン・承認するだけで完了するため、以下の操作は不要です。）

Box側での事前設定（アプリ作成・キー発行）

1. 開発者コンソールを開く
2. Platformアプリページよりアプリを新規作成する

3. アプリ作成画面に必要情報を入力し、作成をクリック

   項目名	入力情報
   アプリ名	任意の情報を入力
   アプリタイプ	サーバーを選択
   認証方法	JWTを選択

   

4. Platformアプリページより作成したアプリを選択し、「構成」タブを選択

5. アプリアクセスレベルとスコープを選択

   利用目的（ファイルを操作するのか、ユーザーやグループを管理するのか）に合わせて、必要な権限を設定（許可）してください。

   権限カテゴリ	設定項目 / 目的	BOX	BOX管理
   アプリアクセスレベル	アプリアクセスのみ （特定フォルダのみアクセスする【推奨】）	○	—
   	アプリ + Enterpriseアクセス （社内全体の全領域・全ユーザーへアクセスする）	○	○
   コンテンツ操作 (ファイル・フォルダ)	すべてのファイルとフォルダへの読み取り	○	※必要に応じて
   	すべてのファイルとフォルダへの書き込み	○	※必要に応じて
   管理操作 (ユーザー・グループ)	ユーザーを管理する	—	○
   	グループを管理する	—	○
   高度な機能 / 追加の構成	ユーザーアクセストークンを生成する （アクセストークンの発行を許可する）	○	○

6. 公開キーの追加と管理にて、公開/秘密キーペアを作成する

   自動的に config.json ファイルがダウンロードされます。
   (※ファイルの中身をすべてコピーし、reckonerの接続設定画面へ貼り付けてください。再発行不可のため確実に保存してください)
   

7. アプリの承認依頼を行う

   画面右側の「アプリの詳細」パネルを開きます（※表示されていない場合は画面右上のサイドバーアイコンをクリックします）。

   「ステータス」欄にある青色の ［承認］ ボタンをクリックして、Box管理者へ承認申請を送信します。
    

8. 管理者よりアプリが承認されると6の手順で作成した認証情報が有効となります
   

サービスアカウントの設定（フォルダへのアクセス権付与）

💡 なぜこの作業が必要なのか（コラボレーションの仕組み）

「BOX（ファイル操作）」で推奨の 「アプリアクセスのみ」 を設定した場合、作成されたサービスアカウント（連携用の自動処理用アカウント）は、初期状態では社内のどのフォルダにもアクセスできません。
連携したいBoxフォルダにサービスアカウントをメンバーとして招待（Boxの機能名：コラボレーション）することで、初めてreckonerからそのフォルダ内の操作が可能になります。

1. サービスアカウントIDの確認
   • Box開発者コンソールで対象アプリの画面を開きます。

   • サービスアカウント情報にある Service Account ID（AutomationUser_〜@boxdevedition.com）をコピーします。

      

2. フォルダへのアクセス権付与（コラボレーション招待）

• reckonerでファイルを読み書きしたいBox上の対象フォルダを開き、画面右上にある ［共有］（またはコラボレーション）ボタンをクリックします。
• 「ユーザーを招待」欄に、コピーした サービスアカウントID を貼り付けます。
• 権限レベルを ［編集者］（または目的に応じた権限）に指定して ［送信］ をクリックします。

記載手順と最新バージョンが異なる場合がございます。その場合はサービスサイトをご確認下さい。

関連する設定

• 【転送元】Boxはこちら。
• 【転送先】Boxはこちら。
• 【転送先】Box管理はこちら。