SharePoint コネクター

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

この記事には、Microsoft SharePoint 2010 およびMicrosoft SharePoint 2013 バージョン 4.0 のAdobeJCR Connector に関する詳細が含まれています。

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

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

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

メモ

SharePoint コネクターは AEM 6.1 サービスパック 2 でもサポートされています。コネクタは、仮想リポジトリのマウントをサポートしなくなったので、マウントできません。 Java API を使用して SharePoint リポジトリにアクセスする場合は、プロジェクトで SharePoint コネクタの JCR リポジトリ実装を使用します。

このドキュメントでは、SharePoint サーバーおよび関連する IT インフラストラクチャのインストール、設定、管理および IT 運営については取り上げていません。次のベンダードキュメントを参照してください: 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 リポジトリに対するユーザー資格情報と権限
  • サポートされているプラットフォーム

SharePointコネクタはからのダウンロードに使用できます。 パッケージ.

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

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

  • AEM バージョン:

    • AEM 6.4、6.3
  • Microsoft SharePoint バージョン:

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

メモ

コネクターでは、Microsoft で公式にサポートされている設定のみがサポートされています。MOSS 2010 および MOSS 2013 のシステム要件を参照してください。

標準インストール

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 管理コンソールに移動します。 http://localhost:4502/system/console/configMgr.
  2. を検索します。 Day JCR Connector for Microsoft Sharepoint バンドル。
  3. 設定値を編集します。
  4. Workspaces」の値として SharePoint サーバーの URL を設定します。
  5. Save」をタップまたはクリックします。

chlimage_1-81

「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 管理コンソールに移動します。http://localhost:4502/system/console/configMgr.

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

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

  4. 「 」を追加​com.day.cq.dam.cq-dam-jcr-connectors​ホワイトリストバンドルのデフォルトの'

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

chlimage_1-82

メモ

複数のワークスペースを設定する場合は、「Default Workspace Name」パラメーターにデフォルトワークスペースの名前を指定します。

認証関連のパラメーターについて詳しくは、 認証.

SharePoint 設定の検証

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

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

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

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

  1. OSGi 管理コンソールに移動します。 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 管理コンソールに移動します。 http://localhost:4502/system/console/configMgr
  2. 「DAY CQ DAM JCR Connector Asset Synchronization Service」を探します。
  3. 設定値を編集します。
  4. 「Synchronization Period」(秒単位)の値を設定します。
  5. 「保存」をクリックします。

認証の設定

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

  • 基本
  • フォームベース

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

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

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

  • 基本/NTLM 認証:コネクターでの最初の接続試行では、基本認証が使用されます。基本認証が使用できない場合は、NTLM ベースの認証に切り替えられます。
  • Formsベースの認証:ユーザーがログインフォーム(通常は Web ページ)に入力した資格情報に基づいて、SharePoint がユーザーを検証します。 認証された要求にはシステムによってトークンが発行されます。このトークンには、後続要求で 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. タグを挿入します。 <param name="disableTokenAuth" value="true"/> 手順 4 で説明したタグ内

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

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

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

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

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

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

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

    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 接続ファクトリ フィールドで、実装の名前を指定します。 com.day.crx.spi.sharepoint.auth.CustomConnectionFactory.

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

このページ