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. [表示] ボタンが利用可能になったら、クリックします。

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

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

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

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

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

   [Trust this certificate?] というプロンプトが表示されたら、[はい] を選択します。

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

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

2. 同じディレクトリ（logs 以外）に、logging.properties という名前のラテン 1 エンコード ファイルを作成します。

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 コネクタを実行します。最後に、SharePoing On-Prem コネクタを実行してインデックスを作成し、Cloud Search ユーザーに結果を提供します。

データソース アクセス

SharePoint オンプレミスへのアクセス

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

SharePoint ID マッピング

Active Directory 検索

HTML コンテンツの生成