前提条件
サーバー側認証を使用して Platform アプリを設定するには、Box Enterprise アカウントから開発者コンソールにアクセスできることを確認する必要があります。または、Developer アカウントにサインアップすることもできます。
アプリの作成手順
開発者コンソールへの移動
Box にログインし、開発者コンソールに移動して、[Platform アプリの作成] を選択します。
アプリケーションの種類の選択
アプリケーションの種類のリストから [Platform アプリ] を選択します。次の手順を促すウィンドウが表示されます。
アプリケーションの基本情報の指定
アプリを説明するために、アプリの名前と説明を指定します。アプリの目的を選択するには、ドロップダウンリストを使用します。選択したオプションに応じて、さらに詳細を指定することが必要になる場合があります。
| 目的 | 詳細 |
|---|
| [自動化]、[カスタムポータル] | アプリの作成者 (お客様またはパートナー) を指定します。 |
| 統合 | 統合のカテゴリ、外部システム名のほか、アプリの作成者 (お客様またはパートナー) を指定します。 |
| [その他] | アプリの目的と、アプリの作成者 (お客様またはパートナー) を指定します。 |
アプリケーションの認証の選択
クライアント ID とクライアントシークレットを使用してアプリケーション ID を確認する場合は [サーバー認証 (クライアント資格情報許可)] を選択し、[アプリの作成] で確定します。
選択すると、新しいアプリケーションを作成しない限り、別の認証方法に変更できません。
アプリ承認
アプリケーションを使用するには、Box 管理者が Box 管理コンソールでそのアプリケーションを承認しておく必要があります。
開発者コンソールで、目的のアプリケーションの [承認] タブに移動します。
[確認して送信] をクリックして、承認を得るために Box Enterprise 管理者にメールを送信します。このプロセスの詳細については、承認ガイドを参照してください。
Platformアプリケーションの承認方法を確認する
基本的な構成
アプリケーションアクセス
アプリケーションのアクセスレベルにより、アプリからアクセスできるユーザーおよびコンテンツが決まります。デフォルトでは、アプリケーションで問題なく操作できるのは、そのサービスアカウントとすべてのApp Userのコンテンツのみです。企業の既存の管理対象ユーザーにもアクセスするには、開発者コンソールの [構成] タブから [アプリアクセスレベル] に移動し、[アプリ + Enterprise アクセス] に設定します。
アプリケーションスコープ
アプリケーションのスコープにより、アプリケーションが呼び出すことができるエンドポイントとリソースが決まります。各オプションの詳細については、スコープのガイドを参照してください。
CORS ドメイン
アプリケーションが JavaScript でフロントエンドのブラウザコードから API コールを実行する場合は、クロスオリジンリソース共有 (CORS) のために、これらの呼び出しの実行元となるドメインを許可リストに追加する必要があります。すべてのリクエストがサーバー側のコードから発行される場合は、このセクションをスキップできます。
許可リストに完全な URI を追加するには、開発者コンソールの [構成] タブの下部にある [CORS ドメイン] セクションに移動します。
SDK とクライアント資格情報許可の使用
各 SDK のクライアント資格情報許可の詳細については、以下を参照してください。
