SharePoint コネクター sharepoint-connector
Microsoft SharePoint 2010 およびMicrosoft SharePoint 2013、バージョン 4.0 用の Day JCR Connector。
この記事では、Microsoft SharePoint 2010 および Microsoft SharePoint 2013 バージョン 4.0用の Adobe JCR コネクタの詳細をまとめています。
SharePointコネクタは、次の基本機能をサポートしています。
- SharePoint からのコンテンツおよびメタデータの読み取り。
- ネイティブのSharePoint認証および承認を適用して、アクセスされたコンテンツのSharePointセキュリティ設定を確認する
- コンテンツファインダーを使用したコンテンツの統合
- 外部リソースなどのAEMコンポーネントを使用したSharePointの画像およびビデオの表示
- SharePointとAEM Assetsの同期
すべての機能は、SharePointのコンテンツおよびサービスへのインターフェイスとしてネイティブのSharePoint Web サービスを使用して実装されます。
概要 getting-started
コネクタの使用を開始するには、次の手順を実行します。
-
Java 7 以降がインストールされていることを確認します。
-
パッケージ共有からコネクタパッケージ配布ファイルをダウンロードします。
-
有効な license.properties ファイルを、 cq-quickstart-6.4.0.jar ファイル。
-
.jar ファイルをダブルクリックまたはタップして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、特別な要件、カスタマイズされた認証方法）のサポートが必要な場合は、地域のAdobeオフィスにお問い合わせください。
標準インストール standard-installation
AEM Package Share は、製品の機能、例、ホットフィックスの配布に使用されます。 詳しくは、 パッケージ共有ドキュメント.
AEMのようこそページでパッケージ共有にアクセスするには、をタップまたはクリックします。 ツール 次に、 パッケージ共有. 会社の電子メールアドレスを含む有効なAdobe IDが必要です。 また、アカウントにログインした後で、パッケージ共有へのアクセスを申請します。
AEMとの統合 integrating-with-aem
コネクタコンテンツパッケージをインストールするには、以下を実行します。
-
Adobeサポートチケットを開き、コネクタ featurepack をリクエストします。
-
パッケージが使用可能になったら、そのパッケージをダウンロードし、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 バンドルを探します。
- 設定値を編集.
- SharePointサーバーの URL を Workspaces.
- 「保存」をタップまたはクリックします。
「Workspaces」および「デフォルトのワークスペース名」のパラメーター：
デフォルトでは、コネクタは単一の JCR ワークスペースを公開します。 このワークスペースで公開される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 ではクラシック認証方式と要求ベースの認証方式を使用でき、いずれの認証方式でも次の認証タイプがサポートされています。
- 基本
- フォームベース
特に、次の種類の認証を使用できます。
- Classic-Basic
- クラシック —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／設定をクリックします。
- 「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でアクセス権を持つユーザー名 ) を入力します
- 対応するパスワードを入力
- 緑のチェックマークをクリックして、ユーザを作成します。
管理者グループにユーザーを追加するには：
- グループ管理に移動
- 「a」ノードをクリックします。
- 「管理者」をクリックします
- 上で作成したユーザー ID を前のテキストボックスに入力します。 参照 ボタン
- 緑のチェックマークをクリックして、ユーザを管理グループに追加します。
トークン認証の無効化 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実装の名前を指定します。 -
コネクターを再起動します。