Show Menu
THEMEN×

SharePoint-Connector

Day JCR Connector for Microsoft Sharepoint 2010 und Microsoft SharePoint 2013, Version 4.0.
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-Webdienste als Schnittstelle für SharePoint-Inhalte und -Dienste verwendet.
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 mit Java-APIs auf das Sharepoint-Repository zugreifen möchten, verwenden Sie die JCR-Repository-Implementierung des SharePoint Connectors in Ihrem Projekt.
Installation, Konfiguration, Verwaltung und IT-Vorgänge der SharePoint Server-Instanz und der dazugehörigen IT-Infrastruktur werden in diesem Dokument nicht behandelt. See vendor documentation on SharePoint for information about these topics. Diese Infrastrukturkomponenten müssen ordnungsgemäß installiert, konfiguriert und betrieben werden, damit der Connector verwendet werden kann.

Erste Schritte

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 Package Share 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/-tippen 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

Der Connector liegt als Inhaltspaket vor und lässt sich ganz einfach installieren. Installieren Sie das Paket mit Package Manager und legen Sie dann die SharePoint Server-URL fest und andere Konfigurationsoptionen. Der SharePoint-Inhalt steht im AEM-Repository zur Verfügung.

Installationsanforderungen

Für den Connector ist Folgendes erforderlich:
  • Java Runtime Environment 1.7 oder höher
  • SharePoint-Webdienste (verfügbar über das Netzwerk)
  • SharePoint Server-URL
  • Benutzeranmeldeinformationen und -berechtigungen für CRX- und SharePoint-Repositorys
The SharePoint connector is available for downloading from packageshare .

Unterstützte Plattformen

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.
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

Produktfeatures, Beispiele und Hotfixes werden über AEM Package Share verteilt. For details, see the Package Share documentation .
To access Package Share on the AEM Welcome page, tap/click Tools and then select Package Share . Sie benötigen eine gültige Adobe-ID, die Ihre Unternehmens-E-Mail-Adresse enthält. Nach der Anmeldung bei Ihrem Konto müssen Sie außerdem Zugriff auf Package Share anfordern.

Integrieren mit AEM

Gehen Sie zum Installieren des Connector-Inhaltspakets wie folgt vor:
  1. Erstellen Sie ein Adobe-Supportticket, um das Connector-Featurepaket anzufordern.
  2. Laden Sie das Paket herunter, wenn es verfügbar ist, und öffnen Sie Package Manager für Ihre AEM-Instanz.
  3. Tap/click Install from the package description page.
  4. From the Install Package dialog, tap/click Install .
    Hinweis: Vergewissern Sie sich, dass Sie als Administrator angemeldet sind.
  5. When the package is installed, tap/click Close .

Konfigurieren des SharePoint-Connectors

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

Führen Sie die folgenden Schritte aus, um die URL der SharePoint Server-Instanz sowie erweiterte Optionen festzulegen:
  1. Navigate to the OSGi Management Console: http://localhost:4502/system/console/configMgr .
  2. Search for the Day JCR Connector for Microsoft Sharepoint bundle.
  3. Bearbeiten Sie die Konfigurationswerte.
  4. Legen Sie den Wert von Workspaces auf die SharePoint Server-URL fest.
  5. Tippen/Klicken Sie auf Speichern .
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 das folgende Format: <name> = <url> wohin gehört <name> der Name des JCR-Arbeitsbereichs und <url> ist die URL des SharePoint-Servers für diesen Arbeitsbereich.
Führen Sie in AEM neben den obigen Konfigurationsschritten noch einen weiteren Schritt aus. Fügen Sie das Bundle com.day.cq.dam.cq-dam-jcr-connectors der Whitelist hinzu.
Gehen Sie wie folgt vor, um Bundles in AEM der Whitelist hinzuzufügen:
  1. Navigieren Sie zur OSGi Management Console: 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. Add ' com.day.cq.dam.cq-dam-jcr-connectors ' in whitelist bundles default
  5. Klicken Sie auf Speichern.
Wenn Sie mehrere Workspaces konfigurieren, geben Sie im Parameter „Name des Standard-Workspace“ den Namen des Standard-Workspace an.
For additional information around authentication-related parameters, see Authentication .

Überprüfen der SharePoint-Einrichtung

Vergewissern Sie sich nach dem Konfigurieren des Connectors, dass Folgendes erfüllt ist:
  • Die SharePoint Server-Instanz wird ausgeführt und die Connector-Instanz hat Zugriff auf die Webdienste.
  • Die SharePoint-Benutzeranmeldeinformationen sind gültig und der Benutzer verfügt über die erforderlichen SharePoint-Berechtigungen.
  • Der Connector ist installiert und ordnungsgemäß konfiguriert.

Konfigurieren der DAM-Synchronisierung mit der SharePoint Server-Instanz

Gehen Sie wie folgt vor, um die SharePoint-Assets mit AEM zu synchronisieren:
  1. Navigate to the OSGi Management Console: http://localhost:4502/system/console/configMgr .
  2. Suchen Sie nach dem Dienst „Default DAMAssetSynchronization“.
  3. Bearbeiten Sie die Konfigurationswerte.
  4. Legen Sie den Benutzernamen und das dazugehörige Kennwort des Benutzers fest, der Zugriff auf die SharePoint-Website hat.
  5. Klicken Sie auf Speichern.
Aktivieren des standardmäßig deaktivierten DAM-Synchronisierungsdiensts:
  1. Navigate to the OSGi Web Console Components: http://localhost:4502/system/console/components
  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. Navigate to the OSGi Management Console: http://localhost:4502/system/console/configMgr
  2. Suchen Sie nach „DAY CQ DAM JCR Connector Asset Synchronization Service“.
  3. Bearbeiten Sie die Konfigurationswerte.
  4. Legen Sie den Wert des Synchronisierungszeitraums (in Sekunden) fest.
  5. Klicken Sie auf „Speichern“.

Konfigurieren der Authentifizierung

SharePoint beinhaltet die klassische und die anspruchsbasierte Authentifizierungsmethode, die jeweils folgende Authentifizierungsarten unterstützen:
  • Einfach
  • Formularbasiert
Somit stehen folgende Authentifizierungsarten zur Verfügung:
  • Klassisch/Standard
  • Klassisch/formularbasiert
  • Anspruchsbasiert/Standard
  • Anspruchs-/formularbasiert
AEM JCR Connector for Microsoft SharePoint 2010 und Microsoft SharePoint 2013, Version 4.0. unterstützt die bedarfsbasierte Authentifizierung (die von Microsoft vorgeschlagen wird), die in den folgenden Modi funktioniert:
  • 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.
  • Forms-basierte Authentifizierung : SharePoint überprüft Benutzer anhand von Anmeldedaten, die Benutzer in ein Anmeldeformular eingeben (normalerweise eine Webseite). 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
  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 von „SharePoint-Verbindungsfactory“ auf „com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory“ fest.
  5. Klicken Sie auf Speichern .
Grundlegende Authentifizierung konfigurieren (Windows)
  1. Klicken Sie auf „OSGi“ > „Konfiguration“.
  2. Suchen Sie nach Day JCR Connector for Microsoft Sharepoint .
  3. Klicken Sie auf Edit the configuration values .
  4. Legen Sie den Wert für die SharePoint-Verbindungsfactory auf com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory fest.
  5. 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-Benutzer bestimmten SharePoint-Benutzern zuordnet. Erstellen Sie AEM-Benutzer, die SharePoint-Benutzern entsprechen (Übereinstimmung von Benutzername und Kennwort), um SharePoint-Inhalt anzeigen zu können, der der Connector-Instanz zugeordnet ist.
So erstellen Sie einen Benutzer in AEM:
  1. Melden Sie sich unter http://localhost:9502/ als Administratorbenutzer 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 an (Benutzername mit Zugriff auf SharePoint)
  7. Geben Sie das entsprechende Kennwort an.
  8. Klicken Sie auf das grüne Häkchen, um den Benutzer zu erstellen.
So fügen Sie den Benutzer der Administratorgruppe hinzu:
  1. Navigieren Sie zur Gruppenverwaltung.
  2. Klicken Sie auf den Knoten "a"
  3. Klicken Sie auf „Administratoren“.
  4. Type the user ID create above in the text box before Browse button
  5. Klicken Sie auf das grüne Häkchen, um den Benutzer der Administratorgruppe hinzuzufügen.

Deaktivieren der Tokenauthentifizierung

  1. Download and install the package basic auth . zip von Package Share.
  2. Schließen Sie den Schnellstart.
  3. Öffnen Sie die Datei \crx-quickstart\repository\repository.xml .
  4. Tag suchen <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.
  5. Insert the tag <param name="disableTokenAuth" value="true"/> inside the tag mentioned in step 4.
  6. Speichern und schließen Sie die XML-Datei.
  7. Starten Sie QuickStart neu und melden Sie sich mit Ihren Anmeldedaten an.

Unterstützen verschiedener Authentifizierungsmethoden der SharePoint Server-Instanz

In der Standardversion unterstützt der Connector die Windows -IIS-Standardauthentifizierung sowie die formularbasierte Authentifizierung (tokenbasiert). 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 Clientseite Ihres spezifischen Authentifizierungsprozesses.
  2. Install the SharepointConnectionFactory implementation as a fragment bundle with 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:
               <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 . In the for Sharepoint Connection Factory field, specify the name of the implementation com.day.crx.spi.sharepoint.auth.CustomConnectionFactory .
  4. Starten Sie den Connector neu.