DocumentatieAEM 6.4Gids voor beheerders

SharePoint Connector sharepoint-connector

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Admin
CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

Day JCR Connector voor Microsoft SharePoint 2010 en Microsoft SharePoint 2013, versie 4.0.

Dit artikel bevat details over de Adobe JCR Connector voor Microsoft SharePoint 2010 en Microsoft SharePoint 2013, versie 4.0.

De SharePoint-connector ondersteunt de volgende basisfuncties:

  • Inhoud en metagegevens lezen uit SharePoint.
  • SharePoint-beveiligingsinstellingen bevestigen voor benaderde inhoud door native SharePoint-verificatie en -autorisatie toe te passen
  • Inhoudsintegratie met Inhoudszoeker
  • Met AEM componenten, zoals External Resource, SharePoint-afbeeldingen en video's weergeven
  • SharePoint synchroniseren met AEM Assets

Alle functies worden geïmplementeerd met de native SharePoint-webservices als de interface naar SharePoint-inhoud en -services.

NOTE
SharePoint Connector wordt ook ondersteund met AEM 6.1 service pack 2. De connector ondersteunt geen virtuele opslagplaats meer en kan daarom niet worden gemonteerd. Als u toegang wilt krijgen tot de SharePoint-opslagplaats met Java API's, gebruikt u de JCR-opslagfunctie van de SharePoint-connector in uw project.
Installatie-, configuratie-, beheer- en IT-bewerkingen van de SharePoint-server en de bijbehorende IT-infrastructuur vallen buiten het bereik van dit document. Zie documentatie van leveranciers op SharePoint voor informatie over deze onderwerpen. De aansluiting vereist dat deze delen van de infrastructuur correct worden geïnstalleerd, geconfigureerd en gebruikt.

Aan de slag getting-started

Ga als volgt te werk om aan de slag te gaan met de connector:

  • Zorg ervoor dat u ten minste Java 7 hebt geïnstalleerd.

  • Download het verdelingsdossier van het schakelaarpakket van het Aandeel van het Pakket.

  • Een geldige kopie maken license.properties bestand naar de map die het cq-quickstart-6.4.0.jar bestand.

  • Dubbelklik op of tik op het .jar-bestand om het te AEM of start het bestand via de opdrachtregel.

  • Installeer het aansluitingspakket via Package Manager.

  • Configureer de verbindingsopties.

SharePoint-connector installeren installing-sharepoint-connector

De connector is een inhoudspakket dat eenvoudige installatie mogelijk maakt. Installeer het pakket met Package Manager en stel vervolgens de URL van de SharePoint-server in
en andere configuratieopties. De SharePoint-inhoud is beschikbaar in de AEM repository.

Installatievereisten installation-requirements

De schakelaar vereist het volgende:

  • Java Runtime Environment 1.7 of hoger
  • SharePoint Web Services beschikbaar via het netwerk
  • URL SharePoint-server
  • Gebruikersreferenties en machtigingen voor CRX- en SharePoint-opslagruimten
  • Ondersteunde platforms

De SharePoint-aansluiting kan worden gedownload van pakketshare.

Ondersteunde Platforms supported-platforms

De schakelaar steunt het volgende:

  • AEM versies:

    • AEM 6.4, 6.3

  • Microsoft SharePoint-versies:

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

  • Als u steun voor douaneplaatsingen van de schakelaar (OEM, speciale vereisten, aangepaste authentificatiemethodes) vereist, contacteer het bureau van de Adobe voor uw regio.

NOTE
De connector ondersteunt alleen configuraties die officieel door Microsoft worden ondersteund. Zie MOSS 2010 en MOSS 2013 systeemvereisten.

Standaardinstallatie standard-installation

AEM Pakket delen wordt gebruikt om producteigenschappen, voorbeelden, en hete moeilijke situaties te verspreiden. Zie voor meer informatie de Documentatie voor delen pakket.

Tik/klik op Pakket delen op de welkomstpagina van de AEM Gereedschappen en selecteer vervolgens Pakket delen. U hebt een geldige Adobe ID nodig die uw bedrijfs-e-mailadres bevat. Nadat u zich hebt aangemeld bij uw account, kunt u bovendien een aanvraag indienen voor toegang tot het delen van pakketten.

Integreren met AEM integrating-with-aem

Om het pakket van de schakelaarinhoud te installeren.

  1. Open een Adobe Support-ticket om een aanvraag in te dienen voor het connectorfunctiepakket.

  2. Download het pakket wanneer het beschikbaar is en open dan de Manager van het Pakket voor uw AEM instantie.

  3. Tikken/klikken Installeren op de pagina met pakketbeschrijving.

  4. Van de Pakket installeren dialoogvenster, tikken/klikken Installeren.

    Opmerking: Controleer of u bent aangemeld als beheerder.

  5. Tik/klik op het moment dat het pakket is geïnstalleerd Sluiten.

SharePoint-connector configureren configuring-sharepoint-connector

Nadat u de SharePoint-connector hebt geïnstalleerd, configureert u de toepassing en de SharePoint-lagen voor de connector.

Stel de URL van de SharePoint-server in om de JCR-compatibiliteit van uw SharePoint-opslagruimte te garanderen. U kunt extra parameters instellen om de verbinding met de SharePoint-server te configureren. Configureer bovendien verificatie met de SharePoint-connector.

De verbinding met de SharePoint-server configureren configuring-the-connection-with-the-sharepoint-server

Voer de volgende stappen uit om de URL van de SharePoint-server en de geavanceerde opties in te stellen:

  1. Navigeer naar de OSGi Management Console: http://localhost:4502/system/console/configMgr.
  2. Zoeken naar Day JCR Connector voor Microsoft Sharepoint bundel.
  3. Bewerk de configuratiewaarden.
  4. Stel de URL van de SharePoint-server in als de waarde van Werkruimten.
  5. Tikken/klikken Opslaan.

chlimage_1-81

Parameters 'Werkruimten' en 'Standaardnaam werkruimte':

Standaard stelt de connector één JCR-werkruimte beschikbaar. De SharePoint-server die door deze werkruimte beschikbaar wordt gemaakt, wordt ingesteld via de configuratieparameter 'SharePoint Server URL'.

De schakelaar kan ook voor veelvoudige werkruimten worden gevormd. In dit geval wordt elke werkruimte gekoppeld aan de URL van de respectievelijke SharePoint-server die via de werkruimte beschikbaar wordt gemaakt. Als u een werkruimte wilt toevoegen, voegt u een werkruimtedefinitie toe aan de parameter Werkruimten. Een werkruimtedefinitie heeft de volgende indeling:
<name>= <url> waar
<name> is de naam van de JCR-werkruimte en
<url> is de URL van de SharePoint-server voor die werkruimte.

Voer in AEM nog een stap uit, apart van de bovenstaande configuratiestappen. Lijst van gewenste personen 'com.day.cq.dam.cq-dam-jcr-connectors bundel.

Voer de volgende stappen uit om bundels in AEM te lijsten van gewenste personen:

  1. Navigeer naar de OSGi Management Console: http://localhost:4502/system/console/configMgr.

  2. Zoek naar de service "Apache Sling Login Admin Whitelist".

  3. Selecteer Witte lijst omzeilen.

  4. Toevoegen 'com.day.cq.dam.cq-dam-jcr-connectors' in whitelist-bundels standaard

  5. Klik op Opslaan.

chlimage_1-82

NOTE
Als u meerdere werkruimten configureert, geeft u de naam van de standaardwerkruimte op in de parameter Standaardnaam werkruimte.

Zie voor meer informatie over parameters die betrekking hebben op verificatie Verificatie.

De installatie van SharePoint controleren verifying-the-sharepoint-setup

Nadat u de schakelaar vormt, verifieer het volgende:

  • SharePoint-server wordt uitgevoerd en de webservices zijn toegankelijk voor de verbindingsinstantie
  • SharePoint-gebruikersgegevens zijn geldig en de gebruiker beschikt over de vereiste SharePoint-machtigingen
  • De schakelaar is geïnstalleerd en behoorlijk gevormd

DAM-synchronisatie configureren met de SharePoint-server configuring-dam-sync-with-the-sharepoint-server

Voer de volgende stappen uit om de SharePoint-middelen te synchroniseren met AEM:

  1. Navigeer naar de OSGi Management Console: http://localhost:4502/system/console/configMgr.
  2. Zoek naar de service "Default DAMAssetSynchronization".
  3. Bewerk de configuratiewaarden.
  4. Stel de gebruikersnaam en het bijbehorende wachtwoord in van de gebruiker die toegang heeft tot de SharePoint-site.
  5. Klik op Opslaan.

Schakel de DAM Sync Service in, die standaard is uitgeschakeld:

  1. Navigeer naar de componenten van de Console van OSGi Web: http://localhost:4502/system/console/components
  2. Zoek naar "com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService."
  3. Klik op Inschakelen.

Naar keuze, kunt u de vertraging van de Synchronisatie tussen verschillende synchronisatiecycli vormen:

  1. Navigeer naar de OSGi Management Console: http://localhost:4502/system/console/configMgr
  2. Zoek naar "DAY CQ DAM JCR Connector Asset Synchronization Service."
  3. Bewerk de configuratiewaarden.
  4. Stel de waarde van de synchronisatieperiode in (in seconden).
  5. Klik op Opslaan.

Verificatie configureren configuring-authentication

SharePoint omvat de Klassieke en op eisen gebaseerde authentificatiemethodes, die allebei de volgende authentificatietypen steunen:

  • Basis
  • Op Forms gebaseerd

Met name zijn de volgende verificatietypen beschikbaar:

  • Klassiek-basis
  • Op basis van Classic-Forms
  • Vorderingen — Basis
  • Op Forms gebaseerde claims

De AEM JCR Connector voor Microsoft SharePoint 2010 en Microsoft SharePoint 2013, versie 4.0. biedt ondersteuning voor verificatie op basis van claims (wat door Microsoft wordt voorgesteld), die in de volgende modi werkt:

  • Basic-/NTLM-verificatie: De schakelaar probeert eerst om het gebruiken van basisauthentificatie te verbinden. Als deze optie niet beschikbaar is, wordt overgeschakeld naar verificatie op basis van NTLM.
  • Op Forms gebaseerde verificatie: SharePoint valideert gebruikers op geloofsbrieven die de gebruikers in een login vorm (typisch een Web-pagina) typen. Het systeem geeft een teken voor voor authentiek verklaarde verzoeken uit die een sleutel voor het opnieuw vestigen van de identiteit voor verdere verzoeken bevat.

Op Forms gebaseerde verificatie configureren

Ga naar: http://localhost:4502/system/console/bundles

  1. Klik op OSGI -> Configuration
  2. Zoeken naar "Day JCR Connector for Microsoft Sharepoint"
  3. Klik op "De configuratiewaarden bewerken"
  4. Stel de waarde van "Sharepoint Connection Factory" in op "com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory"
  5. Klikken Opslaan

Basisverificatie configureren (Windows)

  1. Tokenverificatie uitschakelen.
  2. Ga naar http://localhost:4502/system/console/bundles.
  3. Klik op OSGI > Configuratie.
  4. Zoeken naar Day JCR Connector voor Microsoft Sharepoint.
  5. Klik op Edit the configuration values.
  6. Stel de waarde van SharePoint Connection Factory in op com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory.
  7. Klikken Opslaan.

Alleen gebruikers die zijn geverifieerd op zowel AEM als SharePoint hebben via de connector toegang tot de SharePoint-inhoud.

U kunt de schakelaaruitbreiding voor authentificatie ook gebruiken om een module van de douaneauthentificatie tot stand te brengen, die, bijvoorbeeld, toegang door AEM gebruikers aan specifieke gebruikers van SharePoint in kaart brengt. Maak AEM gebruikers die overeenkomen met SharePoint-gebruikers (gebruikersnaam en wachtwoord moeten overeenkomen) om SharePoint-inhoud te kunnen zien die is toegewezen aan de connector.

Een gebruiker maken in AEM:

  1. Meld u aan bij http://localhost:9502/with.
  2. Klik op Gereedschappen.
  3. Klik op Beveiliging.
  4. Klik op Gebruikers.
  5. Klikken Gebruiker maken
  6. Geef de gebruikersnaam op (gebruikersnaam heeft toegang op SharePoint)
  7. Geef het bijbehorende wachtwoord op
  8. Klik op het groene verdeelstreepje om de gebruiker te maken

De gebruiker toevoegen in de beheergroep:

  1. Ga naar Groepsbeheer
  2. Klik op het knooppunt "a"
  3. Klik op "beheerders"
  4. Typ de gebruikers-id die u hierboven hebt gemaakt in het tekstvak ervoor Bladeren knop
  5. Klik op het groene verdeelstreepje om de gebruiker aan de beheergroep toe te voegen

Tokenverificatie uitschakelen disable-token-authentication

  1. Het pakket downloaden en installeren basic auth. zip vanuit Package Share.

  2. Sluit QuickStart.

  3. Het bestand openen \crx-quickstart\repository\repository.xml.

  4. De tag zoeken <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.

  5. De tag invoegen <param name="disableTokenAuth" value="true"/> binnen het in stap 4 vermelde label.

  6. Sla het XML-bestand op en sluit het.

  7. Start QuickStart opnieuw en meld u aan met uw referenties.

Verschillende verificatiemethoden van de SharePoint-server worden ondersteund supporting-different-authentication-methods-of-the-sharepoint-server

In zijn standaardversie, steunt de schakelaar standaard IIS Windows verificatie (Basic) en op Forms gebaseerde verificatie (op basis van token). De andere verificatiemethoden kan worden ondersteund via het uitbreidbaarheidsmechanisme.

De volgende stappen bevatten richtlijnen voor het uitbreiden van de standaardverificatie ter ondersteuning van verschillende verificatiemethoden van de SharePoint-server:

  1. Implementeren com.day.crx.spi.sharepoint.security.SharepointConnectionFactory om de clientzijde van uw specifieke verificatieproces af te handelen.

  2. Installeer de SharepointConnectionFactory implementatie als een fragmentbundel met fragmenthost com.day.crx.spi.crx2sharepoint-bundle.

    Wanneer het gebruiken van Maven, pas de volgende configuratie van aan maven-bundle-plugin aan de vereisten van uw project:

    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. Registreer de SharepointConnectionFactory implementatie in de schakelaarconfiguratie. Klik in het configuratievenster van de connector op Geavanceerde opties. In de lus for SharePoint Connection Factory -veld, geeft u de naam van de implementatie op com.day.crx.spi.sharepoint.auth.CustomConnectionFactory.

  4. Start de connector opnieuw.

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8