DocumentazioneAEM 6.4Guida all’amministrazione

Connettore SharePoint sharepoint-connector

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

Creato per:

  • Admin
CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

Connettore Day JCR per Microsoft SharePoint 2010 e Microsoft SharePoint 2013, versione 4.0.

Questo articolo include informazioni dettagliate sul connettore Adobe JCR per Microsoft SharePoint 2010 e Microsoft SharePoint 2013, versione 4.0.

Il connettore SharePoint supporta le seguenti funzionalità di base:

  • Lettura di contenuti e metadati da SharePoint.
  • Riconoscere le impostazioni di sicurezza SharePoint per il contenuto a cui si accede applicando l’autenticazione e l’autorizzazione native di SharePoint
  • Integrazione dei contenuti tramite Content Finder
  • Utilizzo di componenti AEM, ad esempio Risorse esterne per visualizzare immagini e video SharePoint
  • Sincronizzazione di SharePoint con AEM Assets

Tutte le funzionalità vengono implementate utilizzando i servizi web nativi di SharePoint come interfaccia per i contenuti e i servizi SharePoint.

NOTE
SharePoint Connector è supportato anche con AEM service pack 2 6.1. Il connettore non supporta più il montaggio dell'archivio virtuale e, pertanto, non può essere montato. Se desideri accedere all’archivio Sharepoint utilizzando le API Java, utilizza l’implementazione dell’archivio JCR del connettore Sharepoint nel tuo progetto.
L'installazione, la configurazione, la gestione e le operazioni IT del server SharePoint e della relativa infrastruttura IT non rientrano nell'ambito di applicazione di questo documento. Consulta la documentazione del fornitore su SharePoint per informazioni su questi argomenti. Il connettore richiede che queste parti dell'infrastruttura siano installate, configurate e gestite correttamente.

Guida introduttiva getting-started

Per iniziare a utilizzare il connettore, procedi come segue:

  • Assicurati di avere installato almeno Java 7.

  • Scarica il file di distribuzione del pacchetto del connettore da Package Share.

  • Copia un valore valido license.properties alla directory che contiene il cq-quickstart-6.4.0.jar file.

  • Tocca o fai doppio clic sul file .jar per avviare AEM o avviarlo dalla riga di comando.

  • Installa il pacchetto del connettore da Gestione pacchetti.

  • Configura le opzioni del connettore.

Installazione del connettore SharePoint installing-sharepoint-connector

Il connettore è un pacchetto di contenuti che facilita l'installazione. Installa il pacchetto utilizzando Gestione pacchetti, quindi imposta l'URL del server SharePoint
e altre opzioni di configurazione. Il contenuto SharePoint è disponibile nell’archivio AEM.

Requisiti di installazione installation-requirements

Il connettore richiede quanto segue:

  • Java Runtime Environment 1.7 o versione successiva
  • Servizi Web SharePoint disponibili in rete
  • URL del server SharePoint
  • Credenziali utente e autorizzazioni per gli archivi CRX e SharePoint
  • Piattaforme supportate

Il connettore SharePoint è disponibile per il download da packageshare.

Piattaforme supportate supported-platforms

Il connettore supporta le seguenti funzioni:

  • Versioni AEM:

    • AEM 6.4, 6.3

  • Versioni Microsoft SharePoint:

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

  • Se hai bisogno di supporto per le distribuzioni personalizzate del connettore (OEM, requisiti speciali, metodi di autenticazione personalizzati), contatta l'ufficio Adobe della tua area.

NOTE
Il connettore supporta solo le configurazioni supportate ufficialmente da Microsoft. Vedi MOSS 2010 e MOSS 2013 requisiti di sistema.

Installazione standard standard-installation

AEM Package Share viene utilizzato per distribuire funzionalità, esempi e hotfix di prodotto. Per ulteriori informazioni, consulta la sezione Documentazione su Condivisione pacchetti.

Per accedere a Condivisione pacchetti nella pagina di benvenuto AEM, tocca o fai clic su Strumenti quindi seleziona Condivisione pacchetti. È necessario un Adobe ID valido che includa l’indirizzo e-mail dell’azienda. Inoltre, dopo aver effettuato l'accesso al tuo account, richiedi l'accesso a Condivisione pacchetti.

Integrazione con AEM integrating-with-aem

Per installare il pacchetto di contenuti del connettore.

  1. Apri un ticket di supporto Adobe per richiedere il pacchetto di funzionalità del connettore.

  2. Scarica il pacchetto quando è disponibile e quindi apri Gestione pacchetti per la tua istanza AEM.

  3. Tocca o fai clic su Installa dalla pagina di descrizione del pacchetto.

  4. Da Installa pacchetto finestra di dialogo, tocca/fai clic Installa.

    Nota: Assicurati di aver effettuato l'accesso come amministratore.

  5. Quando il pacchetto è installato, tocca o fai clic su Chiudi.

Configurazione del connettore SharePoint configuring-sharepoint-connector

Dopo aver installato il connettore SharePoint, configura l’applicazione e i livelli SharePoint per il connettore.

Imposta l'URL del server SharePoint per rendere l'archivio SharePoint compatibile con JCR. Puoi impostare parametri aggiuntivi per configurare la connessione con il server SharePoint. Inoltre, configura l’autenticazione con il connettore SharePoint.

Configurazione della connessione con il server SharePoint configuring-the-connection-with-the-sharepoint-server

Per impostare l’URL del server SharePoint e le opzioni avanzate, effettua le seguenti operazioni:

  1. Passa alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.
  2. Cerca il Connettore Day JCR per Microsoft Sharepoint pacchetto.
  3. Modifica i valori di configurazione.
  4. Imposta l’URL del server SharePoint come valore di Aree di lavoro.
  5. Tocca o fai clic su Salva.

chlimage_1-81

Parametri "Workspace" e "Nome area di lavoro predefinito":

Per impostazione predefinita, il connettore espone una singola area di lavoro JCR. Il server SharePoint esposto da questa area di lavoro viene impostato tramite il parametro di configurazione "URL server di SharePoint".

Il connettore può essere configurato anche per più aree di lavoro. In questo caso, ogni area di lavoro è associata all’URL del rispettivo server SharePoint esposto tramite l’area di lavoro. Per aggiungere un’area di lavoro, aggiungi una definizione dell’area di lavoro al parametro Workspace. Una definizione di area di lavoro ha il formato seguente:
<name>= <url> Dove
<name> è il nome dell’area di lavoro JCR e
<url> è l'URL del server SharePoint per quell'area di lavoro.

In AEM, esegui un altro passaggio oltre ai passaggi di configurazione indicati sopra. Elenco consentiti di "com.day.cq.dam.cq-dam-jcr-connectors' bundle.

Per elenco consentiti dei bundle in AEM, esegui i seguenti passaggi:

  1. Passa alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.

  2. Cerca il servizio "Apache Sling Login Admin Whitelist".

  3. Seleziona Ignora la whitelist .

  4. Aggiungi 'com.day.cq.dam.cq-dam-jcr-connectors' in bundle whitelist predefiniti

  5. Fai clic su Salva.

chlimage_1-82

NOTE
Se si configurano più aree di lavoro, specificare il nome dell'area di lavoro predefinita nel parametro Nome area di lavoro predefinito.

Per ulteriori informazioni sui parametri correlati all’autenticazione, consulta Autenticazione.

Verifica della configurazione di Sharepoint verifying-the-sharepoint-setup

Dopo aver configurato il connettore, verifica quanto segue:

  • Il server SharePoint viene eseguito e i servizi Web sono accessibili all’istanza del connettore
  • Le credenziali utente di SharePoint sono valide e l'utente dispone delle autorizzazioni SharePoint necessarie
  • Il connettore viene installato e configurato correttamente

Configurazione della sincronizzazione DAM con il server SharePoint configuring-dam-sync-with-the-sharepoint-server

Per sincronizzare le risorse SharePoint con AEM, esegui le seguenti operazioni:

  1. Passa alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.
  2. Cerca il servizio "Default DAMAssetSynchronization".
  3. Modifica i valori di configurazione.
  4. Impostare il nome utente e la password corrispondente dell'utente che ha accesso al sito SharePoint.
  5. Fai clic su Salva.

Abilita il servizio di sincronizzazione DAM, disattivato per impostazione predefinita:

  1. Passa ai componenti della console Web OSGi: http://localhost:4502/system/console/components
  2. Cerca "com.day.cq.dam.jcrConnectors.impl.AssetSynchronizationService".
  3. Fare clic su Abilita.

Facoltativamente, puoi configurare il ritardo di sincronizzazione tra diversi cicli di sincronizzazione:

  1. Passa alla console di gestione OSGi: http://localhost:4502/system/console/configMgr
  2. Cerca "DAY CQ DAM JCR Connector Asset Synchronization Service".
  3. Modifica i valori di configurazione.
  4. Imposta il valore del periodo di sincronizzazione (in secondi).
  5. Fai clic su Salva.

Configurazione dell’autenticazione configuring-authentication

Sharepoint include i metodi di autenticazione basati su attestazioni e classici, che supportano entrambi i seguenti tipi di autenticazione:

  • Base
  • Basato su Forms

In particolare, sono disponibili i seguenti tipi di autenticazione:

  • Classic-Basic
  • Basato su Forms classico
  • Claims-Basic
  • Basato su Forms

Il connettore JCR AEM per Microsoft SharePoint 2010 e Microsoft SharePoint 2013, versione 4.0. supporta l’autenticazione basata sulle attestazioni (suggerita da Microsoft), che funziona nelle seguenti modalità:

  • Autenticazione di base/NTLM: Il connettore tenta innanzitutto di connettersi utilizzando l’autenticazione di base. Se non disponibile, passa all’autenticazione basata su NTLM.
  • Autenticazione basata su Forms: Sharepoint convalida gli utenti in base alle credenziali che gli utenti digitano in un modulo di accesso (in genere una pagina web). Il sistema invia un token per le richieste autenticate che contiene una chiave per ripristinare l’identità per le richieste successive.

Configurazione dell’autenticazione basata su Forms

Vai a: http://localhost:4502/system/console/bundles

  1. Fai clic su OSGI -> Configurazione
  2. Cerca "Connettore JCR Day per Microsoft Sharepoint"
  3. Fai clic su "Modifica i valori di configurazione"
  4. Imposta il valore di "Sharepoint Connection Factory" come "com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory"
  5. Fai clic su Salva

Configurazione dell'autenticazione di base (Windows)

  1. Disattiva autenticazione token.
  2. Vai a http://localhost:4502/system/console/bundles.
  3. Fai clic su OSGI > Configurazione.
  4. Cerca Connettore Day JCR per Microsoft Sharepoint.
  5. Clic Edit the configuration values.
  6. Imposta il valore di Sharepoint Connection Factory su com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory.
  7. Fai clic su Salva.

Solo un utente autenticato sia su AEM che su SharePoint può accedere al contenuto SharePoint tramite il connettore.

Puoi anche utilizzare l’estensione del connettore per l’autenticazione per creare un modulo di autenticazione personalizzato, che, ad esempio, mappa l’accesso degli utenti AEM a specifici utenti SharePoint. Crea utenti AEM corrispondenti agli utenti SharePoint (nome utente e password devono corrispondere) per poter vedere il contenuto SharePoint mappato all'istanza del connettore.

Per creare un utente in AEM:

  1. Accedi a http://localhost:9502/with l'utente amministratore.
  2. Fare clic su Strumenti.
  3. Fare clic su Protezione.
  4. Fai clic su Utenti.
  5. Fai clic su Crea utente
  6. Fornisci l'ID utente (il nome utente con accesso su SharePoint)
  7. Immetti la password corrispondente
  8. Fai clic sul simbolo di spunta verde per creare l’utente

Per aggiungere l'utente nel gruppo di amministrazione:

  1. Vai a Amministrazione gruppo
  2. Fai clic sul nodo "a"
  3. Fai clic su "amministratori"
  4. Digita l’ID utente creato sopra nella casella di testo prima di Sfoglia pulsante
  5. Fai clic sul simbolo di spunta verde per aggiungere l’utente al gruppo di amministrazione

Disattiva autenticazione token disable-token-authentication

  1. Scarica e installa il pacchetto basic auth. zip da Condivisione pacchetti.

  2. Chiudi Quickstart.

  3. Apri il file . \crx-quickstart\repository\repository.xml.

  4. Trova il tag <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.

  5. Inserire il tag <param name="disableTokenAuth" value="true"/> all’interno del tag menzionato al punto 4.

  6. Salva e chiudi il file xml.

  7. Riavvia QuickStart e accedi con le tue credenziali.

Supporto di diversi metodi di autenticazione del server SharePoint supporting-different-authentication-methods-of-the-sharepoint-server

Nella versione standard, il connettore supporta IIS standard Windows autenticazione (di base) e autenticazione basata su Forms (basata su token). La altri metodi di autenticazione può essere supportato tramite il meccanismo di estensibilità.

I passaggi seguenti forniscono linee guida sull’estensione dell’autenticazione standard per supportare vari metodi di autenticazione del server SharePoint:

  1. Implementare com.day.crx.spi.sharepoint.security.SharepointConnectionFactory per gestire il lato client del processo di autenticazione specifico.

  2. Installa il SharepointConnectionFactory implementazione come bundle di frammenti con host frammento com.day.crx.spi.crx2sharepoint-bundle.

    Quando utilizzi Maven, adatta la seguente configurazione del maven-bundle-plugin ai requisiti del progetto:

    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. Registrare SharepointConnectionFactory implementazione nella configurazione del connettore. Nella finestra di configurazione del connettore, fai clic su Opzioni avanzate. Nella sezione Sharepoint Connection Factory campo , specifica il nome dell’implementazione com.day.crx.spi.sharepoint.auth.CustomConnectionFactory.

  4. Riavvia il connettore.

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