Day JCR Connector for Microsoft SharePoint 2010 et Microsoft SharePoint 2013, version 4.0.
Cet article contient des informations détaillées sur l’Adobe JCR Connector for Microsoft SharePoint 2010 et Microsoft SharePoint 2013, version 4.0.
SharePoint Connector prend en charge les fonctionnalités de base suivantes :
Toutes les fonctionnalités sont mises en œuvre en utilisant les services web SharePoint natifs comme interface du contenu et des services SharePoint.
SharePoint Connector est également pris en charge avec AEM 6.1 Service Pack 2. Le connecteur ne prend plus en charge le montage du référentiel virtuel et ne peut donc pas être monté. Si vous souhaitez accéder au référentiel SharePoint à l’aide d’API Java, utilisez l’implémentation du référentiel JCR du connecteur SharePoint dans votre projet.
L’installation, la configuration, la gestion et les opérations informatiques du serveur SharePoint et de l’infrastructure informatique associée ne rentrent pas dans le cadre de ce document. Voir la documentation du fournisseur sur SharePoint pour plus d’informations sur ces rubriques. Le connecteur nécessite que ces parties de l’infrastructure soient correctement installées, configurées et utilisées.
Pour débuter avec le connecteur, effectuez les opérations suivantes :
Assurez-vous de disposer au moins de Java 7.
Téléchargez le fichier de distribution du module de connecteur depuis Package Share.
Copiez un fichier license.properties valide vers le répertoire contenant le fichier cq-quickstart-6.4.0.jar.
Double-cliquez/appuyez sur le fichier .jar pour démarrer AEM ou démarrez-le à partir de la ligne de commande.
Installez le module du connecteur depuis le gestionnaire de modules.
Configurez les options du connecteur.
Le connecteur est un module de contenu qui facilite la configuration. Installez le package à l’aide de Package Manager, puis définissez l’URL du serveur SharePoint.
et d’autres options de configuration. Le contenu SharePoint est disponible dans le référentiel AEM.
Le connecteur nécessite ce qui suit :
SharePoint Connector est disponible en téléchargement à partir de packageshare.
Le connecteur prend en charge les applications suivantes :
Versions d’AEM :
Versions de Microsoft SharePoint
Si vous avez besoin d’une assistance pour des déploiements personnalisés du connecteur (OEM, besoins particuliers, méthodes d’authentification personnalisées), contactez le bureau Adobe de votre région.
AEM Package Share est utilisé pour la distribution des fonctionnalités produit, des exemples et des correctifs logiciels. Pour plus d’informations, consultez la documentation relative au partage de package.
Pour accéder au partage de package sur la page d’accueil AEM, appuyez/cliquez sur Outils, puis sélectionnez Partage de package. Vous avez besoin d’une Adobe ID valide qui comprend votre adresse électronique de société. En outre, après vous être connecté à votre compte, demandez l’accès à Package Share.
Pour installer le module de contenu du connecteur.
Ouvrez un ticket d’assistance Adobe pour demander le Feature Pack de connecteur.
Téléchargez le module lorsqu’il est disponible et ouvrez ensuite le gestionnaire de modules pour votre instance AEM.
Appuyez/cliquez sur Installer dans la page de description du package.
Dans la boîte de dialogue Installer le package, appuyez/cliquez sur Installer.
Remarque : Assurez-vous d’être connecté en tant qu’administrateur.
Une fois le package installé, appuyez/cliquez sur Fermer.
Une fois que vous avez installé SharePoint Connector, configurez l’application et les couches SharePoint pour le connecteur.
Définissez l’URL du serveur SharePoint pour rendre votre référentiel SharePoint conforme à JCR. Vous pouvez définir des paramètres supplémentaires pour configurer la connexion au serveur SharePoint. En outre, configurez l’authentification à l’aide de SharePoint Connector.
Pour définir l’URL du serveur SharePoint et les options avancées, procédez comme suit :
Paramètres Espaces de travail et Nom d’espace de travail par défaut :
Par défaut, le connecteur expose un espace de travail JCR unique. Le serveur SharePoint exposé par cet espace de travail est défini via le paramètre de configuration URL du serveur SharePoint.
Le connecteur peut également être configuré pour plusieurs espaces de travail. Dans ce cas, chaque espace de travail est associé à l’URL du serveur SharePoint correspondant qui est exposé par l’espace de travail. Pour ajouter un espace de travail, ajoutez une définition d’espace de travail au paramètre Espaces de travail. Une définition d’espace de travail présente le format suivant :
<name>
= <url>
où
<name>
est le nom de l’espace de travail JCR et
<url>
est l’URL du serveur SharePoint pour cet espace de travail.
Dans AEM, effectuez une étape en plus des étapes de configuration ci-dessus. Liste autorisée du lot 'com.day.cq.dam.cq-dam-jcr-connectors'.
Pour liste autorisée des lots dans AEM, effectuez les opérations suivantes :
Accédez à la console de gestion OSGi : http://localhost:4502/system/console/configMgr.
Recherchez le service Apache Sling Login Admin Whitelist.
Sélectionnez Contourner la liste blanche.
Ajoute "com.day.cq.dam.cq-dam-jcr-connectors" dans les lots de listes autorisées par défaut
Cliquez sur Enregistrer.
Si vous configurez plusieurs espaces de travail, indiquez le nom de l’espace de travail par défaut dans le paramètre du nom d’espace de travail par défaut.
Pour plus d’informations sur les paramètres liés à l’authentification, voir Authentification.
Une fois que vous avez configuré le connecteur, vérifiez les points suivants :
Pour synchroniser les ressources SharePoint avec AEM, effectuez les étapes suivantes :
Activez le service de synchronisation de la gestion des actifs numériques, qui est désactivé par défaut :
Vous pouvez éventuellement configurer le délai de synchronisation entre les cycles de synchronisation :
SharePoint comprend les méthodes d’authentification classique et basée sur les revendications qui prennent toutes les deux en charge les types d’authentification suivants :
En particulier, les types d’authentification suivants sont disponibles :
L’AEM JCR Connector for Microsoft SharePoint 2010 et Microsoft SharePoint 2013, version 4.0. prend en charge l’authentification basée sur les revendications (suggérée par Microsoft), qui fonctionne dans les modes suivants :
Configuration de l’authentification reposant sur les formulaires
Aller à : http://localhost:4502/system/console/bundles
Configuration de l’authentification de base (Windows)
Edit the configuration values
.com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory
.Seul un utilisateur authentifié à la fois sur AEM et SharePoint peut accéder au contenu SharePoint par le biais du connecteur.
Vous pouvez également utiliser l’extension de connecteur pour l’authentification afin de créer un module d’authentification personnalisé, qui, par exemple, met en correspondance l’accès par des utilisateurs AEM à des utilisateurs SharePoint spécifiques. Créez des utilisateurs AEM correspondant aux utilisateurs SharePoint (le nom d’utilisateur et le mot de passe doivent correspondre) afin de pouvoir afficher le contenu SharePoint mis en correspondance avec une instance de connecteur.
Pour créer un utilisateur dans AEM :
Pour ajouter l’utilisateur au groupe administrateur :
Téléchargez et installez le package basic auth
. zip
depuis Package Share.
Fermez QuickStart.
Ouvrez le fichier \crx-quickstart\repository\repository.xml.
Recherchez la balise <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>.
Insérez la balise <param name="disableTokenAuth" value="true"/>
dans la balise mentionnée à l’étape 4.
Enregistrez et fermez le fichier XML.
Redémarrez QuickStart et connectez-vous avec vos informations d’identification.
Dans sa version standard, le connecteur prend en charge l’authentification Windows IIS standard (de base) et l’authentification basée sur les formulaires (reposant sur les jetons). Les autres méthodes d’authentification peuvent être prises en charge grâce au mécanisme d’extensibilité.
Les étapes suivantes fournissent des instructions permettant d’étendre l’authentification standard afin de prendre en charge différentes méthodes d’authentification du serveur SharePoint :
Mettez en œuvre com.day.crx.spi.sharepoint.security.SharepointConnectionFactory
pour gérer le côté client de votre processus d’authentification spécifique.
Installez l’implémentation SharepointConnectionFactory
en tant que lot de fragments avec l’hôte de fragment com.day.crx.spi.crx2sharepoint-bundle
.
Si vous utilisez Maven, adaptez la configuration suivante de maven-bundle-plugin
aux exigences de votre projet :
<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>
Enregistrez la mise en œuvre SharepointConnectionFactory
dans la configuration de connecteur. Dans la fenêtre de configuration du connecteur, cliquez sur Options avancées. Dans le champ for Sharepoint Connection Factory, indiquez le nom de l’implémentation com.day.crx.spi.sharepoint.auth.CustomConnectionFactory
.
Redémarrez le connecteur.