Connettore SharePoint sharepoint-connector
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.
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.
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.
-
Apri un ticket di supporto Adobe per richiedere il pacchetto di funzionalità del connettore.
-
Scarica il pacchetto quando è disponibile e quindi apri Gestione pacchetti per la tua istanza AEM.
-
Tocca o fai clic su Installa dalla pagina di descrizione del pacchetto.
-
Da Installa pacchetto finestra di dialogo, tocca/fai clic Installa.
Nota: Assicurati di aver effettuato l'accesso come amministratore.
-
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:
- Passa alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.
- Cerca il Connettore Day JCR per Microsoft Sharepoint pacchetto.
- Modifica i valori di configurazione.
- Imposta l’URL del server SharePoint come valore di Aree di lavoro.
- Tocca o fai clic su Salva.
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:
-
Passa alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.
-
Cerca il servizio "Apache Sling Login Admin Whitelist".
-
Seleziona Ignora la whitelist .
-
Aggiungi 'com.day.cq.dam.cq-dam-jcr-connectors' in bundle whitelist predefiniti
-
Fai clic su Salva.
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:
- Passa alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.
- Cerca il servizio "Default DAMAssetSynchronization".
- Modifica i valori di configurazione.
- Impostare il nome utente e la password corrispondente dell'utente che ha accesso al sito SharePoint.
- Fai clic su Salva.
Abilita il servizio di sincronizzazione DAM, disattivato per impostazione predefinita:
- Passa ai componenti della console Web OSGi: http://localhost:4502/system/console/components
- Cerca "com.day.cq.dam.jcrConnectors.impl.AssetSynchronizationService".
- Fare clic su Abilita.
Facoltativamente, puoi configurare il ritardo di sincronizzazione tra diversi cicli di sincronizzazione:
- Passa alla console di gestione OSGi: http://localhost:4502/system/console/configMgr
- Cerca "DAY CQ DAM JCR Connector Asset Synchronization Service".
- Modifica i valori di configurazione.
- Imposta il valore del periodo di sincronizzazione (in secondi).
- 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
- Fai clic su OSGI -> Configurazione
- Cerca "Connettore JCR Day per Microsoft Sharepoint"
- Fai clic su "Modifica i valori di configurazione"
- Imposta il valore di "Sharepoint Connection Factory" come "com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory"
- Fai clic su Salva
Configurazione dell'autenticazione di base (Windows)
- Disattiva autenticazione token.
- Vai a http://localhost:4502/system/console/bundles.
- Fai clic su OSGI > Configurazione.
- Cerca Connettore Day JCR per Microsoft Sharepoint.
- Clic
Edit the configuration values
. - Imposta il valore di Sharepoint Connection Factory su
com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory
. - 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:
- Accedi a http://localhost:9502/with l'utente amministratore.
- Fare clic su Strumenti.
- Fare clic su Protezione.
- Fai clic su Utenti.
- Fai clic su Crea utente
- Fornisci l'ID utente (il nome utente con accesso su SharePoint)
- Immetti la password corrispondente
- Fai clic sul simbolo di spunta verde per creare l’utente
Per aggiungere l'utente nel gruppo di amministrazione:
- Vai a Amministrazione gruppo
- Fai clic sul nodo "a"
- Fai clic su "amministratori"
- Digita l’ID utente creato sopra nella casella di testo prima di Sfoglia pulsante
- Fai clic sul simbolo di spunta verde per aggiungere l’utente al gruppo di amministrazione
Disattiva autenticazione token disable-token-authentication
-
Scarica e installa il pacchetto
basic auth
.zip
da Condivisione pacchetti. -
Chiudi Quickstart.
-
Apri il file . \crx-quickstart\repository\repository.xml.
-
Trova il tag
<LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.
-
Inserire il tag
<param name="disableTokenAuth" value="true"/>
all’interno del tag menzionato al punto 4. -
Salva e chiudi il file xml.
-
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:
-
Implementare
com.day.crx.spi.sharepoint.security.SharepointConnectionFactory
per gestire il lato client del processo di autenticazione specifico. -
Installa il
SharepointConnectionFactory
implementazione come bundle di frammenti con host frammentocom.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>
-
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’implementazionecom.day.crx.spi.sharepoint.auth.CustomConnectionFactory
. -
Riavvia il connettore.