前提条件
サーバー側認証を使用してPlatformアプリを設定するには、Box Enterpriseアカウントから開発者コンソールにアクセスできることを確認する必要があります。または、Developerアカウントにサインアップすることもできます。アプリの作成手順
サーバー認証アプリの作成
- Boxにログインして開発者コンソールに移動します。
- [新規アプリ] をクリックします。
- アプリの種類として [サーバー] を選択します。
- [作成] をクリックします。
切り替えが有効になっている場合は、いつでも [構成] タブで [] に変更できます。詳細については、を参照してください。
アプリ承認
サーバー認証アプリケーションは、使用する前に承認する必要があります。承認プロセスはアカウントの種類によって異なります。 無料のDeveloperアカウント: アプリは作成時に自動的に承認されます。承認が完了しなかった場合は、[構成] タブに、アプリの承認を求めるプロンプトが表示されます。 Enterpriseアカウント: アプリの作成後に [構成] タブで、アプリを送信して管理者の承認を受けるよう求められます。 Enterprise管理者および共同管理者: [構成] タブで、アプリを作成後に直接承認できます。承認プロセスの詳細を確認する
基本的な構成
アプリケーションアクセス
アプリケーションのアクセスレベルにより、アプリからアクセスできるユーザーおよびコンテンツが決まります。デフォルトでは、アプリケーションで問題なく操作できるのは、そのとすべてののコンテンツのみです。企業の既存の管理対象ユーザーにもアクセスするには、開発者コンソールの [構成] タブにある [アプリアクセスレベル] に移動し、[アプリ + Enterpriseアクセス] に設定します。
管理対象ユーザーまたは管理者として認証するには、[構成] タブにある [追加の構成] セクションで、[ユーザーアクセストークンを生成] を有効にします。
アプリケーションスコープ
アプリケーションのスコープにより、アプリケーションが呼び出すことができるエンドポイントとリソースが決まります。各オプションの詳細については、を参照してください。
CORSドメイン
アプリケーションがJavaScriptでフロントエンドのブラウザコードからAPIコールを実行する場合は、クロスオリジンリソース共有 (CORS) のために、これらの呼び出しの実行元となるドメインを許可リストに追加する必要があります。すべてのリクエストがサーバー側のコードから発行される場合は、このセクションをスキップできます。 許可リストに完全なURIを追加するには、開発者コンソールの [構成] タブの下部にある [CORSドメイン] セクションに移動します。