DocumentationAEM 6.4Guide d’administration

SharePoint Connector sharepoint-connector

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

Créé pour :

  • Admin
CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Day JCR Connector for Microsoft SharePoint 2010 et Microsoft SharePoint 2013, version 4.0.

Cet article comprend des détails relatifs au connecteur JCR Adobe pour Microsoft SharePoint 2010 et Microsoft SharePoint 2013, version 4.0.

SharePoint Connector prend en charge les fonctionnalités de base suivantes :

  • Lecture de contenu et de métadonnées à partir de SharePoint.
  • Reconnaissance des paramètres de sécurité SharePoint pour le contenu consulté en appliquant l’authentification et l’autorisation SharePoint natives
  • Intégration de contenu à l’aide de l’outil de recherche de contenu
  • Utilisation de composants AEM, tels que Ressource externe pour afficher des images et des vidéos SharePoint
  • Synchronisation de SharePoint avec AEM Assets

Toutes les fonctionnalités sont implémentées à l’aide des services web SharePoint natifs comme interface de contenu et de services SharePoint.

NOTE
SharePoint Connector est également pris en charge avec le pack de services 2 d’AEM 6.1. Le connecteur ne prend plus en charge le montage de référentiel virtuel et, par conséquent, il ne peut pas être monté. Si vous souhaitez accéder au référentiel SharePoint à l’aide des API Java, utilisez une mise en œuvre de référentiel JCR de SharePoint Connector 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. Consultez la documentation du fournisseur relative à SharePoint pour plus d’informations sur ces sujets. Le connecteur nécessite que ces parties de l’infrastructure soient correctement installées, configurées et utilisées.

Prise en main getting-started

Pour commencer à utiliser le connecteur, procédez comme suit :

  • Assurez-vous de disposer au moins de Java 7.

  • Téléchargez le fichier de distribution du package connecteur depuis Package Share.

  • Copier un license.properties dans le répertoire contenant le fichier cq-quickstart-6.4.0.jar fichier .

  • Double-cliquez/appuyez sur le fichier .jar pour démarrer AEM, ou démarrez-le à partir de la ligne de commande.

  • Installez le package connecteur à partir de Package Manager.

  • Configurez les options du connecteur.

Installation du connecteur SharePoint installing-sharepoint-connector

Le connecteur est un package de contenu qui facilite la configuration. Installez le module à 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.

Configuration requise installation-requirements

Le connecteur requiert les éléments suivants :

  • Java Runtime Environment 1.7 ou version ultérieure
  • Services web SharePoint disponibles via le réseau
  • URL du serveur SharePoint
  • Informations d’identification et autorisations de l’utilisateur pour les référentiels CRX et SharePoint
  • Plateformes prises en charge

Le connecteur SharePoint peut être téléchargé à partir de packageshare.

Plateformes prises en charge supported-platforms

Le connecteur prend en charge les éléments suivants :

  • AEM versions :

    • AEM 6.4, 6.3

  • Versions de Microsoft SharePoint :

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

  • Si vous avez besoin de support pour les déploiements personnalisés du connecteur (OEM, exigences spéciales, méthodes d’authentification personnalisées), contactez le bureau d’Adobe de votre région.

NOTE
Le connecteur ne prend en charge que les configurations officiellement prises en charge par Microsoft. Consultez les configurations système requises pour MOSS 2010 et MOSS 2013.

Installation standard standard-installation

AEM Package Share est utilisé pour distribuer des fonctionnalités de produit, des exemples et des correctifs logiciels. Pour plus d’informations, voir Documentation du partage de modules.

Pour accéder au partage de modules sur la page d’accueil d’AEM, appuyez/cliquez sur Outils puis sélectionnez Partage de modules. Vous avez besoin d’une Adobe ID valide contenant l’adresse électronique de votre société. En outre, une fois connecté à votre compte, demandez l’accès au partage de modules.

Intégration à AEM integrating-with-aem

Pour installer le package de contenu connecteur.

  1. Ouvrez un ticket d’assistance à l’Adobe pour demander le Feature Pack du connecteur.

  2. Téléchargez le package lorsqu’il est disponible, puis ouvrez Package Manager pour votre instance AEM.

  3. Appuyez/cliquez sur Installer sur la page de description du package.

  4. Dans la boîte de dialogue Installer le package, appuyez/cliquez sur Installer.

    Remarque  : Assurez-vous d’être connecté en tant qu’administrateur.

  5. Lorsque le package est installé, appuyez/cliquez sur Fermer.

Configuration de SharePoint Connector configuring-sharepoint-connector

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 avec le connecteur SharePoint.

Configuration de la connexion au serveur SharePoint configuring-the-connection-with-the-sharepoint-server

Pour définir l’URL du serveur SharePoint et les options avancées, procédez comme suit :

  1. Accédez à la console de gestion OSGi : http://localhost:4502/system/console/configMgr.
  2. Recherchez le lot Connecteur JCR Day pour Microsoft SharePoint.
  3. Modifiez les valeurs de configuration.
  4. Définissez l’URL du serveur SharePoint comme valeur de Espaces de travail.
  5. Appuyez/cliquez sur Enregistrer.

chlimage_1-81

Paramètres "Espaces de travail" et "Nom de l’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 a 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. Ajoutez dans la liste autorisée le lot ’com.day.cq.dam.cq-dam-jcr-connectors’.

Pour placer les lots en liste autorisée dans AEM, effectuez les étapes suivantes :

  1. Accédez à la console de gestion OSGi : http://localhost:4502/system/console/configMgr.

  2. Recherchez le service Liste autorisée d’administration des connexions Apache Sling.

  3. Sélectionnez Contourner la liste autorisée.

  4. Ajouter "com.day.cq.dam.cq-dam-jcr-connectors' dans la valeur par défaut des lots de liste autorisée

  5. Cliquez sur Enregistrer.

chlimage_1-82

NOTE
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 associés à l’authentification, consultez la section Authentification.

Vérification de la configuration de SharePoint verifying-the-sharepoint-setup

Après avoir configuré le connecteur, vérifiez les éléments suivants :

  • Le serveur SharePoint s’exécute et les services web sont accessibles à l’instance de connecteur.
  • Les informations d’identification de l’utilisateur SharePoint sont valides et l’utilisateur dispose des autorisations SharePoint nécessaires
  • Le connecteur est installé et configuré correctement

Configuration de la synchronisation DAM avec le serveur SharePoint configuring-dam-sync-with-the-sharepoint-server

Pour synchroniser les ressources SharePoint avec AEM, procédez comme suit :

  1. Accédez à la console de gestion OSGi : http://localhost:4502/system/console/configMgr.
  2. Recherchez le service "Default DAMAssetSynchronization".
  3. Modifiez les valeurs de configuration.
  4. Définissez le nom d’utilisateur et le mot de passe correspondant de l’utilisateur ayant accès au site SharePoint.
  5. Cliquez sur Enregistrer.

Activez le service de synchronisation DAM, qui est désactivé par défaut :

  1. Accédez aux composants de la console web OSGi : http://localhost:4502/system/console/components.
  2. Recherchez "com.day.cq.dam.jcrconnectors.impl.AssetSynchronizationService".
  3. Cliquez sur Activer.

Vous pouvez éventuellement configurer le délai de synchronisation entre différents cycles de synchronisation :

  1. Accédez à la console de gestion OSGi : http://localhost:4502/system/console/configMgr.
  2. Recherchez "DAY CQ DAM JCR Connector Asset Synchronization Service".
  3. Modifiez les valeurs de configuration.
  4. Définissez la valeur de la période de synchronisation (en secondes).
  5. Cliquez sur Enregistrer.

Configuration de l’authentification configuring-authentication

SharePoint comprend les méthodes d’authentification classique et basée sur les revendications qui prennent en charge les types d’authentification suivants :

  • De base
  • Basée sur les formulaires

En particulier, les types d’authentification suivants sont disponibles :

  • Classic-Basic
  • Classic-Forms
  • Revendications - De base
  • Revendications Forms

Le connecteur JCR d’AEM pour 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 :

  • Authentification de base/NTLM  : le connecteur tente d’abord de se connecter à l’aide de l’authentification de base. S’il n’est pas disponible, il passe à l’authentification NTLM.
  • Authentification reposant sur les formulaires  : SharePoint valide les utilisateurs en fonction des informations d’identification qu’ils saisissent dans un formulaire de connexion (généralement une page web). Le système émet un jeton pour les requêtes authentifiées qui contient une clé pour rétablir l’identité des requêtes suivantes.

Configuration de l’authentification Forms

Allez à : http://localhost:4502/system/console/bundles.

  1. Cliquez sur OSGi > Configuration.
  2. Rechercher "Day JCR Connector for Microsoft Share"
  3. Cliquez sur "Editer les valeurs de configuration".
  4. Définissez la valeur de « Fabrique de connexions SharePoint » sur « com.day.crx.spi.sharepoint.security.FormsBasedAuthenticationConnectionFactory ».
  5. Cliquez sur Enregistrer

Configuration de l’authentification de base (Windows)

  1. Désactivez l’authentification par jeton.
  2. Allez à : http://localhost:4502/system/console/bundles.
  3. Cliquez sur OSGI > Configuration.
  4. Rechercher Connecteur JCR Day pour Microsoft SharePoint.
  5. Cliquez sur Edit the configuration values.
  6. Définissez la valeur de la Fabrique de connexions SharePoint sur com.day.crx.spi.sharepoint.security.WindowsAuthenticationConnectionFactory.
  7. Cliquez sur Enregistrer.

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 AEM utilisateurs correspondant aux utilisateurs SharePoint (le nom d’utilisateur et le mot de passe doivent correspondre) pour pouvoir voir le contenu SharePoint mappé sur l’instance de connecteur.

Pour créer un utilisateur dans AEM, procédez comme suit :

  1. Connectez-vous à http://localhost:9502/ avec l’utilisateur administrateur.
  2. Cliquez sur Outils.
  3. Cliquez sur Sécurité.
  4. Cliquez sur Utilisateurs.
  5. Cliquez sur Créer un utilisateur
  6. Fournissez l’ID utilisateur (un nom d’utilisateur ayant accès à SharePoint)
  7. Fournissez le mot de passe correspondant
  8. Cliquez sur la coche verte pour créer l’utilisateur

Pour ajouter l’utilisateur au groupe d’administrateurs :

  1. Accès à Administration des groupes
  2. Cliquez sur le noeud "a".
  3. Cliquez sur "administrateurs".
  4. Saisissez l’ID utilisateur créé ci-dessus dans la zone de texte avant Parcourir button
  5. Cliquez sur la coche verte pour ajouter l’utilisateur au groupe administrateur

Désactivation de l’authentification par jeton disable-token-authentication

  1. Téléchargez et installez le package basic auth. zip à partir du partage de modules.

  2. Fermez Quickstart.

  3. Ouvrir le fichier \crx-quickstart\repository\repository.xml.

  4. Recherchez la balise <LoginModule class="com.day.crx.core.CRXLoginModule"> ... </LoginModule>..

  5. Insérez la balise <param name="disableTokenAuth" value="true"/> dans la balise mentionnée à l’étape 4.

  6. Enregistrez et fermez le fichier XML.

  7. Redémarrez le QuickStart et connectez-vous avec vos informations d’identification.

Prise en charge de différentes méthodes d’authentification du serveur SharePoint supporting-different-authentication-methods-of-the-sharepoint-server

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 :

  1. Mettez en œuvre com.day.crx.spi.sharepoint.security.SharepointConnectionFactory pour gérer le côté client de votre processus d’authentification spécifique.

  2. Installez la mise en œuvre SharepointConnectionFactory comme un lot de fragment 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 :

    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. 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 Fabrique de connexions SharePoint, spécifiez le nom de la mise en œuvre com.day.crx.spi.sharepoint.auth.CustomConnectionFactory.

  4. Redémarrez le connecteur.

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