SharePoint-Connector sharepoint-connector

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

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 die folgenden Basisfunktionen:

  • Lesen von Inhalten und Metadaten aus SharePoint.
  • Anerkennen von SharePoint-Sicherheitseinstellungen für aufgerufene Inhalte durch Anwendung der nativen SharePoint-Authentifizierung und -Autorisierung
  • Inhaltsintegration mit Content Finder
  • Verwenden AEM Komponenten wie der externen Ressource zur Anzeige von SharePoint-Bildern und -Videos
  • Synchronisieren von SharePoint mit AEM Assets

Alle Funktionen werden mithilfe der nativen SharePoint-Webdienste als Schnittstelle zu SharePoint-Inhalten und -Diensten implementiert.

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 wie folgt vor, um mit dem Connector zu beginnen:

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

  • Laden Sie die Verteilungsdatei des Connector-Pakets von Package Share herunter.

  • Gültige kopieren license.properties in den Ordner, der die cq-quickstart-6.4.0.jar -Datei.

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

  • Installieren Sie das Connector-Paket aus Package Manager.

  • Konfigurieren Sie die Connector-Optionen.

Installieren des SharePoint-Connectors installing-sharepoint-connector

Der Connector ist ein Inhaltspaket, das die einfache Installation erleichtert. Installieren Sie das Paket mithilfe von Package Manager und legen Sie dann die SharePoint-Server-URL fest.
und anderen Konfigurationsoptionen. 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
  • Über das Netzwerk verfügbare SharePoint-Webdienste
  • SharePoint-Server-URL
  • Benutzeranmeldeinformationen und -berechtigungen für CRX- und SharePoint-Repositorys
  • Unterstützte Plattformen

Der SharePoint-Connector kann über heruntergeladen werden. packageshare.

Unterstützte Plattformen supported-platforms

Der Connector unterstützt Folgendes:

  • AEM:

    • 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 Bereitstellungen des Connectors benötigen (OEM, besondere Anforderungen, benutzerdefinierte Authentifizierungsmethoden), wenden Sie sich an das Adobe Office für Ihre .

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

AEM Package Share wird verwendet, um Produktfunktionen, Beispiele und Hotfixes zu verteilen. Weitere Informationen finden Sie unter Package Share-Dokumentation.

Um auf die Paketfreigabe auf der AEM Begrüßungsseite zuzugreifen, tippen/klicken Sie auf Instrumente und wählen Sie Package Share. Sie benötigen einen gültigen Adobe ID, der Ihre Unternehmens-E-Mail-Adresse enthält. Nach der Anmeldung bei Ihrem Konto können Sie außerdem Package Share-Zugriff beantragen.

Integration mit AEM integrating-with-aem

Installieren des Inhaltspakets für den Connector.

  1. Öffnen Sie ein Support-Ticket für Adoben, um das Connector-Feature Pack anzufordern.

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

  3. Tippen/klicken Sie auf der Seite mit der Paketbeschreibung auf Installieren.

  4. Tippen/klicken Sie im Dialogfeld Paket installieren auf Installieren.

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

  5. Tippen/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 die JCR-Kompatibilität Ihres SharePoint-Repositorys sicherzustellen. Sie können zusätzliche Parameter festlegen, um die Verbindung zum SharePoint-Server zu konfigurieren. Konfigurieren Sie außerdem die Authentifizierung mit dem SharePoint-Connector.

Verbindung mit dem SharePoint-Server konfigurieren 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 die SharePoint-Server-URL als Wert von Arbeitsbereiche.
  5. Tippen oder klicken Sie auf Speichern.

chlimage_1-81

Parameter "Workspaces"und "Default Workspace Name":

Standardmäßig stellt der Connector einen einzelnen JCR-Arbeitsbereich bereit. Der von diesem Arbeitsbereich angezeigte SharePoint-Server wird über den Konfigurationsparameter "SharePoint Server URL"festgelegt.

Der Connector kann auch für mehrere Workspaces konfiguriert werden. In diesem Fall ist jeder Arbeitsbereich mit der URL des entsprechenden SharePoint-Servers verknüpft, der über den Arbeitsbereich verfügbar gemacht wird. Um einen Arbeitsbereich hinzuzufügen, fügen Sie dem Parameter Arbeitsbereiche eine Arbeitsbereichsdefinition hinzu. Eine Workspace-Definition weist folgendes Format auf:
<name>= <url> Hierbei gilt
<name> ist 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.

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. Hinzufügen von com.day.cq.dam.cq-dam-jcr-connectors"in Whitelist Bundles Standard

  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 der Sharepoint-Einrichtung verifying-the-sharepoint-setup

Nachdem Sie den Connector konfiguriert haben, überprüfen Sie Folgendes:

  • Der SharePoint-Server wird ausgeführt und die Webdienste sind für die Connector-Instanz zugänglich.
  • SharePoint-Benutzeranmeldeinformationen sind gültig und der Benutzer verfügt über die erforderlichen SharePoint-Berechtigungen
  • Der Connector ist ordnungsgemäß installiert und konfiguriert

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

Um die SharePoint Assets mit AEM zu synchronisieren, führen Sie die folgenden Schritte aus:

  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 entsprechende Kennwort des Benutzers fest, der Zugriff auf die SharePoint-Site hat.
  5. Klicken Sie auf „Speichern“.

Aktivieren Sie den standardmäßig deaktivierten DAM-Synchronisierungsdienst:

  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 können Sie 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 fest (in Sekunden).
  5. Klicken Sie auf „Speichern“.

Authentifizierung konfigurieren configuring-authentication

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

  • Einfach
  • Formularbasiert

Insbesondere sind folgende Authentifizierungstypen verfügbar:

  • Classic-Basic
  • Classic-Forms-basiert
  • Schadensanalyse
  • Schadensmeldungen - Forms-basiert

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:

  • Einfache/NTLM-Authentifizierung: Der Connector versucht zunächst, eine Verbindung mithilfe der einfachen Authentifizierung herzustellen. Wenn nicht verfügbar, wird zur NTLM-basierten Authentifizierung gewechselt.
  • Formularbasierte Authentifizierung: SharePoint validiert Benutzende auf der Grundlage von Anmeldeinformationen, die sie in ein Anmeldeformular (üblicherweise eine Webseite) eingeben. Das System gibt ein Token für authentifizierte Anfragen aus, das einen Schlüssel zum erneuten Einrichten der Identität für nachfolgende Anfragen enthält.

Konfigurieren der Forms-basierten 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 von „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 für 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 für die Authentifizierung verwenden, um ein benutzerdefiniertes Authentifizierungsmodul zu erstellen, das beispielsweise den Zugriff AEM Benutzer bestimmten SharePoint-Benutzern zuordnet. Erstellen Sie AEM Benutzer, die SharePoint-Benutzern entsprechen (Benutzername und Kennwort sollten übereinstimmen), um SharePoint-Inhalte sehen zu können, die 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 ein (Benutzername, der Zugriff auf SharePoint hat).
  7. Geben Sie das entsprechende Passwort an
  8. Klicken Sie auf das grüne Häkchen, um die Benutzerin oder den Benutzer zu erstellen

Hinzufügen des Benutzers zur Administratorgruppe:

  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 von Package Share aus.

  2. Schnellstart schließen

  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
5ce3024a-cbea-458b-8b2f-f9b8dda516e8