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 でのみ構成できます。
• Everyone、BUILTIN\Users、All Authenticated Users などの一般的な Active Directory と Windows のプリンシパルはサポートされていません。
• 通知の削除は瞬時には行われず、ユーザーがソース リポジトリからコンテンツを削除したことをコネクタが認識するまでに 4 時間以上かかることがあります。

システム要件

コネクタをデプロイする

前提条件

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

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

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

1. コネクタを実行するパソコンで、ブラウザを開いて SharePoint に移動します。

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

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

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

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

6. [Close]、[Cancel] の順にクリックして、ウィンドウを閉じます。

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

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

   [Trust this certificate?] というプロンプトが表示されたら、[yes] と答えます。

ステップ 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
   

   値は SharePoint On-Prem コネクタの場合とほぼ同じですが、api.sourceId の代わりに api.customerId パラメータが使用されます。api.customerId の値は、Google Workspace 管理者から取得したお客様 ID です。

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

次の手順では、オンプレミス Active Directory と SharePoint サイト コレクションの両方のプリンシパルを Cloud Identity サービスの ID にマッピングします。この同期は、Google Cloud Directory Sync（GCDS）と SharePoint On-Prem ID コネクタを使用して行われます。

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

データソース アクセス

SharePoint オンプレミス アクセス

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

SharePoint の ID マッピング

Active Directory 参照

HTML コンテンツの生成