Microsoft SharePoint On-Prem コネクタをデプロイする

Microsoft Outlook のメール処理

コネクタがコンテンツをインデックスに登録する際に Microsoft Outlook の .msg ファイルを検出すると、ファイルのメディアタイプをオーバーライドして application/vnd.ms-outlook. としてインデックスに登録します

マルチテナント構成

SharePoint がマルチテナント デプロイで、複数の顧客サイトが同じウェブ アプリケーションでホストされている場合は、構成ファイルでサイト収集モードを構成する必要があります。マルチテナント デプロイでは、サイト コレクションに対する権限のみが付与され、SharePoint On-Prem コネクタに必要な完全な読み取り権限は取得できません。

サイト収集モードを有効にするには:

• コネクタ ユーザー アカウントに、サイト コレクション管理者の権限を付与します。
• コネクタ構成ファイルの sharepoint.server をサイト コレクション URL（http://sharepoint.example.com/sites/sitecollection など）に設定します。URL の大文字と小文字は SharePoint とまったく同じである必要はありません。
• コネクタ構成ファイルの sharepoint.siteCollectionOnly を true に設定します。

マルチテナント環境でインデックス登録するサイト コレクションが複数ある場合は、サイト コレクションごとに 1 つのコネクタ インスタンスを構成する必要があります。

コネクタの既知の制限事項

• コネクタがモニタリングするデータベースの数に応じて、コネクタがデータベース内のアイテムの変更を検出するまでにかかる時間が長くなります。
• メモリ消費量は、各サイト コレクションの ACL で使用するユニーク ユーザーとグループの数に応じて増加します。
• コネクタは、1 つの Active Directory ドメインの ID のみを使用して構成できます。
• Active Directory と Windows の一般的なプリンシパル（Everyone、BUILTIN\Users、All Authenticated Users など）はサポートされていません。
• 削除通知は即時にではなく、ユーザーがソース リポジトリからコンテンツを削除したことをコネクタが認識するまでに 4 時間以上かかることがあります。

システム要件

コネクタをデプロイする

前提条件

ステップ 2. SharePoint On-Prem コネクタ構成ファイルを作成する

ステップ 3. HTTPS の場合は、信頼できるホストとして SharePoint を追加する

HTTPS を使用するように SharePoint が構成されている場合は、SharePoint 証明書を取得して、コネクタの信頼できるホストとして追加します。

1. コネクタを実行するパソコンでブラウザを開き、SharePoint にアクセスします。

2. 警告ページが表示されたら、[I understand the Risks]（リスクを理解しました）と [Add Exception]（例外を追加）をクリックします。ページに「この接続は信頼できません」などのメッセージが表示されるこれは、証明書が自己署名されており、信頼できる認証局によって署名されていないためです。

3. [表示] ボタンが使用可能になったら、クリックします。

4. [詳細] タブに移動して、[エクスポート] をクリックします。

5. 証明書を sharepoint.crt という名前でコネクタ ディレクトリに保存します。

6. [閉じる]、[キャンセル] の順にクリックしてウィンドウを閉じます。

7. コマンド プロンプトを開き、次のコマンドを入力します。

   $ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

   [この証明書を信頼しますか？] というメッセージが表示されたら、「はい」と回答します。

ステップ 4. ロギングの設定

1. コネクタ バイナリを含むディレクトリに、logs という名前のフォルダを作成します。

2. 同じディレクトリ（logs ではない）で、logging.properties という名前の Latin1 エンコード ファイルを作成します。

3. logging.properties に次のテキストを追加します。

   handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
   # Default log level
   .level = INFO
   # uncomment line below to increase logging level for SharePoint APIsa
   #com.google.enterprise.cloudsearch.sharepoint.level=FINE
   
   # uncomment line below to increase logging level to enable API trace
   #com.google.api.client.http.level = FINE
   java.util.logging.ConsoleHandler.level = INFO
   java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log
   java.util.logging.FileHandler.limit=10485760
   java.util.logging.FileHandler.count=10
   java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
   

ステップ 5. SharePoint On-Prem ID コネクタを構成する

この手順は、SharePoint On-Prem の ID ベースの ACL を検索結果に適用するために必要です。公開 ACL を使用してコネクタを設定する場合は、この手順をスキップできます。

1. SharePoint Online コネクタのインストールと同じディレクトリに、ファイルを作成して sharepoint-onprem-identity-connector.config という名前を付けます。

2. 次の例のように、パラメータを Key-Value ペアとしてファイルの内容に追加します。

   ### SharePoint On-prem identity connector configuration ###
   
   # Required parameters for data source access
   api.customerId=C05d3djk8
   api.serviceAccountPrivateKeyFile=service_account.json
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   
   # Required parameters for SharePoint access
   sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
   sharepoint.siteCollectionOnly=true
   sharepoint.username=contoso\\admin
   sharepoint.password=pa$sw0rd
   sharepoint.stripDomainInUserPrincipals=true
   
   # Required parameters for AD lookup
   adLookup.host=dc.contoso.com
   adLookup.username=contoso\\admin
   adLookup.password=pa$sw0rd
   api.referenceIdentitySources=CONTOSO,contoso
   api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
   api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
   

   パラメータは、api.sourceId ではなく api.customerId である点を除き、SharePoint On-Prem コネクタの場合とほぼ同じです。api.customerId の値は、Google Workspace 管理者から取得したお客様 ID です。

ステップ 6. SharePoint On-Prem コネクタを起動する

次の手順では、オンプレミスの Active Directory と SharePoint サイト コレクションの両方のプリンシパルを、 認証できます。この同期は Google Cloud と Directory Sync（GCDS）と SharePoint On-Prem ID コネクタをご活用ください。

GCDS でユーザーとグループが同期されたら、SharePoint サイト コレクション グループを同期するには、SharePoint On-Prem ID コネクタを実行します。最後に、SharePoing On-Prem コネクタを実行して、結果をインデックスに登録して Cloud Search ユーザーに提供します。

データソース アクセス

SharePoint オンプレミス アクセス

サイト コレクションのインデックス登録

SharePoint ID マッピング

Active Directory 検索

HTML コンテンツの生成