Skip to main content
このガイドでは、Platformアプリとのウェブアプリ統合を設定する方法について説明します。
サーバー側統合のサポートは終了しました。つまり、サーバー側の処理を使用するアプリケーションは引き続き動作しますが、事前コールバックのURLやBasic認証など、サーバー側の構成オプションを変更することはできなくなります。これらのオプションを無効化し、実装を新しいものに変更できます。

​
OAuth 2.0アプリケーションの作成

開発者コンソールに移動し、を利用するを作成します。

​
新しい統合の作成

次に、[統合] タブに移動し、[ウェブアプリ統合を作成] をクリックします。
[統合] タブ

​
統合の構成

統合を構成するには、各値について、以下のガイダンスに従います。

​
アプリ情報

​
コールバック構成

​
コールバックパラメータ

[コールバックパラメータ] セクションでは、ユーザーが確認プロンプトを受け入れるとBoxからコールバックURLに送信されるパラメータを構成します。この設定が構成されていない場合、BoxからコールバックURLにパラメータが送信されません。パラメータを追加するには、[メソッド] (GETまたはPOST) を選択し、[パラメータ名] を指定して、[パラメータ値] を追加します。
Fileメソッドのサポートは終了しました。すでにこのメソッドを使用している場合は、その値を編集できません。FileメソッドをGETまたはPOSTに変更することはできますが、この操作を元に戻すことはできません。
例: GET - userid - #user_id#。 以下のパラメータ値が使用可能です。

​
統合ステータス

  • 開発: 統合は、[一般設定] タブで表示されるアプリケーションコラボレータのみが表示および使用できます。このオプションは、アプリケーションがまだ開発中でテストの実施中である場合に最もよく使用されます。
  • オンライン: 統合は、すべてのBoxユーザーが表示し、使用できます。このオプションは、開発が完了し、アプリケーションを統合で公開する準備ができている場合に最もよく使用されます。
  • メンテナンス: 統合は、[一般設定] タブで表示されるアプリケーションコラボレータのみが表示および使用できます。このオプションは、統合が [統合] で公開された後、メンテナンスでの更新を実行したり問題をトラブルシューティングしたりする必要がある場合に最もよく使用されます。このオプションを使用すると、アプリケーションのコラボレータ以外のすべてのユーザーに対して統合が一時的にオフラインになります。

​
Box統合のユースケースの例

ユーザーがポップアップ統合を選択すると、Boxから事前コールバックのURLにコールバックリクエストが送信されます。これにより、構成済みのコールバックパラメータがサーバーに送信されます。クライアントが必要なデータを最初のリクエストからすべて取得できない場合は、Boxが2番目のリクエストを送信することもあります。 次の例では、クライアントコールバックのURLが必要ありません。
  • ポップアップ統合で、download_file_urlコールバックパラメータを使用してREST呼び出しを実行する。
  • ユーザーが確認プロンプトで [OK] をクリックしてポップアップを受け入れる。
  • Boxが次のURLにリクエストを送信する (事前コールバックのURLにコールバックパラメータを追加): http://www.doceditor.com/service?apikey=abc&file=&redirect=。
  • コールバックURLからのレスポンスにより、リクエストを送信したユーザーにユーザーインターフェースが表示される。ポップアップには、アクションを続行するために必要なすべての情報が表示されているため、追加のクライアントコールバックは必要ありません。
次の例では、クライアントコールバックのURLが必要です。
  • ポップアップ統合で、ファイルコールバックパラメータを使用してREST呼び出しを実行する。
  • ユーザーが確認プロンプトで [OK] をクリックしてポップアップを受け入れる。
  • ポップアップによって表示されたページで、Boxからリモートサーバーに、ファイルのコンテンツを含むPOSTリクエストとともにコールバックパラメータが送信される。
  • Boxがリモートサーバーからレスポンスを受信し、クライアントにクライアントコールバックのURLへのレスポンスを投稿するよう指示する。このURLで識別されたサーバーがレスポンスを解釈し、適切なセッションIDを持つユーザーをリダイレクトします。

​
クライアントコールバックのURLのリクエスト形式

BoxからクライアントコールバックのURLに送信されるPOSTリクエストは、事前コールバックのURLからレスポンスを取得し、元のコールバックと同じデータとともにレスポンスを同じURLに転送します。 クライアントコールバックリクエストへのレスポンスはHTTPステータス302で、ユーザーは正しいURLにリダイレクトされるか、UIのHTMLにリダイレクトされます。 ほとんどの場合、このURLは、ウェブアプリ統合のために開発された個々のAPIまたはカスタムスクリプトを指します。これは、事前コールバックのURLの結果を解析します。
Box PlatformアプリをすべてのBoxユーザーが利用できるように公開する場合は、そのURLがインターネット上でパブリックにアクセスできることを確認してください。

​
統合の一般公開

Box統合を一般公開するには、統合をApp Centerに掲載する必要があります。詳細については、ガイドに従ってください。
最終更新日 2026年6月9日