SharePoint コネクター sharepoint-connector
この記事では、Microsoft SharePoint 2010 および Microsoft SharePoint 2013 バージョン 4.0用の Adobe JCR コネクタの詳細をまとめています。
SharePoint コネクタでは次の基本機能がサポートされています。
- SharePoint からのコンテンツおよびメタデータの読み取り。
- ネイティブな SharePoint 認証および承認を適用することによる、アクセスされるコンテンツの SharePoint セキュリティ設定の確認
- コンテンツファインダーを使用したコンテンツ統合
- 外部リソースなどの AEM コンポーネントを使用した SharePoint 画像およびビデオの表示
- SharePoint と AEM Assets の同期
これらの機能はすべて、ネイティブな SharePoint web サービスを SharePoint のコンテンツおよびサービスへのインターフェイスとして使用して実装されています。
概要 getting-started
コネクタを導入する際には、次の作業を行ってください。
-
Java 7 以降がインストールされていることを確認します。
-
ソフトウェア配布からコネクタパッケージ配布ファイルをダウンロードします。
-
cq-quickstart-6.4.0.jar ファイルが格納されたディレクトリに有効な license.properties ファイルをコピーします。
-
.jar ファイルをダブルクリックして AEM を起動するか、コマンドラインから AEM を起動します。
-
パッケージマネージャーからコネクタパッケージをインストールします。
-
コネクタオプションを設定します。
SharePoint コネクタのインストール installing-sharepoint-connector
このコネクタは、インストールが容易なコンテンツパッケージとして提供されています。パッケージマネージャーを使用してパッケージをインストールし、SharePoint サーバーの URL
およびその他の設定オプションを設定します。SharePoint コンテンツは AEM リポジトリに格納されています。
インストール要件 installation-requirements
このコネクタを使用するための要件は次のとおりです。
- Java Runtime Environment 1.7 以降
- ネットワークから SharePoint web サービスを使用できること
- SharePoint サーバーの URL
- CRX および SharePoint リポジトリに対するユーザー資格情報と権限
- サポートされているプラットフォーム
SharePoint コネクタはソフトウェア配布からダウンロードできます。
サポートされているプラットフォーム supported-platforms
このコネクタでは次のプラットフォームがサポートされています。
-
AEM バージョン：
- AEM 6.4、6.3
-
Microsoft SharePoint バージョン：
- Microsoft Office SharePoint Server（MOSS）2010
- Microsoft Office SharePoint Server（MOSS）2013
-
コネクタのカスタムデプロイメント（OEM、特殊要件、認証方式のカスタマイズ）のサポートが必要な場合は、製品を使用している地域のアドビオフィスまでお問い合わせください。
標準インストール standard-installation
ソフトウェア配布は、製品の機能、例およびホットフィックスを配布するために使用されます。詳しくは、ソフトウェア配布のドキュメントを参照してください。
AEM との統合 integrating-with-aem
コネクタのコンテンツパッケージをインストールするには：
-
アドビサポートチケットを作成して、コネクタの機能パックをリクエストします。
-
パッケージが使用可能になったらそれをダウンロードし、対象の AEM インスタンスでパッケージマネージャーを開きます。
-
パッケージ説明ページで「インストール」をクリックします。
-
パッケージをインストール ダイアログで、「インストール」をクリックします。
メモ：管理者としてログインしていることを確認してください
-
パッケージがインストールされたら、「閉じる」をクリックします。
SharePoint コネクターの設定 configuring-sharepoint-connector
SharePoint コネクターのインストール後、そのコネクター用にアプリケーションおよび SharePoint レイヤーを設定します。
SharePoint リポジトリが JCR に準拠するように SharePoint サーバーの URL を設定します。追加のパラメーターを使用して、SharePoint サーバーとの接続を設定します。また、SharePoint コネクタでの認証を設定します。
SharePoint サーバーとの接続の設定 configuring-the-connection-with-the-sharepoint-server
SharePoint サーバーの URL および高度なオプションを設定するには、次の手順を実行します。
- OSGi Management コンソール（http://localhost:4502/system/console/configMgr）に移動します。
- Day JCR Connector for Microsoft Sharepoint バンドルを探します。
- 設定値を編集.
- 「Workspaces」の値として SharePoint サーバーの URL を設定します。
- 「保存」をクリックします。
「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 でバンドルを許可リストに追加するには、次の手順を実行します。
- OSGi Management コンソール（http://localhost:4502/system/console/configMgr）に移動します。
- 「Apache Sling Login Admin Whitelist」サービスを探します。
- 許可リストをスキップ を選択します。
- 許可リストバンドルのデフォルトに
com.day.cq.dam.cq-dam-jcr-connectorsを追加します。 - 「保存」をクリックします。
認証関連のパラメーターについて詳しくは、認証を参照してください。
SharePoint 設定の検証 verifying-the-sharepoint-setup
コネクタを設定した後、次の点を検証してください。
- SharePoint サーバーが実行されており、コネクタインスタンスから web サービスにアクセスできること
- SharePoint ユーザー資格情報が有効であり、ユーザーが必要な SharePoint 権限を持っていること
- コネクタが適切にインストールおよび設定されていること
SharePoint サーバーとの DAM 同期の設定 configuring-dam-sync-with-the-sharepoint-server
SharePoint Assets を AEM と同期するには、次の手順を実行します。
- OSGi Management Console（http://localhost:4502/system/console/configMgr）に移動します。
- 「Default DAMAssetSynchronization」サービスを探します。
- 設定値を編集.
- SharePoint サイトへのアクセス権を持つユーザーのユーザー名とそれに対応するパスワードを設定します。
- 「保存」をクリックします。
DAM 同期サービスを有効にします（デフォルトでは無効になっています）。
- OSGi web コンソールのコンポーネント（http://localhost:4502/system/console/components）に移動します。
- 「com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService」を探します。
- 「有効化」をクリックします。
オプションで、異なる同期サイクル間の同期遅延を設定できます。
- OSGi Management Console（http://localhost:4502/system/console/configMgr）に移動します。
- 「DAY CQ DAM JCR Connector Asset Synchronization Service」を探します。
- 設定値を編集.
- 「同期期間」（秒単位）の値を設定します。
- 「保存」をクリックします。
認証の設定 configuring-authentication
SharePoint ではクラシック認証方式と要求ベースの認証方式を使用でき、いずれの認証方式でも次の認証タイプがサポートされています。
- 基本
- フォームベース
特に、次の認証タイプを使用できます。
- クラシック：基本
- クラシック：Forms ベース
- 要求：基本
- 要求：Forms ベース
Microsoft SharePoint 2010 および Microsoft SharePoint 2013 のバージョン 4.0 用 AEM JCR Connector は、次のモードで動作する要求ベースの認証 (Microsoftが推奨 ) をサポートしています。
- 基本／NTLM 認証：コネクタでの最初の接続試行では、基本認証が使用されます。基本認証が使用できない場合は、NTLM ベースの認証に切り替えられます。
- フォームベースの認証：SharePoint では、ユーザーがログインフォーム（通常は web ページ）に入力した資格情報に基づいてユーザーの検証が行われます。認証されたリクエストにはシステムによってトークンが発行されます。このトークンには、後続リクエストで ID の再確立に使用されるキーが含まれています。
Forms ベースの認証の設定
http://localhost:4502/system/console/bundles に移動します。
- OSGI／Configuration をクリックします。
- 「Day JCR Connector for Microsoft Sharepoint」を探します。
- 「設定値を編集」をクリックします。
- 「Sharepoint Connection Factory」の値として「com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory」を設定します。
- 「保存」をクリックします。
基本認証の設定（Windows）
- トークン認証を無効にします。
- http://localhost:4502/system/console/bundles に移動します。
- OSGI／Configuration をクリックします。
- Day JCR Connector for Microsoft Sharepoint を探します。
- 「
Edit the configuration values」をクリックします。 - 「Sharepoint Connection Factory」の値として「
com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory」を設定します。 - 「保存」をクリックします。
コネクターから SharePoint コンテンツにアクセスできるのは、AEM と SharePoint の両方で認証されたユーザーのみです。
認証用のコネクタ拡張を使用してカスタム認証モジュールを作成することもできます。このモジュールを使用すると、例えば、AEM ユーザーによるアクセスを特定の SharePoint ユーザーにマッピングできます。SharePoint ユーザーに対応する AEM ユーザーを作成して（ユーザー名とパスワードが一致する必要があります）、コネクタインスタンスにマッピングされた SharePoint コンテンツを確認できるようにします。
AEM でユーザーを作成するには、以下の手順に従います。
- admin ユーザーとして http://localhost:9502/ にログインします。
- 「ツール」をクリックします。
- 「セキュリティ」をクリックします。
- 「ユーザー」をクリックします。
- 「ユーザーを作成」をクリックします。
- ユーザー ID（SharePoint へのアクセス権限を持つユーザー名）を指定します。
- 対応するパスワードを指定します。
- 緑色のチェックマークをクリックして、ユーザーを作成します。
admin グループにユーザーを追加するには：
- グループ管理に移動します。
- 「a」ノードをクリックします。
- 「管理者」をクリックします。
- 「参照」ボタンの前のテキストボックスに、先ほど作成したユーザー ID を入力します。
- 緑色のチェックマークをクリックして、admin グループにユーザーを追加します。
トークン認証の無効化 disable-token-authentication
-
パッケージ
basic authをダウンロードし、インストールします。zipをソフトウェア配布からダウンロードおよびインストールします。 -
クイックスタートを閉じます。
-
ファイル \crx-quickstart\repository\repository.xml を開きます。
-
タグ
<LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.を検索 -
ステップ 4 で示したタグ内に、タグ
<param name="disableTokenAuth" value="true"/>を挿入します。 -
xml ファイルを保存して閉じます。
-
クイックスタートを再起動してから、自分の資格情報を使用してログインしてください。
SharePoint サーバーの別の認証方式のサポート supporting-different-authentication-methods-of-the-sharepoint-server
標準バージョンのコネクターでは、標準の IIS Windows 認証（基本）とフォームベースの認証（トークンベース）がサポートされています。拡張メカニズムを使用してその他の認証方式をサポートすることもできます。
次の手順では、標準認証を拡張して SharePoint サーバーの各種認証方式をサポートするためのガイドラインを示します。
-
クライアント側の特定の認証プロセスを処理するための
com.day.crx.spi.sharepoint.security.SharepointConnectionFactoryを実装します。 -
フラグメントホスト
com.day.crx.spi.crx2sharepoint-bundleを使用して、SharepointConnectionFactory実装をフラグメントバンドルとしてインストールします。Maven を使用する際には、次の
maven-bundle-plugin設定をプロジェクトの要件に合わせて調整します。code language-xml <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> -
SharepointConnectionFactory実装をコネクター設定に登録します。コネクターの設定ウィンドウで、「Advanced options」をクリックします。Sharepoint Connection Factory フィールドで、com.day.crx.spi.sharepoint.auth.CustomConnectionFactory実装の名前を指定します。 -
コネクターを再起動します。