SharePoint Online 検索コネクタ の設定

SharePoint Online 検索コネクタ を設定するには、Microsoft SharePoint テナントを構成してインスタンスに接続します。検索用にサイトのインデックスを作成する前に、接続を検証してセットアップエラーを回避します。

Microsoft SharePoint テナントの構成

SharePoint Online 検索コネクタ の使用を開始するために Microsoft SharePoint テナントを構成します。

始める前に

Microsoft SharePoint アドミニストレーターは、ルート URL (https:// <sitename>.sharepoint.com)、アプリドメイン、リダイレクト URL、およびその他の設定を指定してカスタムアプリケーションを作成します。
重要:
Yokohama リリース以降、 SharePoint Online 検索コネクタ は将来の廃止に向けて準備されています。これは非表示になり、新しいインスタンスではアクティブ化されなくなりますが、引き続きサポートされます。

廃止の詳細については、Now Support ナレッジベースの「Deprecation Process (廃止プロセス) [KB0867184]」の記事を参照してください。

次の前提条件を満たしていることを確認してください。

必要なロール：admin

このタスクについて

Microsoft SharePoint アカウントから次の手順を実行します。カスタムアプリケーションの作成と構成の詳細については、「SharePoint development (SharePoint の開発)」を参照してください。
注:
Azure アプリでアサインされた権限に特権の問題がある場合、次のエラーメッセージが表示されます。Error message: Method failed: (/_api/web/XXXXXXX) with code: 401 - Invalid username/password combo。KB1117977 で入手可能な手順を使用して、この問題に対処します。
検索結果にドキュメントの公開済みバージョンのみを表示する必要がある場合は、「Microsoft SharePoint Online Spoke」で説明されている権限の構成時に、[委任された権限 (Delegated permissions)] ではなく、[アプリケーションの権限 (Application permissions)] を選択します。
注:
アドミニストレーターは、インデックス作成を公開済みバージョンのみに制限して、ドラフトや未完了の作業が検索結果に表示されないようにすることができます。

手順

  1. 移動先 Azure > Active Directory > アプリ登録 > すべてのアプリケーションをクリックし、既存のアプリを選択します。
    既存のアプリケーションを使用するか、アプリケーションを作成します。
構成された権限
  1. 移動先 アプリ登録 > API 権限をクリックし、[ アクセス許可の追加] をクリックします。
  2. 次のオプションのいずれかを選択します。
    1. 移動先 Microsoft Graph > 委任された権限 グラフの場合。
    2. 移動先 Microsoft Graph > アプリケーションのアクセス許可 グラフの場合。
    [サイト] リストから、[Sites.ReadWrite.All] 権限を追加します。Sites.ReadWrite.All 権限はサブスクリプションの作成に役立ちます。

    [ユーザー] リストから [User.Read] 権限を追加します。

    これらのユーザー権限は、後で Microsoft SharePoint データをクロールするために使用されます。
  3. 移動先 SharePoint > アプリケーションのアクセス許可 > 拠点をクリックし、REST の場合は Sites.FullControl.All、 Sites.Read.All、または Sites.Selected を選択します。
    次の手順を実行して、 [Sites.Selected] の権限を有効にします。
    1. Microsoft Azure アプリケーションで、[Sites.Selected] の権限と [User.Read.All] の権限を有効にします。
      任意の API クライアントを使用して、次のサイトコレクションの読み取りアクセス権を提供します。
      • ServiceNow インスタンスに接続され、[Sites.Selected] のアクセス許可を持つアプリケーション X。
      • アドミンアプリケーションであり、Graph 接続の [Sites.Full.Control] の権限を持つアプリケーション Y。
    2. API メソッド https://login.microsoftonline.com/{Tenant Id}/oauth2/v2.0/token を呼び出して、ベアラートークンを取得します。
      ペイロード：
      client_id={App Y client id}
&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default
&client_secret={App Y client secret}
&grant_type=client_credentials
    3. 手順 b で受け取ったトークンを認証トークンとして渡し、API メソッド https://graph.microsoft.com/v1.0/sites/{site id}/permissions を呼び出します。
      ペイロード：
      {
"roles": [
"read"
],
"grantedToIdentities": [
{
"application": {
"id": "App X client id",
"displayName": "App X"
}
}
]
}
  4. 次の画像に示すように、必要な API 権限が設定されていることを確認します。
    図 : 1. 構成済み権限リスト
    SharePoint で構成された権限リスト
    詳細については、「Configure Microsoft SharePoint Graph connection」を参照してください。
  5. [管理者の同意を付与する] をクリックし、[はい] を選択して、[保存して続行] をクリックします。
  6. 移動先 認証 > Web > リダイレクト URL をクリックし、次の形式の URL https://<ServiceNow インスタンスの URL>/oauth_redirect.do ( 例:https://eesharepoint.example.com/oauth_redirect.do ) を追加して、[ 保存] をクリックします。
  7. Microsoft SharePoint Online Spoke に移動し、アプリケーションの証明書とシークレットを登録します。
  8. Microsoft 管理ポータルで、[ユーザーを追加] をクリックしてユーザーの詳細を指定し、[完了] をクリックします。
    注:
    検索は、ユーザーがアクセスできるサイトをクロールします。必要なコンテンツに対してのみ適切な権限を持つユーザーを選択してください。詳細については、「user permissions (ユーザー権限)」を参照してください。上位レベルのユーザーを選択すると、インポートするドキュメントよりも多くのドキュメントがインポートされる可能性があります。

    詳細については、「Granting access via Azure AD App-Only (Azure AD アプリのみを介したアクセスの許可)」を参照してください。

次のタスク

ServiceNow AI 検索 アカウントからの統合を完了します。詳細については、「Microsoft SharePoint 検索ソースと AI 検索プロファイルの統合」を参照してください。

Microsoft SharePoint テナントへの ServiceNow インスタンスの接続

ServiceNow インスタンスを Microsoft SharePoint テナントに接続します。Microsoft SharePoint のカスタム ServiceNow OAuth 接続を作成し、ServiceNow の要求を認証します。

始める前に

  • アプリケーションを構成するための SharePoint 開発者プログラムツールやその他のリソースの実践的な知識を有していることを確認します。
  • ServiceNow® 統合について理解している必要があります。
必要なロール：sn_sp_con.admin および admin。

手順

  1. 移動先 ServiceNow インスタンス > システム OAuth > アプリケーションレジストリー.
  2. [New] をクリックします。
    「どのような OAuth アプリケーションですか？」というメッセージが表示されます。
  3. [サードパーティ OAuth プロバイダーに接続] を選択します。
  4. 次のレジストリを作成します。
    1. Graph 接続フォームのフィールドに入力します。
      フィールド値の詳細については、「グラフ接続フォーム」を参照してください。
    2. REST 接続フォームのフィールドに入力します。
      フィールド値の詳細については、「REST 接続フォーム」を参照してください。
    3. フォームヘッダーを右クリックし、[保存] をクリックします。
OAuth エンティティプロファイル
  1. OAuth エンティティプロファイル [oauth_entity_profile] テーブルに移動して、次のエントリを見つけます。
    • <Graph application registry name>.default_profile
    • <REST application registry name>.default_profile

    2 つのシステムで生成された OAuth エンティティプロファイル (REST と Graph) が OAuth エンティティプロファイル [oauth_entity_profile] テーブルに作成されます。詳細については、「Specify an OAuth profile」を参照してください。

OAuth エンティティスコープ
OAuth エンティティプロファイルスコープ
  1. OAuth エンティティプロファイルスコープ [oauth_entity_profile_scope] テーブルに次の値を含む行を挿入します。
    表 : 1. OAuth エンティティプロファイルスコープ
    グラフ REST
    OAuth エンティティプロファイル：OAuth エンティティプロファイル [oauth_entity_profile] テーブルで生成された Graph エンティティプロファイル。 OAuth エンティティプロファイル：OAuth エンティティプロファイル [oauth_entity_profile] テーブルで生成された REST エンティティプロファイル。
    OAuth エンティティスコープ：Graph OAuth エンティティスコープ [oauth_entity_profile_scope] テーブルを選択します。 OAuth エンティティスコープ：REST OAuth エンティティスコープ [oauth_entity_profile_scope] テーブルを選択します。
    アプリケーション：グローバル アプリケーション：グローバル
資格情報
  1. 移動先 接続 & 認証情報 > 認証情報をクリックし、OAuth 2.0 認証情報を作成します。
    1. Graph または REST 認証情報フォームのフィールドに入力します。
      表 : 2. OAuth 2.0 認証情報フォーム
      フィールド 説明
      名前 任意の名前。
      OAuth エンティティプロファイル (Graph の場合) 識別された Graph エンティティプロファイル。

      (REST の場合) 識別された REST エンティティプロファイル。
    2. フォームヘッダーを右クリックし、[保存] をクリックします。
      注:
      エンティティ、接続および資格情報エイリアスの詳細については、「Configure the SharePoint Graph Root Site Subscription connection and credential alias record」を参照してください。
接続
  1. 移動先 接続 & 認証情報 > 接続をクリックし、[ 新規 ] をクリックして、次の グラフ または REST の HTTP(s) 接続を作成します。
    1. フォームで、フィールドに入力します。
      表 : 3. 接続フォーム
      フィールド 説明
      名前：グラフの任意の名前 名前：REST の任意の名前
      認証情報：グラフの [認証情報] を選択します。 認証情報：REST の [認証情報] を選択します。
      接続エイリアス：sn_sp_spoke.MicrosoftSharePointGraph 接続エイリアス：sn_sp_spoke.MicrosoftSharepointOnline
      接続 URL： https://graph.microsoft.com/v1.0/ 接続 URL：https://<SharePoint インスタンスのホスト URL>/
      ドメイン：グローバル ドメイン：グローバル
    2. フォームヘッダーを右クリックし、[保存] をクリックします。
    詳細については、「Connections and Credentials」と「Create an HTTP(s) connection」を参照してください。
テナント
  1. 移動先 Microsoft SharePoint Online > テナント。
    1. [新規] をクリックして、Graph または REST 接続を作成します。
    2. フォームのフィールドに入力します。
      表 : 4. テナント接続フォーム
      フィールド 説明
      名前 任意の名前。
      エイリアス Graph の場合：sn_sp_spoke.MicrosoftSharePointGraph

      REST の場合：sn_sp_spoke.MicrosoftSharepointOnline
      SharePoint ルート URL <SiteName>.sharepoint.com のようなルート URL
      テナント ID Graph または REST 接続に必要な特定のテナント ID。
      ドメイン グローバル
    3. トピックヘッダーを右クリックし、[保存] をクリックします。
    詳細については、「Define tenants」、「Configure the SharePoint Graph Root Site Subscription connection and credential alias record」、「Create aliases for multiple tenants」を参照してください
証明書
JWT キー
  1. 移動先 システム OAuth > JWT プロバイダー > Microsoft SharePoint Online JWT プロバイダー.
    1. https://login.microsoftonline.com/<Tenant-id>/oauth2/token で aud 要求を更新します。
    2. Azure AD アプリ登録の各クライアント ID で [iss] および [sub] 要求を更新します。
    3. [保存] をクリックします。
接続
  1. 移動先 接続 & 認証情報 > 接続.
    1. REST 接続レコードを開き、[属性] タブで Base64 エンコードされた証明書の [サムプリント] を指定します。
      注:
      SharePoint アプリのサムプリントの値は 16 進数でエンコードされます。接続レコードで同じものを Base64 形式でエンコードします。
    2. 次の [認証情報] オプションを選択します。
      • ([グラフ] の場合)：[認証情報] テーブル (oauth_2_0_credentials) に移動し、[グラフ] を開き、[OAuth トークンを取得] をクリックします。

        Graph 接続の OAuth トークンを取得するには、作成したユーザーの認証情報を使用して Microsoft SharePoint インスタンスにログインします。インスタンスに認証情報を格納します。

      • ([REST] の場合)：[認証情報] テーブル (oauth_2_0_credentials) に移動し、[REST] を開き、[OAuth トークンを取得] をクリックします。

        REST 接続の OAuth トークンを取得するには、テナントアドミン認証情報を使用して Microsoft SharePoint インスタンスにログインします。インスタンスに認証情報を格納します。

        認証情報を検証して、構成の失敗を回避します。SharePoint 接続を検証する方法の詳細については、「Microsoft SharePoint 接続の検証」を参照してください。

    3. [保存] をクリックします。
信頼できるドメイン
  1. [信頼できるドメイン] テーブル (sn_ais_spoke_trusted_domains) に移動し、[新規] をクリックして、ドメインレコードを作成します。
    1. フォームのフィールドに入力します。
      表 : 5. ドメインレコードフォーム
      フィールド 説明
      名前 任意の名前。
      ドメイン <Microsoft SharePoint テナントのホスト URL>。
    2. [保存] をクリックします。
      詳細については、「Set up the AI Search spoke」を参照してください。
      注:
      複数のテナントがある場合は、テナントごとに信頼できるドメインレコードを作成します。
Sharepoint 取り込みユーザー
  1. 移動先 接続 & 認証情報 > 接続と認証情報エイリアス > Sharepoint 取り込みユーザー (sn_sp_con。Sharepoint_Ingest_User)。
    1. AIS により外部コンテンツを取り込むには、[認証情報] で [新規] をクリックして、基本認証情報を作成します。
    2. ais_external_content ロールを持つユーザー (sys_user) の [ユーザー名] と [パスワード] を指定します。
      取り込みユーザー
      注:
      スクリーンショットの例では、ユーザー abel.tuter は ais_external_content ロールが割り当てられている sys_user です。
    3. [送信] をクリックします。
      詳細については、「Create aliases for multiple tenants」を参照してください。
    4. 次の手順に進む前に、AI 検索サーバー接続を設定します。

    Entity View Action Mapper (EVAM) 構成は、従業員センタープロバージョン 32.0 でデフォルトで使用できます。

    EVAM 定義の詳細については、「Create an EVAM action definition」と「Create a multi-data source list display in Entity View Action Mapper」を参照してください。

タスクの結果

構成が完了しました。

次のタスク

「Microsoft SharePoint 接続の検証」を参照して、サンプルサイトのインデックスを作成する前に構成の失敗を除外します。

Microsoft SharePoint 接続の検証

ServiceNow インスタンスを Microsoft SharePoint テナントに接続した後に検証を実行し、構成にエラーがないかどうかを確認します。

始める前に

必要なロール：admin

このタスクについて

検証によって構成の失敗が除外され、シームレスなセットアッププロセスが確保されます。

手順

  1. 移動先 システム UI > UI ページ > Sharepoint ユーティリティ.
  2. [試す] を選択して、[SharePoint 接続の検証] ページに移動します。
  3. 必要な詳細を入力し、[検証]を選択します。
    エラーがある場合は、[応答] セクションに表示されます。
  4. [テーブル名] リンクを確認して、[応答] セクションに表示される [現在の値] と [予想値] に基づいてエラーを修正します。

    情報が不足している場合は、エラーフィールドにデータが表示されます。

    エラーがない場合、検証が成功したことが応答セクションに表示されます。

次のタスク

検索用のインデックスサイト。詳細については、「検索用のインデックスサイト」を参照してください。