Connettore SharePoint

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

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

Il connettore di SharePoint supporta le seguenti funzionalità di base:

• Lettura di contenuti e metadati da SharePoint.
• Riconoscimento delle impostazioni di protezione di SharePoint per il contenuto a cui si accede tramite l'applicazione dell'autenticazione e dell'autorizzazione nativa di SharePoint
• Integrazione dei contenuti tramite Content Finder
• Utilizzo di componenti AEM, come Risorse esterne per visualizzare immagini e video di SharePoint
• Sincronizzazione di SharePoint con AEM Assets

Tutte le funzionalità sono implementate utilizzando i servizi Web di SharePoint nativi come interfaccia per il contenuto e i servizi di SharePoint.

Guida introduttiva

Per iniziare a utilizzare il connettore, effettuare le seguenti operazioni:

• Accertatevi che sia installato almeno Java 7.

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

• Copiate un file license.properties valido nella directory che contiene il file cq-quickstart-6.4.0.jar.

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

• Installate il pacchetto del connettore da Package Manager.

• Configurare le opzioni del connettore.

Installazione del connettore SharePoint

Il connettore è un pacchetto di contenuti che semplifica l'installazione. Installate il pacchetto utilizzando Package Manager, quindi impostate l'URL del server di SharePoint
e altre opzioni di configurazione. Il contenuto di SharePoint è disponibile nell'archivio AEM.

Requisiti di installazione

Il connettore richiede quanto segue:

• Java Runtime Environment 1.7 o versione successiva
• SharePoint Web Services disponibile nella rete
• URL server SharePoint
• Credenziali utente e autorizzazioni per repository CRX e SharePoint
• Piattaforme supportate

Il connettore di SharePoint è disponibile per il download da packageshare.

Piattaforme supportate

Il connettore supporta le seguenti funzionalità:

• Versioni AEM:

  • AEM 6.4, 6.3

• Versioni di Microsoft SharePoint:

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

• Se è necessario il supporto per le installazioni personalizzate del connettore (OEM, requisiti speciali, metodi di autenticazione personalizzati), contattare l'ufficio del Adobe della propria area geografica.

Installazione standard

AEM Package Share viene utilizzato per distribuire funzionalità, esempi e correzioni di prodotti. Per informazioni dettagliate, consultate la documentazione di Package Share.

Per accedere a Condivisione pacchetti nella pagina di AEM benvenuto, toccate/fate clic su Strumenti, quindi selezionate Condivisione pacchetti. È necessario un Adobe ID valido che includa l'indirizzo e-mail della società. Inoltre, dopo aver effettuato l'accesso al vostro account, richiedete l'accesso a Package Share.

Integrazione con AEM

Per installare il pacchetto di contenuto del connettore.

1. Aprite un ticket di assistenza Adobe per richiedere la funzionalità del connettore.

2. Scaricate il pacchetto quando è disponibile e quindi aprite Package Manager per l'istanza AEM.

3. Toccate/fate clic su Installa nella pagina di descrizione del pacchetto.

4. Dalla finestra di dialogo Install Package, toccate/fate clic su Install.

   Nota: Accertatevi di aver effettuato l’accesso come amministratore.

5. Quando il pacchetto è installato, toccate o fate clic su Chiudi.

Configurazione del connettore SharePoint

Dopo aver installato il connettore SharePoint, configurate l'applicazione e i livelli SharePoint per il connettore.

Impostate l'URL del server di SharePoint per rendere l'archivio di SharePoint conforme a JCR. È possibile impostare parametri aggiuntivi per configurare la connessione con il server SharePoint. Inoltre, configurate l'autenticazione con il connettore SharePoint.

Configurazione della connessione con il server SharePoint

Per impostare l'URL del server SharePoint e le opzioni avanzate, procedere come segue:

1. Andate alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.
2. Cercate il pacchetto Day JCR Connector for Microsoft Sharepoint.
3. Modificate i valori di configurazione.
4. Impostate l'URL di SharePoint Server come valore di Workspaces.
5. Toccate/fate clic su Salva.

Parametri 'Workspaces' e 'Default Workspace Name':

Per impostazione predefinita, il connettore espone un'unica area di lavoro JCR. Il server SharePoint esposto da questa area di lavoro viene impostato tramite il parametro di configurazione 'URL server 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 attraverso l'area di lavoro. Per aggiungere un’area di lavoro, aggiungete una definizione dell’area di lavoro al parametro Workspaces. 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 tale area di lavoro.

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

Per pacchetti di elenco consentiti in AEM, effettuate le seguenti operazioni:

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

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

3. Selezionate Bypass the whitelist.

4. Aggiungi 'com.day.cq.dam.cq-dam-jcr-connector' nei bundle whitelist predefiniti

5. Fate clic su Salva.

Per ulteriori informazioni sui parametri correlati all'autenticazione, vedere Authentication.

Verifica della configurazione di Sharepoint

Dopo aver configurato il connettore, verificare quanto segue:

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

Configurazione della sincronizzazione DAM con il server SharePoint

Per sincronizzare le risorse di SharePoint con AEM, effettua le seguenti operazioni:

1. Andate alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.
2. Cercate il servizio "Default DAMAssetSynchronization".
3. Modificate i valori di configurazione.
4. Impostate il nome utente e la password corrispondente per l'utente che ha accesso al sito di SharePoint.
5. Fate clic su Salva.

Abilita il servizio di sincronizzazione DAM, che è disabilitato per impostazione predefinita:

1. Passate ai componenti della console Web OSGi: http://localhost:4502/system/console/components
2. Cercate "com.day.cq.dam.jcrconnector.impl.AssetSynchronizationService".
3. Fate clic su Abilita.

Facoltativamente, potete configurare il ritardo di sincronizzazione tra i diversi cicli di sincronizzazione:

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

Configurazione dell'autenticazione

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

• Base
• Basato su Forms

In particolare, sono disponibili i seguenti tipi di autenticazione:

• Classic-Basic
• Basato su Forms classico
• Claims-Basic
• Claims-based 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 login (in genere una pagina Web). Il sistema emette 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. Fare clic su OSGI -> Configurazione
2. Cerca "Connettore JCR Day per Microsoft SharePoint"
3. Fate clic su "Edit the configuration values" (Modifica i valori di configurazione)
4. Impostate 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. Andate a http://localhost:4502/system/console/bundles.
3. Fate clic su OSGI > Configurazione.
4. Cercare Connettore JCR giornaliero per Microsoft Sharepoint.
5. Clic Edit the configuration values.
6. Impostate 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.

È inoltre possibile 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 di SharePoint. Creare utenti AEM corrispondenti agli utenti di SharePoint (il nome utente e la password devono corrispondere) per poter visualizzare il contenuto di SharePoint mappato all'istanza del connettore.

Per creare un utente in AEM:

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

Per aggiungere l'utente nel gruppo di amministrazione:

1. Vai a Amministrazione gruppo
2. Fare clic sul nodo "a"
3. Fare clic su "Administrators"
4. Digitare l'ID utente creato sopra nella casella di testo prima del pulsante Sfoglia
5. Fate clic sul simbolo di spunta verde per aggiungere l’utente al gruppo di amministrazione

Disattiva autenticazione token

1. Scaricate e installate il pacchetto basic auth. zip da Package Share.

2. Chiudi Avvio rapido.

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

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

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

6. Salvate e chiudete il file xml.

7. Riavvia QuickStart ed effettua l’accesso con le tue credenziali.

Supporto di diversi metodi di autenticazione del server SharePoint

Nella versione standard, il connettore supporta l'autenticazione standard IIS Windows (Basic) e l'autenticazione basata su Forms (token). Gli altri metodi di autenticazione possono essere supportati 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. Implementate com.day.crx.spi.sharepoint.security.SharepointConnectionFactory per gestire il lato client del processo di autenticazione specifico.

2. Installare l'implementazione SharepointConnectionFactory come pacchetto di frammenti con l'host del frammento com.day.crx.spi.crx2sharepoint-bundle.

   Quando si utilizza Maven, adattare la seguente configurazione di maven-bundle-plugin ai requisiti del progetto:

              <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. Registra l'implementazione SharepointConnectionFactory nella configurazione del connettore. Nella finestra di configurazione del connettore, fare clic su Opzioni avanzate. Nel campo relativo a Sharepoint Connection Factory, specificare il nome dell'implementazione com.day.crx.spi.sharepoint.auth.CustomConnectionFactory.

4. Riavviare il connettore.

Risorse Business.Adobe.com

Multichannel Communication Auto Form Fill Customer Communications Theme Editor Document Generation Web Content Management