SharePoint コネクター

Microsoft SharePoint 2010 および Microsoft SharePoint 2013 用 Day JCR コネクター（バージョン 4.0）

この記事では、Microsoft SharePoint 2010およびMicrosoft SharePoint 2013のAdobe4.0に関する詳細を説明します。

SharePoint コネクターでは次の基本機能がサポートされています。

• SharePoint からのコンテンツおよびメタデータの読み取り
• ネイティブな SharePoint 認証および承認を適用することによる、アクセスされるコンテンツの SharePoint セキュリティ設定の確認
• コンテンツファインダーを使用したコンテンツ統合
• 外部リソースなどの AEM コンポーネントを使用した SharePoint 画像およびビデオの表示
• SharePoint と AEM Assets の同期

これらの機能はすべて、ネイティブな SharePoint Web サービスを SharePoint のコンテンツおよびサービスへのインターフェイスとして使用して実装されています。

概要

コネクターを導入する際には、次の作業をおこなってください。

• Java 7 以降がインストールされていることを確認します。

• パッケージ共有からコネクターパッケージ配布ファイルをダウンロードします。

• cq-quickstart-6.4.0.jar ファイルが格納されたディレクトリに有効な license.properties ファイルをコピーします。

• .jar ファイルをダブルクリックまたはタップして AEM を起動するか、コマンドラインから AEM を起動します。

• パッケージマネージャーからコネクターパッケージをインストールします。

• コネクターオプションを設定します。

SharePoint コネクターのインストール

このコネクターは、インストールが容易なコンテンツパッケージとして提供されています。パッケージマネージャーを使用してパッケージをインストールし、SharePointサーバーのURLを設定します
およびその他の設定オプションを使用できます。 SharePoint コンテンツは AEM リポジトリに格納されています。

インストール要件

このコネクターを使用するための要件は次のとおりです。

• Java Runtime Environment 1.7 以降
• ネットワークから SharePoint Web サービスを使用できること
• SharePoint サーバーの URL
• CRX および SharePoint リポジトリに対するユーザー資格情報と権限
• サポートされているプラットフォーム

packageshareからSharePointコネクタをダウンロードできます。

サポートされているプラットフォーム

このコネクターでは次のプラットフォームがサポートされています。

• AEM バージョン：

  • AEM 6.4、6.3

• Microsoft SharePoint バージョン：

  • Microsoft Office SharePoint Server（MOSS）2010
  • Microsoft Office SharePoint Server（MOSS）2013

• コネクターのカスタムデプロイメント（OEM、特殊要件、認証方式のカスタマイズ）のサポートが必要な場合は、製品を使用している地域のアドビオフィスまでお問い合わせください。

標準インストール

AEM パッケージ共有は、製品の機能、例およびホットフィックスを配布するために使用されています。詳しくは、パッケージ共有のドキュメントを参照してください。

AEMのようこそページでパッケージ共有にアクセスするには、「ツール」をタップまたはクリックし、「パッケージ共有」を選択します。 会社の電子メールアドレスを含む有効なAdobe IDが必要です。 また、アカウントへのログイン後に、パッケージ共有へのアクセスを申請してください。

AEM との統合

コネクターのコンテンツパッケージをインストールするには：

1. アドビサポートチケットを作成して、コネクターの機能パックを要求します。

2. パッケージが使用可能になったらそれをダウンロードし、対象の AEM インスタンスでパッケージマネージャーを開きます。

3. パッケージの説明ページで「インストール」をタップまたはクリックします。

4. パッケージをインストール​ダイアログで、「インストール」をタップまたはクリックします。

   注意:管理者としてログインしていることを確認します。

5. パッケージがインストールされたら、「閉じる」をタップまたはクリックします。

SharePoint コネクターの設定

SharePoint コネクターのインストール後、そのコネクター用にアプリケーションおよび SharePoint レイヤーを設定します。

SharePoint リポジトリが JCR に準拠するように SharePoint サーバーの URL を設定します。追加のパラメーターを使用して、SharePoint サーバーとの接続を設定します。また、SharePoint コネクターでの認証を設定します。

SharePoint サーバーとの接続の設定

SharePoint サーバーの URL および高度なオプションを設定するには、次の手順を実行します。

1. OSGi Management Consoleに移動します。http://localhost:4502/system/console/configMgr.
2. Day JCR Connector for Microsoft Sharepoint​バンドルを検索します。
3. 設定値を編集します。
4. 「Workspaces」の値として SharePoint サーバーの URL を設定します。
5. 「Save」をタップまたはクリックします。

「Workspaces」および「Default Workspace Name」パラメーター：

コネクターによってデフォルトで公開される JCR ワークスペースは 1 つです。このワークスペースで公開される SharePoint サーバーは、「Sharepoint Server URL」設定パラメーターを使用して設定します。

コネクターは複数のワークスペースに対して設定することもできます。この場合、各ワークスペースは、それによって公開されるそれぞれの SharePoint サーバーの URL に関連付けられます。ワークスペースを追加するには、「Workspaces」パラメーターにワークスペース定義を追加します。ワークスペース定義の形式は次のとおりです。
<name>= <url> 条件
<name> はJCRワークスペースの名前で、
<url> は、そのワークスペースのSharePointサーバーのURLです。

AEM では、前述の設定手順とは別に、もう 1 つ手順を実行します。「com.day.cq.dam.cq-dam-jcr-connectors」バンドルを許可リストします。

AEMでバンドルを許可リストするには、次の手順を実行します。

1. OSGi Management Consoleに移動します。http://localhost:4502/system/console/configMgr.

2. 「Apache Sling Login Admin Whitelist」サービスを検索します。

3. 「ホワイトリストをバイパス」を選択します。

4. ホワイトリストバンドルのデフォルトに'com.day.cq.dam.cq-dam-jcr-connectors'を追加します

5. 「保存」をクリックします。

認証関連のパラメーターの詳細については、認証を参照してください。

SharePoint 設定の検証

コネクターを設定した後、次の点を検証してください。

• SharePoint サーバーが実行されており、コネクターインスタンスから Web サービスにアクセスできること
• SharePoint ユーザー資格情報が有効であり、ユーザーが必要な SharePoint 権限を持っていること
• コネクターが適切にインストールおよび設定されていること

SharePoint サーバーとの DAM 同期の設定

SharePoint Assets を AEM と同期するには、次の手順を実行します。

1. OSGi Management Consoleに移動します。http://localhost:4502/system/console/configMgr.
2. 「Default DAMAssetSynchronization」サービスを探します。
3. 設定値を編集します。
4. SharePoint サイトへのアクセス権を持つユーザーのユーザー名とそれに対応するパスワードを設定します。
5. 「保存」をクリックします。

DAM 同期サービスを有効にします（デフォルトでは無効になっています）。

1. OSGi Webコンソールのコンポーネントに移動します。http://localhost:4502/system/console/components
2. 「com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService」を探します。
3. 「Enable」をクリックします。

オプションで、異なる同期サイクル間の同期遅延を設定できます。

1. OSGi Management Consoleに移動します。http://localhost:4502/system/console/configMgr
2. 「DAY CQ DAM JCR Connector Asset Synchronization Service」を探します。
3. 設定値を編集します。
4. 「Synchronization Period」（秒単位）の値を設定します。
5. 「Save」をクリックします。

認証の設定

SharePoint ではクラシック認証方式と要求ベースの認証方式を使用でき、いずれの認証方式でも次の認証タイプがサポートされています。

• 基本
• フォームベース

特に、次の認証タイプを使用できます。

• クラシック-基本
• クラシック-フォームベース
• 要求-基本
• 要求-フォームベース

AEM JCR Connector for Microsoft SharePoint 2010およびMicrosoft SharePoint 2013のバージョン4.0は、次のモードで動作する要求ベースの認証（Microsoftが推奨）をサポートしています。

• 基本／NTLM 認証：コネクターでの最初の接続試行では、基本認証が使用されます。基本認証が使用できない場合は、NTLM ベースの認証に切り替えられます。
• Formsベースの認証:SharePointは、ユーザーがログインフォーム（通常はWebページ）に入力した資格情報に基づいてユーザーを検証します。認証された要求にはシステムによってトークンが発行されます。このトークンには、後続要求で ID の再確立に使用されるキーが含まれています。

フォームベースの認証の設定

次の場所に移動します。http://localhost:4502/system/console/bundles

1. OSGI／設定をクリックします。
2. 「Day JCR Connector for Microsoft Sharepoint」を探します。
3. 「Edit the configuration values」をクリックします。
4. 「Sharepoint Connection Factory」の値として「com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory」を設定します。
5. 「保存」をクリックします。

基本認証の設定(Windows)

1. トークン認証を無効にします。
2. http://localhost:4502/system/console/bundlesに移動します。
3. OSGI／Configuration をクリックします。
4. Day JCR Connector for Microsoft Sharepoint を探します。
5. 「Edit the configuration values」をクリックします。
6. 「Sharepoint Connection Factory」の値として「com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory」を設定します。
7. 「保存」をクリックします。

コネクターから SharePoint コンテンツにアクセスできるのは、AEM と SharePoint の両方で認証されたユーザーのみです。

認証用のコネクター拡張を使用してカスタム認証モジュールを作成することもできます。例えば、AEM ユーザーによるアクセスを特定の SharePoint ユーザーにマッピングできます。SharePoint ユーザーに対応する AEM ユーザーを作成して（ユーザー名とパスワードが一致する必要があります）、コネクターインスタンスにマッピングされた SharePoint コンテンツを確認できるようにします。

AEMでユーザーを作成するには：

1. admin ユーザーとして http://localhost:9502/ にログインします。
2. 「ツール」をクリックします。
3. 「セキュリティ」をクリックします。
4. 「ユーザー」をクリックします。
5. 「ユーザーを作成」をクリックします。
6. ユーザーID（SharePointに対するアクセス権を持つユーザー名）を指定します
7. 対応するパスワードを指定します。
8. 緑色のチェックマークをクリックして、ユーザーを作成します。

admin グループにユーザーを追加するには：

1. グループ管理に移動します。
2. 「a」ノードをクリックします。
3. 「administrators」をクリックします。
4. 上記で作成したユーザーIDをテキストボックスの​参照​ボタンの前に入力します
5. 緑色のチェックマークをクリックして、admin グループにユーザーを追加します。

トークン認証の無効化

1. パッケージbasic authをダウンロードしてインストールします。 zip パッケージ共有から。

2. クイックスタートを閉じます。

3. ファイル \crx-quickstart\repository\repository.xml を開きます。

4. タグ<LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.を探します。

5. 手順4で示したタグの内側にタグ<param name="disableTokenAuth" value="true"/>を挿入します。

6. xml ファイルを保存して閉じます。

7. QuickStartを再起動し、資格情報を使用してログインします。

SharePoint サーバーの別の認証方式のサポート

標準バージョンのコネクターでは、標準の IIS Windows 認証（基本）とフォームベースの認証（トークンベース）がサポートされています。拡張メカニズムを使用してその他の認証方式をサポートすることもできます。

次の手順では、標準認証を拡張して SharePoint サーバーの各種認証方式をサポートするためのガイドラインを示します。

1. クライアント側の特定の認証プロセスを処理するための com.day.crx.spi.sharepoint.security.SharepointConnectionFactory を実装します。

2. フラグメントホストcom.day.crx.spi.crx2sharepoint-bundleを含むフラグメントバンドルとして、SharepointConnectionFactory実装をインストールします。

   Maven を使用する際には、次の maven-bundle-plugin 設定をプロジェクトの要件に合わせて調整します。

              <plugin>
                  <groupId>org.apache.felix</groupId>
                  <artifactId>maven-bundle-plugin</artifactId>
                  <extensions>true</extensions>
                  <configuration>
                      <instructions>
                          <Export-Package />
                          <Private-Package>
                              <!-- your private package here -->
                          </Private-Package>
                          <Fragment-Host>
                              com.day.crx.spi.crx2sharepoint-bundle
                          </Fragment-Host>
                       </instructions>
                  </configuration>
              </plugin>
   

3. SharepointConnectionFactory 実装をコネクター設定に登録します。コネクターの設定ウィンドウで、「Advanced options」をクリックします。Sharepoint Connection Factory​フィールドに、実装の名前com.day.crx.spi.sharepoint.auth.CustomConnectionFactoryを指定します。

4. コネクターを再起動します。