Day JCR Connector for Microsoft Sharepoint 2010 und Microsoft SharePoint 2013, Version 4.0.
Dieser Artikel enthält Informationen zur Adobe JCR Connector für Microsoft SharePoint 2010 und Microsoft SharePoint 2013, Version 4.0.
Der SharePoint-Connector unterstützt folgende grundlegenden Funktionen:
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. Informationen zu diesen Themen finden Sie in der Dokumentation des Anbieters unter SharePoint. Diese Infrastrukturkomponenten müssen ordnungsgemäß installiert, konfiguriert und betrieben werden, damit der Connector verwendet werden kann.
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.
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.
Für den Connector ist Folgendes erforderlich:
Der SharePoint Connector kann von packageshare heruntergeladen werden.
Der Connector unterstützt Folgendes:
AEM-Versionen:
Microsoft SharePoint-Versionen:
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.
Produktfeatures, Beispiele und Hotfixes werden über AEM Package Share verteilt. Weitere Informationen finden Sie in der Dokumentation Package Share.
Um auf der AEM Begrüßungsseite auf Package Share zuzugreifen, tippen/klicken Sie auf Tools und wählen Sie Package Share. Sie benötigen ein gültiges Adobe ID, das Ihre Firma-E-Mail-Adresse enthält. Nach der Anmeldung bei Ihrem Konto müssen Sie außerdem Zugriff auf Package Share anfordern.
Gehen Sie zum Installieren des Connector-Inhaltspakets wie folgt vor:
Erstellen Sie ein Adobe-Supportticket, um das Connector-Featurepaket anzufordern.
Laden Sie das Paket herunter, wenn es verfügbar ist, und öffnen Sie Package Manager für Ihre AEM-Instanz.
Tippen/klicken Sie auf der Seite mit der Paketbeschreibung auf Install.
Tippen Sie im Dialogfeld Paket installieren auf Installieren.
Hinweis: Vergewissern Sie sich, dass Sie als Administrator angemeldet sind.
Wenn das Paket installiert ist, tippen/klicken Sie auf Schließen.
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.
Führen Sie die folgenden Schritte aus, um die URL der SharePoint Server-Instanz sowie erweiterte Optionen festzulegen:
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. Zulassungsliste des Bundles "com.day.cq.dam.cq-dam-jcr-connectors".
Führen Sie die folgenden Schritte aus, um Pakete in AEM Zulassungsliste zu installieren:
Navigieren Sie zur OSGi Management Console: http://localhost:4502/system/console/configMgr.
Suchen Sie nach dem Dienst "Apache Sling Login Admin Whitelist".
Aktivieren Sie das Kontrollkästchen zur Umgehung der Whitelist.
hinzufügen 'com.day.cq.dam.cq-dam-jcr-connectors' in der Standardeinstellung für Whitelist-Pakete
Klicken Sie auf Speichern.
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.
Vergewissern Sie sich nach dem Konfigurieren des Connectors, dass Folgendes erfüllt ist:
Gehen Sie wie folgt vor, um die SharePoint-Assets mit AEM zu synchronisieren:
Aktivieren des standardmäßig deaktivierten DAM-Synchronisierungsdiensts:
Optional: Sie können auch die Synchronisierungsverzögerung zwischen verschiedenen Synchronisierungszyklen konfigurieren:
SharePoint beinhaltet die klassische und die anspruchsbasierte Authentifizierungsmethode, die jeweils folgende Authentifizierungsarten unterstützen:
Somit stehen folgende Authentifizierungsarten zur Verfügung:
Der 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:
Konfigurieren der formularbasierten Authentifizierung
Gehe zu: http://localhost:4502/system/console/bundles
Grundlegende Authentifizierung konfigurieren (Windows)
Edit the configuration values
.com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory
fest.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:
So fügen Sie den Benutzer der Administratorgruppe hinzu:
Laden Sie das Paket basic auth
herunter und installieren Sie es. zip
von Package Share.
Schließen Sie den Schnellstart.
Öffnen Sie die Datei \crx-quickstart\repository\repository.xml.
Suchen Sie das Tag <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.
Fügen Sie das Tag <param name="disableTokenAuth" value="true"/>
in das in Schritt 4 erwähnte Tag ein.
Speichern und schließen Sie die XML-Datei.
Starten Sie QuickStart neu und melden Sie sich mit Ihren Anmeldedaten an.
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:
Implementieren Sie com.day.crx.spi.sharepoint.security.SharepointConnectionFactory
für die Clientseite Ihres spezifischen Authentifizierungsprozesses.
Installieren Sie die Implementierung von SharepointConnectionFactory
als Fragment-Bundle mit Fragmenthost 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>
Registrieren Sie die Implementierung SharepointConnectionFactory
in der Connector-Konfiguration. Klicken Sie im Konfigurationsfenster des Connectors auf Erweiterte Optionen. Geben Sie im Feld for Sharepoint Connection Factory den Namen der Implementierung com.day.crx.spi.sharepoint.auth.CustomConnectionFactory
an.
Starten Sie den Connector neu.