外部コンテンツのインデックス作成のための Box の構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • Box 開発者コンソールで OAuth 2.0 アプリケーションを作成して承認し、Box外部コンテンツコネクタがBoxソースシステムにアクセスできるようにします。

    始める前に

    Box 開発者コンソールと Box アドミン UI ポータルへのアドミンアクセス権が必要です。

    Box外部コンテンツコネクタの秘密鍵/公開鍵のペアを作成し、公開鍵証明書を PEM エンコード (Base64 ASCII) X.509 形式で抽出しておく必要があります。公開鍵と秘密鍵のペアの作成と公開鍵証明書の抽出の詳細については、「 Box外部コンテンツコネクタの公開鍵/秘密鍵ペアの作成」を参照してください。

    必要なロール：なし

    このタスクについて

    Box外部コンテンツコネクタは、Box API を使用して、Boxソースシステムからドキュメントとユーザー権限を取得します。

    コネクタが Box API を介して Box ソースシステムにアクセスできるようにするには、Box 開発者コンソールで OAuth 2.0 アプリケーションを構成して承認する必要があります。コネクタアドミンは、OAuth 2.0 アプリケーションとその API キーからコピーした設定を使用して、ソースシステムに適切に接続できるように Box 外部コネクタを構成できます。

    手順

    1. Box 開発者コンソールで、Box外部コンテンツコネクタ用の新しい OAuth 2.0 アプリケーションを作成します。
      1. [ https://app.box.com/developers/console ] に移動し、アドミニストレーター認証情報でログインします。
      2. [プラットフォームアプリを作成] を選択し、[カスタムアプリ] を選択します。
        開発者コンソールの [自分のプラットフォームアプリ] 画面Box
      3. [カスタム アプリの作成] ウィンドウで、アプリの名前とその目的を指定して、[ 次へ] を選択します。
        開発者コンソールの [カスタムアプリを作成] 画面 1/2 Box
      4. [Create a Custom App] ウィンドウで、[ Server Authentication (with JWT)] を選択し、[ Create App] を選択します。
        開発者コンソールの [カスタムアプリを作成 (Create a Custom App)] 画面 2/2 Box
        新しい OAuth 2.0 アプリケーション の構成 画面が表示されます。
    2. 必要な設定を使用して新しい OAuth 2.0 アプリケーションを構成し、公開鍵/秘密鍵のペアを生成します。
      1. [アプリのアクセスレベル] セクションで、[ アプリ + エンタープライズアクセス ] オプションを選択します。
        Box開発者コンソールのアプリアクセスレベル構成設定。
      2. [アプリケーションスコープ] セクションの [コンテンツアクション ] 見出しで、[ Box に保存されているすべてのファイルとフォルダーを読み取る ] オプションと [ Box に保存されているすべてのファイルとフォルダーを書き込む ] オプションを選択します (まだ選択されていない場合)。
        開発者コンソールのアプリケーションスコープ構成設定Box。
      3. [拡張機能] セクションで、[ 現状のままのヘッダーを使用して API 呼び出しを行う ] オプションと [ ユーザー アクセストークンを生成する ] オプションを選択します。
        Box開発者コンソールの拡張機能構成設定。
      4. [公開キーの追加と管理] セクションで、[ 公開キーの追加] を選択します。
        開発者コンソールで公開鍵構成設定を追加および管理Box。
        [新しい公開鍵を追加] ダイアログボックスが表示されます。
      5. [ 新しい公開鍵の追加 ] ダイアログボックスで、 -----BEGIN PUBLIC KEY ----- マーカーや -----END PUBLIC KEY ----- マーカーを含む PEM でエンコードされた公開鍵テキストを [ 公開鍵 ] フィールドに貼り付け、[ 確認して保存] を選択します。
        開発者コンソールで [新しい公開鍵を追加 (Add a new Public Key)] ダイアログボックスBox。
      6. 新しい公開鍵に対して Box 表示される公開鍵 ID 文字列をコピーし、安全な場所に保存します。
        Box開発者コンソールの新しい公開鍵に表示される ID。
        重要:
        コネクタアドミンは、Box 外部コンテンツコネクタを構成するときにこの公開鍵 ID 文字列を必要とします。
      7. [アプリの設定] セクションで、[ JSON としてダウンロード] を選択し、ダウンロードした JSON 形式の設定ファイルを安全な場所に保存します。
        開発者コンソールの [アプリ設定] セクションBox
        重要:
        コネクタアドミンは、Box 外部コンテンツコネクタを構成するときに、この JSON 形式の設定ファイルを必要とします。
      8. [変更内容を保存] を選択します。
        OAuth 2.0 アプリの構成が正常に更新されたことを報告するメッセージが表示されます。
    3. 新しい OAuth 2.0 アプリケーションの認証要求を送信します。
      1. 新しい OAuth 2.0 アプリケーションの 認証 画面に移動します。
      2. [レビューして送信] を選択します。
        開発者コンソールの認証設定Box [レビューと送信] オプション。
      3. [アプリ承認の送信の確認 (Review App Authorization Submission)] 画面で、OAuth 2.0 アプリケーションの説明を入力し、[ 送信] を選択します。
        開発者コンソールの [アプリ承認の送信Boxレビュー] 画面。
        アプリの [認証ステータス] には [承認待ち] と表示されます。
    4. Box アドミン UI ポータルで、新しい OAuth 2.0 アプリケーションを承認します。
      1. [ https://app.box.com/master ] に移動し、アドミニストレーター認証情報でログインします。
      2. [ 統合] メニューアイコン を選択し、[ プラットフォームアプリマネージャー ] タブに移動します。
      3. [サーバー認証アプリ] を選択し、新しい OAuth 2.0 アプリケーションのエントリを見つけます。
      4. オーバーフローアイコン を選択してアプリエントリのコンテキストメニューを開き、[ アプリを承認] を選択します。
        Box の [プラットフォームアプリマネージャー] 画面アドミン UI ポータル。
      5. [アプリの承認] 画面で、[ 承認] を選択します。
        Box の [アプリを認証] 画面アドミン UI ポータル。
        アプリの [認証ステータス] が [認可済み] に変わります。

    次のタスク

    コネクタアドミンに次のアイテムを提供します。
    • OAuth 2.0 アプリケーションの構成に使用した Box アドミニストレーターアカウントのメールアドレス。
    • ステップ 2.f でコピーした公開鍵 ID 文字列。
    • ステップ 2.g でダウンロードした JSON 形式の設定ファイル。

    コネクタアドミンは、Box ソースシステムからユーザーボックスとセキュリティプリンシパルを取得するためのBox外部コンテンツコネクタを構成するために、これらのアイテムを必要とします。

    Box Cloud 外部コンテンツコネクタの作成と構成の詳細については、「Box外部コンテンツコネクタの作成」を参照してください。