Box Connector for Microsoft Graphを使用すると、BoxとMicrosoftのお客様は、Boxのデータのインデックスを作成して、Microsoft 365のエクスペリエンスに表示できるようになります。 この統合を有効にすることで、Microsoft 365のユーザーはMicrosoft Search、Microsoft 365アプリ、Microsoft CopilotでBoxのコンテンツを見つけることができます。

以下のステップでは、Microsoft管理者がテナントに対してBox Graph Connector統合を有効にする方法を説明します。

Box Connector for Microsoft Graph統合を組織に展開する際に従う必要のある主なステップは、大きく分けて以下のとおりです。

1. アプリを承認する
2. Boxを外部データソースとして監視する
3. Box検索バーティカルを追加する
4. (省略可) バーティカルをカスタマイズする
5. (省略可) 統合を無効にする

有効化フォーム (英語) に入力済みであることを確認してください。 Boxでは、お客様の設定を完了するためにフォームの情報が必要になります。 その間に、接続を構成するための前提条件であるステップ1を進めてください。

ステップ1: アプリを承認する

このステップでは、Box Graph Connectorアプリを承認して、BoxコンテンツをMicrosoft Graphと同期するために必要なAPIコールの実行を許可します。

1. Microsoftテナントの管理者としてサインインし、新しいタブを開いて、https://login.microsoftonline.com/{TENANT_ID}/v2.0/adminconsent?client_id=1aab5478-9db7-40c6-90fa-6adfad72e0a9&state=12345&scope=https://graph.microsoft.com/.default&redirect_uri=https://account.box.comにアクセスします。このURLの{TENANT_ID}は、Graph Connectorを有効にするMicrosoftテナントIDに置き換えます。 MicrosoftテナントIDは、管理用Azureポータル (https://aad.portal.azure.com/) で確認できます。
2. 同意を求める画面が表示されたら、[Accept (承諾)] をクリックします。
3. [Accept (承諾)] をクリックすると、Boxの画面が表示されます。 タブを閉じます。Boxで操作を行う必要はありません。
4. アプリがテナントに追加され、承認されたことを確認します。 https://aad.portal.azure.comにアクセスして、[Applications (アプリケーション)] -> [Enterprise applications (エンタープライズアプリケーション)] の順にクリックして、エンタープライズアプリケーションの一覧からBox Graph Connectorアプリを探します
5. アプリをクリックし、[Permissions (アクセス許可)] に移動します。 すべての権限を許可する必要があります。 許可されていない権限がある場合には、[Grant admin consent for {tenant} ({テナント} に管理者の同意を与えます)] ボタンをクリックすると、その権限が許可されます。

6. テナントにデータを取り込む準備が完了したら、partnerintegrations@box.comからのメールに返信する形でBoxにお知らせください。 BoxとMicrosoft Graph間のデータ接続を作成するためにBox側で作業を行い、BoxをBox Graph Connectorサービスに接続します。

ステップ2: Boxを外部データソースとして監視する

Box側の設定が完了したら、以下のステップに従って接続を監視できます。

1. Box側の設定が完了すると、メールで通知されます。
2. テナント管理者としてhttps://admin.microsoft.comにログインして、接続を監視できます。
3. 左側のサイドバーで、[Settings (設定)] > [Search & intelligence (検索とインテリジェンス)] をクリックします ([Settings (設定)] オプションが表示されていない場合は [Show All (すべて表示)] をクリックします)。 上にある [Data sources (データソース)] タブをクリックします。
4. 「boxmsgraph」という接続IDのBoxデータソースが表示されているはずです。 当初この接続はドラフト状態になっており、Box Graph Connectorサービスで接続の構成が完了するまでの間、その状態が続きます。 Box Graph Connectorサービスの負荷によっては、設定が完了するまで数時間かかる場合があります。
5. 接続の構成が完了すると、接続の状態が [Ready (準備完了)] に変わります。
6. また、接続をクリックすると、[Detail (詳細)] セクションで、インデックスが作成された項目数や最終同期時刻も確認できます。

ステップ3: Box検索バーティカルを追加する

Boxデータソースを構成できたので、次はこのデータソースのバーティカルを構成します。 ユーザーはUIに表示されるバーティカルを使用して、Boxファイルを検索します。

1. テナント管理者としてhttps://admin.microsoft.comにログインし、[Settings (設定)] > [Search & intelligence (検索とインテリジェンス)] > [Customizations (ユーザー設定)] の順にクリックします。
2. [Verticals (バーティカル)] タブの [Add (追加)] をクリックします。
3. UI上のBoxタブに表示する名前を選択します。 「Box」や「Box Files」など、任意の名前を付けることができます。
4. コンテンツソースは、前のステップで構成したBoxデータソースを選択します。
5. クエリとフィルタのステップは省略してかまいません。
6. 最後に [Add Vertical (バーティカルを追加)] をクリックして、新しいバーティカルを保存します。
7. このバーティカルは、しばらくするとユーザーに表示されるようになります (すべてのユーザーに表示されるまで数分から数時間かかる場合もあります)。 また、https://portal.office.comを開いて、画面の上部にある検索バーにクエリを入力すると、このバーティカルが表示されます。 前のステップで構成したバーティカル名が入ったタブが表示されます。 初回の同期には数時間から数日かかる場合があり、同期が完了するまではバーティカルの下に結果は表示されません。
8. インデックスが作成されたBoxファイルを確認するには、Boxバーティカルに移動し、*を検索します。 これにより、その特定のユーザーのインデックスが作成されたBoxコンテンツがすべて返されます。

注: デフォルトでは、Boxの結果は [All (すべて)] バーティカルに表示されます。 表示されない場合は、こちらの詳細なステップに従ってください。

ステップ4: (省略可) バーティカルをカスタマイズする

必要に応じて、Boxバーティカルでの検索結果の表示方法をカスタマイズできます。 検索結果のレイアウトをカスタマイズしない場合、デフォルトのレイアウトが使用されます。

1. テナント管理者としてhttps://admin.microsoft.comにログインし、[Settings (設定)] > [Search & intelligence (検索とインテリジェンス)] > [Customizations (ユーザー設定)] の順にクリックします。
2. [Result types (結果の種類)] タブをクリックして、新しい結果の種類を新しく追加します。 その結果の種類に「Boxファイル」などの名前を付け、そのコンテンツソースとして、先ほどのステップで構成したBoxデータ接続を設定します。
3. 結果の種類を詳しく構成しない場合には、[Rules (ルール)] ステップを省略してかまいません。
4. [Layout (レイアウト)] ステップでは、検索結果の表示方法を構成できます。 レイアウトデザイナーには結果の表示方法を構成するためのビジュアルインターフェースがあり、それを使ってカスタマイズ JSON を生成できます。
   1. レイアウトデザイナーを使用する際には、プロパティがレイアウト内の要素に割り当てられます。 Box Graph Connectorでは、以下のプロパティを使用できます。
      1. id – BoxファイルのID
      2. name – ファイルの名前 (拡張子を含む)
      3. fileName – ファイルの名前 (拡張子を含まない)
      4. extension – ファイルの拡張子
      5. createdByName – ファイルを作成したユーザーの名前
      6. createdAt – ファイルが作成された日時
      7. ownedByName – ファイルを所有するユーザーの名前
      8. modifiedByName – ファイルを最後に変更したユーザーの名前
      9. modifiedAt – ファイルが最後に変更された日時
      10. url – Box内のファイルを表示するためのURL
      11. size – ファイルのサイズ (バイト単位)
      12. icon – ファイルの拡張子に応じて表示される汎用のファイルアイコン
      13. thumbnail – ファイルのサムネイル画像。 コンテンツの取り込みが無効になっている場合、またはファイルのサムネイルがない場合、サムネイルはiconで指定される画像と同じになります
      14. ResultSnippet – Microsoftが提供する特別なフィールド。ファイルのテキスト内で一致した検索用語を含む部分が強調表示されます。 コンテンツの取り込みが無効になっている場合、またはテキストのインデックス作成がサポートされないファイルタイプの場合、ResultSnippetは使用できません。 ResultSnippetは、他のプロパティ名と異なり最初のアルファベットが大文字であることに注意してください。
5. レイアウトデザイナーを使用せずにカスタムレイアウトを作成するには、Boxが開発したレイアウト (https://cloud.box.com/s/p8g567z3tsh45pzh4bz8kywk2vhm88d2) を使用します。

ステップ5: (省略可) 統合を無効にする

Box Graph Connectorを無効にすると、ユーザーはMicrosoft製品からBoxコンテンツを検索できなくなり、統合でインデックスが作成されたBoxデータがすべて削除されます。

1. Boxに連絡して、Microsoft Graphへの企業データの同期を停止するためにBox Graph Connectorサービスを更新するよう依頼します。
2. テナント管理者としてhttps://admin.microsoft.comにログインし、[Settings (設定)] > [Search & intelligence (検索とインテリジェンス)] > [Data sources (データソース)] の順にクリックします。
3. 「boxmsgraph」という接続を選択し、接続名の横にあるごみ箱アイコンをクリックします。 これで接続が削除されます。 インデックスが作成されたデータがすべて削除されるまで、数分かかる場合があります。