SharePoint-connector

De Schakelaar van JCR van de dag voor Microsoft SharePoint 2010 en Microsoft SharePoint 2013, versie 4.0.

Dit artikel omvat details rond de Schakelaar van JCR van Adobe voor Microsoft SharePoint 2010 en Microsoft SharePoint 2013, versie 4.0.

De SharePoint-connector ondersteunt de volgende basisfuncties:

  • Inhoud en metagegevens lezen vanuit SharePoint.
  • SharePoint-beveiligingsinstellingen voor benaderde inhoud bevestigen door native SharePoint-verificatie en -verificatie toe te passen
  • Inhoudsintegratie met Inhoudszoeker
  • Het gebruiken van AEM componenten, zoals Extern Middel om beelden en video's van SharePoint te tonen
  • SharePoint synchroniseren met AEM Assets

Alle functies worden uitgevoerd gebruikend de inheemse Webdiensten van SharePoint als interface aan de inhoud en de diensten van SharePoint.

OPMERKING

De Schakelaar van SharePoint wordt ook gesteund met AEM 6.1 de dienstpak 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.

De installatie, configuratie, beheer, en de verrichtingen van IT van de server van SharePoint en verwante infrastructuur van IT zijn buiten het werkingsgebied van dit document. Raadpleeg de documentatie van leveranciers over 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

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.

  • Kopieer een geldig license.properties dossier aan de folder die cq-quickstart-6.4.0.jar dossier bevat.

  • 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

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

Installatievereisten

De schakelaar vereist het volgende:

  • Java Runtime Environment 1.7 of hoger
  • De Diensten van het Web van SharePoint beschikbaar door het netwerk
  • URL SharePoint-server
  • Gebruikersreferenties en machtigingen voor CRX- en SharePoint-opslagruimten
  • Ondersteunde platforms

De SharePoint-connector is beschikbaar voor downloaden vanaf packageshare.

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

OPMERKING

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

Standaardinstallatie

AEM Pakket delen wordt gebruikt om producteigenschappen, voorbeelden, en hete moeilijke situaties te verspreiden. Raadpleeg de documentatie voor delen van pakketten voor meer informatie.

Tik/klik op Tools en selecteer Pakket delen om het gedeelde pakket op de AEM Welkomstpagina te openen. 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

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. Tik/klik op Installeren op de pagina met de pakketbeschrijving.

  4. Tik in het dialoogvenster Pakket installeren op Installeren.

    Opmerking: Controleer of u bent aangemeld als beheerder.

  5. Tik op Close wanneer het pakket is geïnstalleerd.

SharePoint-connector configureren

Nadat u de schakelaar van SharePoint installeert, vorm de toepassing en de lagen van SharePoint voor de schakelaar.

Stel de URL van de SharePoint-server in om de JCR-compatibiliteit van uw SharePoint-opslagruimte te behouden. U kunt extra parameters instellen om de verbinding met de SharePoint-server te configureren. Daarnaast configureert u verificatie met de SharePoint-connector.

De verbinding configureren met de 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. Zoek naar de Day JCR Connector voor Microsoft SharePoint bundel.
  3. Bewerk de configuratiewaarden.
  4. Stel de URL van de SharePoint-server in als de waarde van Workspaces.
  5. Tik/klik 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> waarbij
<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 de bundel 'com.day.cq.dam.cq-dam-jcr-connectors'.

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. Voeg 'com.day.cq.dam.cq-dam-jcr-connectors' toe in de standaard whitelist-bundels

  5. Klik op Opslaan.

chlimage_1-82

OPMERKING

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

Voor extra informatie rond authentificatie-verwante parameters, zie Authentificatie.

De installatie van SharePoint controleren

Nadat u de schakelaar vormt, verifieer het volgende:

  • De serverlooppas van SharePoint, en de Webdiensten zijn toegankelijk voor de schakelaarinstantie
  • De gebruikersgeloofsbrieven van SharePoint zijn geldig en de gebruiker heeft noodzakelijke toestemmingen van SharePoint
  • De schakelaar is geïnstalleerd en behoorlijk gevormd

DAM-synchronisatie configureren met de SharePoint-server

Voer de volgende stappen uit om de SharePoint-elementen 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

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. steunt op eisen-gebaseerde authentificatie (die door Microsoft wordt voorgesteld), die op de volgende wijzen 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. Klik 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. Klik Opslaan.

Slechts kan een gebruiker die op zowel AEM als SharePoint voor authentiek wordt verklaard tot de inhoud van SharePoint door de schakelaar toegang hebben.

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. Creeer AEM gebruikers die aan de gebruikers van SharePoint (gebruikersnaam en wachtwoord zouden moeten aanpassen) beantwoorden om de inhoud van SharePoint te kunnen zien die aan de schakelaarinstantie in kaart wordt gebracht.

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. Klik Gebruiker maken
  6. Geef de gebruikers-id op (gebruikersnaam die toegang heeft tot 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 hierboven gemaakte gebruikersnaam in het tekstvak vóór de knop Bladeren
  5. Klik op het groene verdeelstreepje om de gebruiker aan de beheergroep toe te voegen

Tokenverificatie uitschakelen

  1. Download en installeer het pakket basic auth. zip vanuit Package Share.

  2. Sluit QuickStart.

  3. Open het bestand \crx-quickstart\repository\repository.xml.

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

  5. Plaats de tag <param name="disableTokenAuth" value="true"/> in de tag die in stap 4 wordt vermeld.

  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

In zijn standaardversie, steunt de schakelaar de standaardIIS Windows authentificatie (Basis) en op Forms-Gebaseerde authentificatie (op teken gebaseerd). De andere verificatiemethoden kunnen worden ondersteund via het mechanisme voor uitbreidbaarheid.

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

  1. Implementeer 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 maven-bundle-plugin aan de vereisten van uw project aan:

               <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. Geef in het veld for Sharepoint Connection Factory de naam van de implementatie com.day.crx.spi.sharepoint.auth.CustomConnectionFactory op.

  4. Start de connector opnieuw.

Op deze pagina