DokumentationAEM 6.5Benutzerhandbuch

SharePoint-Connector sharepoint-connector

Last update: Fri Aug 02 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Gilt für:
  • Experience Manager 6.5
  • Themen:

Erstellt für:

  • Admin

Dieser Artikel enthält Details zum Adobe JCR-Connector für Microsoft SharePoint 2010 und Microsoft SharePoint 2013, Version 4.0.

Der SharePoint-Connector unterstützt folgende grundlegenden Funktionen:

  • Lesen von Inhalten und Metadaten aus SharePoint.
  • Berücksichtigung von SharePoint-Sicherheitseinstellungen für aufgerufene Inhalte mittels Anwendung nativer SharePoint-Authentifizierung und -Autorisierung
  • Inhaltsintegration mithilfe der Inhaltssuche
  • Anzeige von SharePoint-Bildern und -Videos unter Verwendung von AEM-Komponenten (beispielsweise externe Ressource)
  • Synchronisierung von SharePoint mit AEM Assets

Bei der Implementierung aller Funktionen werden die nativen SharePoint-Web-Dienste als Schnittstelle für SharePoint-Inhalte und -Dienste verwendet.

NOTE
Der SharePoint-Connector wird auch mit AEM 6.1 Service Pack 2 unterstützt. Die Einbindung virtueller Repositorys wird vom Connector nicht mehr unterstützt, weshalb keine Einbindung möglich ist. Wenn Sie über Java-APIs auf das SharePoint-Repository zugreifen möchten, verwenden Sie in Ihrem Projekt die JCR-Repository-Implementierung des SharePoint-Connectors.
Installation, Konfiguration, Verwaltung und IT-Vorgänge der SharePoint-Server-Instanz und der dazugehörigen IT-Infrastruktur werden in diesem Dokument nicht behandelt. Informationen zu diesen Themen finden Sie in der SharePoint-Dokumentation des Anbieters. Diese Infrastrukturkomponenten müssen ordnungsgemäß installiert, konfiguriert und betrieben werden, damit der Connector verwendet werden kann.

Erste Schritte getting-started

Gehen Sie zur Vorbereitung der Connector-Verwendung wie folgt vor:

  • Vergewissern Sie sich, dass bei Ihnen mindestens Java 7 installiert ist.

  • Laden Sie die Paketverteilungsdatei für den Connector von Software Distribution herunter.

  • Kopieren Sie eine gültige Datei vom Typ license.properties in das Verzeichnis, das die Datei cq-quickstart-6.4.0.jar enthält.

  • Doppelklicken Sie auf die JAR-Datei, um AEM zu starten, oder starten Sie AEM über die Befehlszeile.

  • Installieren Sie das Connector-Paket über Package Manager.

  • Konfigurieren Sie die Connector-Optionen.

Installieren des SharePoint-Connectors installing-sharepoint-connector

Der Connector liegt als Inhaltspaket vor, was das Installieren ganz einfach macht. Installieren Sie das Paket über Package Manager und legen Sie anschließend die SharePoint-Server-URL und andere Konfigurationsoptionen fest. Der SharePoint-Inhalt steht im AEM-Repository zur Verfügung.

Installationsanforderungen installation-requirements

Für den Connector ist Folgendes erforderlich:

  • Java Runtime Environment 1.7 oder höher
  • SharePoint-Web-Dienste (verfügbar über das Netzwerk)
  • SharePoint-Server-URL
  • Benutzeranmeldeinformationen und -berechtigungen für CRX- und SharePoint-Repositorys
  • Unterstützte Plattformen

Der SharePoint-Connector steht unter Software Distribution zum Download bereit.

Unterstützte Plattformen supported-platforms

Der Connector unterstützt Folgendes:

  • AEM-Versionen:

    • AEM 6.4, 6.3

  • Microsoft SharePoint-Versionen:

    • Microsoft Office SharePoint Server (MOSS) 2010
    • Microsoft Office SharePoint Server (MOSS) 2013

  • Wenn Sie Unterstützung für benutzerdefinierte Implementierungen des Connectors (OEM, besondere Anforderungen, angepasste Authentifizierungsmethoden) benötigen, wenden Sie sich die Adobe-Niederlassung für Ihre Region.

NOTE
Der Connector unterstützt nur Konfigurationen, die offiziell von Microsoft unterstützt werden. Weitere Informationen finden Sie in den Systemanforderungen für MOSS 2010 und MOSS 2013.

Standardinstallation standard-installation

Produktfeatures, Beispiele und Hotfixes werden über Software Distribution verteilt. Weitere Informationen finden Sie unter Dokumentation zu Software Distribution.

Integrieren in AEM integrating-with-aem

So installieren Sie das Connector-Inhaltspaket:

  1. Öffnen Sie ein Adobe-Support-Ticket, um das Connector-Featurepack anzufordern.

  2. Laden Sie das Paket herunter, wenn es verfügbar ist, und öffnen Sie Package Manager für Ihre AEM-Instanz.

  3. Klicken Sie auf der Seite mit der Paketbeschreibung auf Installieren.

  4. Kklicken Sie im Dialogfeld Paket installieren auf Installieren.

    Hinweis: Vergewissern Sie sich, dass Sie als Admin angemeldet sind.

  5. Klicken Sie nach Abschluss der Paketinstallation auf Schließen.

Konfigurieren des SharePoint-Connectors configuring-sharepoint-connector

Konfigurieren Sie nach der Installation des SharePoint-Connectors die Anwendung und die SharePoint-Ebenen für den Connector.

Legen Sie die SharePoint Server-URL fest, um Ihr SharePoint-Repository JCR-konform zu machen. Sie können weitere Parameter festlegen, um die Verbindung mit der SharePoint Server-Instanz zu konfigurieren. Konfigurieren Sie außerdem die Authentifizierung mit dem SharePoint-Connector.

Konfigurieren der Verbindung mit der SharePoint Server-Instanz configuring-the-connection-with-the-sharepoint-server

Führen Sie die folgenden Schritte aus, um die URL der SharePoint-Server-Instanz sowie erweiterte Optionen festzulegen:

  1. Navigieren Sie zur OSGi-Verwaltungskonsole: http://localhost:4502/system/console/configMgr.
  2. Suchen Sie nach dem Bundle Day JCR Connector for Microsoft Sharepoint.
  3. Bearbeiten der Konfigurationswerte.
  4. Legen Sie den Wert von Workspaces auf die SharePoint Server-URL fest.
  5. Klicken Sie auf Speichern.

chlimage_1-62

Parameter „Workspaces“ und „Name des Standard-Workspace“:

Standardmäßig macht der Connector einen einzelnen JCR-Workspace verfügbar. Die SharePoint Server-Instanz, die durch diesen Workspace verfügbar gemacht wird, wird mithilfe des Konfigurationsparameters „SharePoint Server-URL“ festgelegt.

Der Connector kann auch für mehrere Workspaces konfiguriert werden. In diesem Fall werden die einzelnen Workspaces jeweils der URL der SharePoint Server-Instanz zugeordnet, die über den Workspace verfügbar gemacht wird. Einen Workspace können Sie hinzufügen, indem Sie dem Parameter „Workspaces“ eine Workspace-Definition hinzufügen. Eine Workspace-Definition hat folgendes Format:
<name>= <url>. <name> ist der Name des JCR-Workspace. <url> ist die URL der SharePoint-Server-Instanz für diesen Workspace.

Führen Sie in AEM neben den obigen Konfigurationsschritten noch einen weiteren Schritt aus. Zulassungsliste des Bundles com.day.cq.dam.cq-dam-jcr-connectors.

Gehen Sie wie folgt vor, um in AEM Bundles der Liste hinzuzufügen:

  1. Navigieren Sie zur OSGi-Verwaltungskonsole: http://localhost:4502/system/console/configMgr.
  2. Suchen Sie nach dem Dienst „Apache Sling Login Admin Whitelist“.
  3. Aktivieren Sie das Kontrollkästchen zur Umgehung der Whitelist.
  4. Fügen Sie com.day.cq.dam.cq-dam-jcr-connectors unter „Whitelist-Bundles (Standard)“ hinzu.
  5. Klicken Sie auf „Speichern“.

chlimage_1-82

NOTE
Wenn Sie mehrere Workspaces konfigurieren, geben Sie im Parameter „Name des Standard-Workspace“ den Namen des Standard-Workspace an.

Weitere Informationen zu authentifizierungsbezogenen Parametern finden Sie unter Authentifizierung.

Überprüfen des Sharepoint-Setups verifying-the-sharepoint-setup

Vergewissern Sie sich nach dem Konfigurieren des Connectors, dass Folgendes erfüllt ist:

  • Der SharePoint-Server wird ausgeführt und die Connector-Instanz hat Zugriff auf die Web-Dienste.
  • Die SharePoint-Benutzeranmeldeinformationen sind gültig und die Person verfügt über die erforderlichen SharePoint-Berechtigungen.
  • Der Connector ist installiert und ordnungsgemäß konfiguriert.

Konfigurieren der DAM-Synchronisierung mit dem SharePoint-Server configuring-dam-sync-with-the-sharepoint-server

Gehen Sie wie folgt vor, um die SharePoint-Assets mit AEM zu synchronisieren:

  1. Navigieren Sie zur OSGi-Verwaltungskonsole: http://localhost:4502/system/console/configMgr.
  2. Suchen Sie nach dem Dienst „Default DAMAssetSynchronization“.
  3. Bearbeiten der Konfigurationswerte.
  4. Legen Sie den Benutzernamen und das dazugehörige Kennwort der Person fest, die Zugriff auf die SharePoint-Site hat.
  5. Klicken Sie auf „Speichern“.

Aktivieren des (standardmäßig deaktivierten) DAM-Synchronisierungsdienstes:

  1. Navigieren Sie zu den Komponenten der OSGi-Web-Konsole: http://localhost:4502/system/console/component
  2. Suchen Sie nach „com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService“.
  3. Klicken Sie auf „Aktivieren“.

Optional: Sie können auch die Synchronisierungsverzögerung zwischen verschiedenen Synchronisierungszyklen konfigurieren:

  1. Navigieren Sie zur OSGi-Verwaltungskonsole: http://localhost:4502/system/console/configMgr
  2. Suchen Sie nach „DAY CQ DAM JCR Connector Asset Synchronization Service“.
  3. Bearbeiten der Konfigurationswerte.
  4. Legen Sie den Wert des Synchronisierungszeitraums (in Sekunden) fest.
  5. Klicken Sie auf „Speichern“.

Konfigurieren der Authentifizierung configuring-authentication

SharePoint beinhaltet die klassische und die anspruchsbasierte Authentifizierungsmethode, die jeweils folgende Authentifizierungsarten unterstützen:

  • Allgemein
  • Formularbasiert

Somit stehen folgende Authentifizierungsarten zur Verfügung:

  • Klassisch/Standard
  • Klassisch/formularbasiert
  • Anspruchsbasiert/Standard
  • Anspruchs-/formularbasiert

Der JCR-Connector für Microsoft SharePoint 2010 und Microsoft SharePoint 2013, Version 4.0, von AEM unterstützt eine anspruchsbasierte Authentifizierung (wie von Microsoft empfohlen), die in folgenden Modi ausgeführt wird:

  • Standard-/NTLM-Authentifizierung: Der Connector versucht zunächst, unter Verwendung der Standardauthentifizierung eine Verbindung herzustellen. Steht diese Option nicht zur Verfügung, wird die NTLM-basierte Authentifizierung verwendet.
  • Formularbasierte Authentifizierung: SharePoint validiert Benutzende auf der Grundlage von Anmeldeinformationen, die sie in ein Anmeldeformular (üblicherweise eine Webseite) eingeben. Das System gibt für authentifizierte Anforderungen ein Token aus, das einen Schlüssel zur Identitätsfeststellung bei Folgeanforderungen enthält.

Konfigurieren der formularbasierten Authentifizierung

Navigieren Sie zu: http://localhost:4502/system/console/bundles.

  1. Klicken Sie auf „OSGi“ > „Konfiguration“.
  2. Suchen Sie nach „Day JCR Connector for Microsoft Sharepoint“
  3. Klicken Sie auf „Konfigurationswerte bearbeiten“
  4. Legen Sie den Wert für die SharePoint-Verbindungs-Factory auf „com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory“ fest.
  5. Klicken Sie auf Speichern.

Konfigurieren der Standardauthentifizierung (Windows)

  1. Deaktivieren Sie die Token-Authentifizierung.
  2. Navigieren Sie zu: http://localhost:4502/system/console/bundles.
  3. Klicken Sie auf „OSGi“ > „Konfiguration“.
  4. Suchen Sie nach Day JCR Connector for Microsoft Sharepoint.
  5. Klicken Sie auf Edit the configuration values.
  6. Legen Sie den Wert für die SharePoint-Verbindungs-Factory auf com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory fest.
  7. Klicken Sie auf Speichern.

Nur Benutzer, die sowohl in AEM als auch in SharePoint authentifiziert sind, können über den Connector auf den SharePoint-Inhalt zugreifen.

Sie können auch die Connector-Erweiterung zur Authentifizierung verwenden, um ein benutzerdefiniertes Authentifizierungsmodul zu erstellen, das beispielsweise den Zugriff durch AEM-Benutzende bestimmten SharePoint-Benutzenden zuordnet. Erstellen Sie AEM-Benutzende, die SharePoint-Benutzenden entsprechen (Übereinstimmung von Benutzername und Kennwort), um SharePoint-Inhalte anzeigen zu können, der der Connector-Instanz zugeordnet sind.

Erstellen von Benutzenden in AEM

  1. Melden Sie sich unter http://localhost:9502/ als Admin an.
  2. Klicken Sie auf „Tools“.
  3. Klicken Sie auf „Sicherheit“.
  4. Klicken Sie auf „Benutzer“.
  5. Klicken Sie auf Benutzer erstellen.
  6. Geben Sie die Benutzer-ID (Benutzername einer Benutzerin oder eines Benutzers mit Zugriff auf SharePoint) an.
  7. Geben Sie das entsprechende Passwort an.
  8. Klicken Sie auf das grüne Häkchen, um die Benutzerin oder den Benutzer zu erstellen.

So fügen Sie die Person der Administratorgruppe hinzu:

  1. Navigieren Sie zur Gruppenverwaltung.
  2. Klicken Sie auf den Knoten „a“.
  3. Klicken Sie auf „Administratoren“.
  4. Geben Sie die weiter oben erstellte Benutzer-ID in das Textfeld vor der Schaltfläche Durchsuchen ein.
  5. Klicken Sie auf das grüne Häkchen, um die Benutzerin oder den Benutzer der Administratorgruppe hinzuzufügen.

Deaktivieren der Token-Authentifizierung disable-token-authentication

  1. Laden Sie das Paket basic auth. zip aus Software Distribution.

  2. Schließen Sie die Schnellstartanleitung.

  3. Öffnen Sie die Datei \crx-quickstart\repository\repository.xml.

  4. Suchen Sie das Tag <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>..

  5. Fügen Sie das Tag <param name="disableTokenAuth" value="true"/> in das in Schritt 4 erwähnte Tag ein.

  6. Speichern und schließen Sie die XML-Datei.

  7. Starten Sie den Schnellstart neu und melden Sie sich mit Ihren Anmeldeinformationen an.

Unterstützen verschiedener Authentifizierungsmethoden der SharePoint Server-Instanz supporting-different-authentication-methods-of-the-sharepoint-server

In der Standardversion unterstützt der Connector die Windows-IIS-Standardauthentifizierung sowie die formularbasierte Authentifizierung (Token-basiert). Die anderen Authentifizierungsmethoden können über den Erweiterbarkeitsmechanismus unterstützt werden.

Die folgenden Schritte bieten Richtlinien für die Erweiterung der Standardauthentifizierung, um verschiedene Authentifizierungsmethoden der SharePoint Server-Instanz zu unterstützen:

  1. Implementieren Sie com.day.crx.spi.sharepoint.security.SharepointConnectionFactory für die Client-Seite Ihres spezifischen Authentifizierungsprozesses.

  2. Installieren Sie die Implementierung SharepointConnectionFactory als Fragment-Bundle mit dem Fragment-Host com.day.crx.spi.crx2sharepoint-bundle.

    Passen Sie bei Verwendung von Maven die folgende Konfiguration von maven-bundle-plugin an die Anforderungen Ihres Projekts an:

    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>

  3. Registrieren Sie die Implementierung SharepointConnectionFactory in der Connector-Konfiguration. Klicken Sie im Konfigurationsfenster des Connectors auf Erweiterte Optionen. Geben Sie im Feld SharePoint-Verbindungs-Factory den Namen der Implementierung com.day.crx.spi.sharepoint.auth.CustomConnectionFactory an.

  4. Starten Sie den Connector neu.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2