DocumentazioneAEM 6.5Guida utente

Connettore SharePoint sharepoint-connector

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Si applica a:
  • Experience Manager 6.5
  • Argomenti:

Creato per:

  • Amministratore

Questo articolo include informazioni dettagliate sul connettore JCR di Adobe 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.
  • Riconoscimento delle impostazioni di protezione di 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
Il connettore SharePoint è supportato anche con AEM 6.1 service pack 2. Il connettore non supporta più il montaggio dell’archivio virtuale e, pertanto, non può essere montato. Se desideri accedere all’archivio di Sharepoint utilizzando le API Java, utilizza l’implementazione dell’archivio JCR del connettore Sharepoint nel progetto.
L'installazione, la configurazione, la gestione e le operazioni IT del server SharePoint e della relativa infrastruttura IT non rientrano nell'ambito del presente documento. Per informazioni su questi argomenti, consulta la documentazione del fornitore su SharePoint. Il connettore richiede che queste parti dell'infrastruttura siano installate, configurate e gestite correttamente.

Guida introduttiva getting-started

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

  • Verifica che sia installato almeno Java 7.

  • Scarica il file di distribuzione del pacchetto del connettore da Software Distribution.

  • Copiare un file license.properties valido nella directory contenente il file cq-quickstart-6.4.0.jar.

  • Fai doppio clic sul file .jar per avviare AEM o avvialo 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. Installare il pacchetto utilizzando Gestione pacchetti, quindi impostare 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 tramite la rete
  • URL del server SharePoint
  • Credenziali utente e autorizzazioni per gli archivi di CRX e SharePoint
  • Piattaforme supportate

Il connettore SharePoint è disponibile per il download da Distribuzione software.

Piattaforme supportate supported-platforms

Il connettore supporta quanto segue:

  • Versioni AEM:

    • AEM 6.4, 6.3

  • Versioni di 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 regione.

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

Installazione standard standard-installation

La Distribuzione di software viene utilizzata per distribuire funzionalità, esempi e hotfix dei prodotti. Per informazioni dettagliate, vedere la documentazione sulla distribuzione software.

Integrazione con l’AEM integrating-with-aem

Per installare il pacchetto di contenuti del connettore.

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

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

  3. Fare clic su Installa nella pagina di descrizione del pacchetto.

  4. Nella finestra di dialogo Installa pacchetto, fare clic su Installa.

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

  5. Dopo aver installato il pacchetto, fare clic su Chiudi.

Configurazione del connettore SharePoint configuring-sharepoint-connector

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

Imposta l’URL del server SharePoint per rendere il tuo 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, effettuare le seguenti operazioni:

  1. Passare alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.
  2. Cerca il connettore JCR Day per il bundle Microsoft Sharepoint.
  3. Modifica i valori di configurazione.
  4. Imposta l'URL del server SharePoint come valore di Aree di lavoro.
  5. Fai clic su Salva.

chlimage_1-62

Parametri 'Workspaces' e 'Default Workspace Name':

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 del 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 relativo server SharePoint esposto tramite l'area di lavoro. Per aggiungere un'area di lavoro, aggiungete una definizione di area di lavoro al parametro Workspace. Una definizione di area di lavoro ha il seguente formato:
<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, esegui un ulteriore passaggio oltre ai passaggi di configurazione precedenti. Elenco consentiti del bundle 'com.day.cq.dam.cq-dam-jcr-connectors'.

Per elenco consentiti di bundle nell’AEM, effettua le seguenti operazioni:

  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 nei bundle della whitelist per impostazione predefinita
  5. Fai clic su Salva.

chlimage_1-82

NOTE
Se configurate più aree di lavoro, specificate il nome dell'area di lavoro predefinita nel parametro Nome Workspace predefinito.

Per ulteriori informazioni sui parametri relativi all'autenticazione, vedere Autenticazione.

Verifica dell'impostazione 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 è installato e configurato correttamente

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

Per sincronizzare l'Assets di SharePoint con l'AEM, effettuare le seguenti operazioni:

  1. Passare alla console di gestione OSGi: http://localhost:4502/system/console/configMgr.
  2. Cercare 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, che è disabilitato 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. Fai clic su Abilita.

In alternativa, è possibile 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 Classic e Basata 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
  • Classic-basato su Forms
  • Claims-Basic
  • Basato su Forms per attestazioni

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 prima di connettersi utilizzando l'autenticazione di base. Se non disponibile, viene utilizzata l'autenticazione basata su NTLM.
  • Autenticazione basata su Forms: gli utenti vengono convalidati in base alle credenziali digitate dagli utenti in un modulo di accesso, in genere una pagina Web. Il sistema emette un token per le richieste autenticate che contiene una chiave per ristabilire 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 "Day JCR Connector for Microsoft Sharepoint" (Connettore JCR diurno per 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. Disabilita autenticazione token.
  2. Vai a http://localhost:4502/system/console/bundles.
  3. Fai clic su OSGI > Configurazione.
  4. Cerca il connettore JCR per Day per Microsoft Sharepoint.
  5. Fai clic su Edit the configuration values.
  6. Impostare il valore di Connection Factory di Sharepoint 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 utenti SharePoint specifici. Crea utenti AEM corrispondenti agli utenti SharePoint (nome utente e password devono corrispondere) per poter visualizzare 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. Fare clic su Crea utente.
  6. Specifica l’ID utente (nome utente con accesso a 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. Passare ad Amministrazione gruppo.
  2. Fai clic sul nodo "a".
  3. Fare clic su 'amministratori'.
  4. Digitare l'ID utente creato nella casella di testo prima del pulsante Sfoglia.
  5. Fai clic sul simbolo di spunta verde per aggiungere l’utente al gruppo di amministrazione.

Disabilita autenticazione token disable-token-authentication

  1. Scaricare e installare il pacchetto basic auth. zip da Software Distribution.

  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 indicato nel passaggio 4.

  6. Salvare e chiudere il file xml.

  7. Riavviare QuickStart e accedere con le credenziali.

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

Nella versione standard, il connettore supporta l'autenticazione standard IIS Windows (Basic) e l'autenticazione basata su Forms (basata su token). altri metodi di autenticazione possono essere supportati tramite il meccanismo di estensibilità.

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

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

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

    Quando si utilizza Maven, adattare la seguente configurazione di 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. Registra l'implementazione SharepointConnectionFactory nella configurazione del connettore. Nella finestra di configurazione del connettore, fai clic su Opzioni avanzate. Nel campo per Connection Factory di Sharepoint, specificare il nome dell'implementazione com.day.crx.spi.sharepoint.auth.CustomConnectionFactory.

  4. Riavviare il connettore.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2