Microsoft SharePoint On Prem
L'exploration des documents stockés dans une source de données Microsoft SharePoint sur site.
IBM Cloud Pak for Data IBM Software Hub
Ces informations ne s'appliquent qu'aux déploiements installés. Pour plus d'informations sur la connexion à un site SharePoint sur site à partir d'un déploiement géré, voir SharePoint On Prem.
Quels sont les documents explorés ?
- Seuls les documents pris en charge par Discovery sont explorés ; tous les autres sont ignorés. Pour plus d'informations, voir Types de fichiers pris en charge.
- La sécurité au niveau du document est prise en charge. Lorsque cette option est activée, vos utilisateurs peuvent explorer et interroger le même contenu que celui auquel ils ont accès lorsqu'ils sont connectés à SharePoint. Pour plus d'informations, voir Supporting document-level security.
- Lorsqu'une source est réexplorée, les nouveaux documents sont ajoutés, les documents mis à jour sont modifiés dans leur version actuelle et les documents supprimés sont effacés de l'index de la collection.
- Tous les Discovery connecteurs de sources de données sont en lecture seule. Quelles que soient les autorisations accordées au compte d'exploration, Discovery n'écrit, ne met à jour ou ne supprime jamais de contenu dans la source de données d'origine.
Configuration requise pour les sources de données
En plus des conditions requises pour la source de données pour tous les déploiements installés, votre SharePoint On Prem data source doit répondre aux conditions suivantes :
- La connexion à la source de données prend en charge SharePoint 2013, 2016 ou 2019.
- Vous devez obtenir toutes les licences de service requises pour la source de données à laquelle vous souhaitez vous connecter. Pour plus d'informations sur les licences, contactez l'administrateur système de la source de données.
Pour plus d'informations sur SharePoint On Prem, voir Microsoft SharePoint developer documentation.
Procédure prérequise
Avant de créer une collection SharePoint On Prem, vous devez effectuer les opérations suivantes :
-
Travailler avec l'administrateur Sharepoint pour coordonner la mise en place d'un accès en lecture intégrale pour l'application web.
Pour plus d'informations, voir Gérer les autorisations pour une application web dans Sharepoint Server.
-
Si vous souhaitez activer la sécurité au niveau des documents, vous devez prendre certaines mesures pour la mettre en place. Pour plus d'informations, voir Supporting document-level security.
Vous devez recueillir les informations suivantes auprès de l'administrateur LDAP :
- URL du serveur LDAP
- Le serveur LDAP auquel se connecter URL, par exemple
ldap://<ldap_server>:<port>. - Nom d'utilisateur de la liaison LDAP
- Le nom d'utilisateur utilisé pour se connecter au service d'annuaire. Dans la plupart des cas, le nom d'utilisateur est un nom distinctif (DN). Le nom de connexion peut parfois fonctionner avec Active Directory. Mais contrairement à la connexion générale à Windows, elle est sensible à la casse. Le nom distinctif fonctionne toujours.
- Mot de passe de l'utilisateur de liaison LDAP
- Le mot de passe utilisé pour se connecter au service d'annuaire.
- Nom distinctif de base LDAP
- Le point de départ pour rechercher les entrées utilisateur dans LDAP, par exemple
CN=Users,DC=example,DC=com. - Filtre utilisateur LDAP
- Le filtre utilisateur pour rechercher les entrées utilisateur dans LDAP. S'il n'est pas spécifié, la valeur par défaut est
(userPrincipalName={0}).
Si vous utilisez la version 2.2.1 ou une version antérieure, vous devez effectuer certaines tâches préalables supplémentaires avant de pouvoir vous connecter à la source de données. Pour plus d'informations, voir SharePoint Les étapes préalables pour les versions antérieures.
Connexion à une source de données SharePoint On Prem
À partir de votre projet d' Discovery, procédez comme suit :
-
Dans le volet de navigation, choisissez Gestion des collections.
-
Cliquez sur Nouvelle collection.
-
Cliquez sur SharePoint On Prem, puis sur Next.
-
Nommez la collection.
-
Si la langue des documents dans SharePoint n'est pas l'anglais, sélectionnez la langue appropriée.
Pour obtenir la liste des langues prises en charge, voir Langues prises en charge.
-
En option: Modifier le calendrier de synchronisation.
Pour plus d'informations, voir Options de planification du ramassage.
-
Dans la section Entrez vos données d'identification, remplissez les champs suivants :
- Nom d'utilisateur
- Le nom d'utilisateur de l'utilisateur d' SharePoint, qui a accès à tous les sites et listes à explorer et à indexer.
- Mot de passe
- Le mot de passe de l'utilisateur SharePoint.
Cette valeur n'est jamais renvoyée et n'est utilisée que lorsque vous créez ou modifiez des identifiants.
-
Optionnel: si vous souhaitez utiliser l'authentification basée sur les revendications SAML (Security Assertion Mark-up Language), réglez le commutateur Activer l'authentification SAML sur
On. Dans le cas contraire, l'authentification Windows NT LAN Manager (NTLM) est utilisée. Ajoutez des valeurs aux champs suivants :- Point de terminaison du fournisseur d'identité
- L' URL e du point de terminaison du fournisseur d'identité, par exemple
https://adfs.server.example.com/adfs/services/trust/2005/UsernameMixed. - Point de terminaison de la partie utilisatrice
- Facultatif. Le site URL du point d'accès Relying Party Trust. Si non spécifié, la valeur suivante est utilisée :
https://<sharepoint_server>:<port>/_trust/. - Identifiant de confiance de la partie utilisatrice
- URL de l'identifiant de confiance de la partie utilisatrice, par exemple
urn:sharepoint:sample. Si non spécifié, la valeur suivante est utilisée :https://<sharepoint_server>:<port>/_trust/. Cette fonctionnalité est disponible dans les versions 2013, 2016 et 2019.
-
Dans la section Spécifiez ce que vous voulez explorer, ajoutez le service web SharePoint URL au champ Url de l'application web. Par exemple,
https://<host>:<port>. -
Optionnel: Si vous utilisez un serveur proxy pour accéder au serveur de la source de données, dans la section Paramètres proxy, réglez le commutateur Activer les paramètres proxy sur
On. Ajoutez des valeurs aux champs suivants :- Nom d'utilisateur
- Facultatif. Le nom d'utilisateur du serveur proxy à authentifier, si le serveur proxy nécessite une authentification. Si vous ne connaissez pas votre nom d'utilisateur, vous pouvez l'obtenir auprès de l'administrateur de votre serveur proxy.
- Mot de passe
- Facultatif. Le mot de passe du serveur proxy à authentifier, si le serveur proxy nécessite une authentification. Si vous ne connaissez pas votre mot de passe, vous pouvez l'obtenir auprès de l'administrateur de votre serveur proxy.
- Nom d'hôte ou adresse IP du serveur proxy
- Le nom d'hôte ou l'adresse IP du serveur proxy.
- Numéro de port du serveur proxy
- Le port réseau auquel vous souhaitez vous connecter sur le serveur proxy.
-
Optionnel: si vous souhaitez activer la sécurité au niveau du document, dans la section Sécurité, réglez le commutateur Activer la sécurité au niveau du document sur
On.Lorsque cette option est activée, vos utilisateurs peuvent explorer et interroger le même contenu que celui auquel ils ont accès lorsqu'ils sont connectés à SharePoint. Complétez les étapes préalables pour ajouter le support.
Lorsque vous activez cette option, vous devez fournir des valeurs pour les champs suivants :
- URL du serveur LDAP
- Le serveur LDAP auquel se connecter URL, par exemple
ldap://<ldap_server>:<port>. - Nom d'utilisateur de la liaison LDAP
- Le nom d'utilisateur utilisé pour se connecter au service d'annuaire. Dans la plupart des cas, le nom d'utilisateur est un nom distinctif (DN). Le nom de connexion peut parfois fonctionner avec Active Directory. Mais contrairement à la connexion générale à Windows, elle est sensible à la casse. Le nom distinctif fonctionne toujours.
- Mot de passe de l'utilisateur de liaison LDAP
- Le mot de passe utilisé pour se connecter au service d'annuaire.
- Nom distinctif de base LDAP
- Le point de départ pour rechercher les entrées utilisateur dans LDAP, par exemple
CN=Users,DC=example,DC=com. - Filtre utilisateur LDAP
- Le filtre utilisateur pour rechercher les entrées utilisateur dans LDAP. S'il n'est pas spécifié, la valeur par défaut est
(userPrincipalName={0}).
-
Si vous souhaitez que le robot extraie le texte des images du site, développez Plus de paramètres de traitement, et réglez Appliquer la reconnaissance optique de caractères (OCR) sur
On.Lorsque l'OCR est activé et que vos documents contiennent des images, le traitement prend plus de temps. Pour plus d'informations, voir Reconnaissance optique des caractères.
-
Cliquez sur Terminer.
La collection est créée rapidement. Le traitement des données prend plus de temps au fur et à mesure qu'elles sont ajoutées à la collection.
Si vous souhaitez vérifier l'état d'avancement du projet, rendez-vous sur la page Activité. Dans le volet de navigation, cliquez sur Gestion des collections, puis sur pour ouvrir la collection.
Étapes préalables pour les versions antérieures
Si vous utilisez la version 2.2.1 ou une version antérieure, vous devez effectuer ces étapes supplémentaires avant de pouvoir vous connecter à la source de données :
- Obtenez un paquet de services web de votre Discovery cluster. Ce package de services Web est un module personnalisé utilisé par le moteur d'exploration pour obtenir les informations nécessaires à l'exploration. Pour plus d'informations, voir Obtenir le paquet de services web.
- Déployez le paquet de services web sur le serveur SharePoint. Pour plus d'informations, voir Déployer les services web sur le serveur SharePoint.
Obtenir le paquet de services web
Pour obtenir le paquet de services web de votre cluster Discovery, effectuez les étapes suivantes :
-
Connectez-vous à votre cluster Discovery.
-
Entrez la commande suivante pour obtenir votre nom de pod d'
crawler:oc get pods | grep crawlerVous pouvez voir une sortie similaire au message suivant :
wd-discovery-crawler-57985fc5cf-rxk89 1/1 Running 0 85m -
Entrez la commande suivante pour obtenir le fichier d'
ESSPSolution.wsp, en remplaçant{crawler-pod-name}par le nom de pod d'crawlers que vous avez obtenu à l'étape précédente :oc exec {crawler-pod-name} -- ls -l /opt/ibm/wex/zing/resources/ | grep ESSPSolutionVous pouvez voir une sortie similaire au message suivant :
-rw-r--r--. 1 dadmin dadmin 8600 Feb 3 08:23 ESSPSolution-${build-version}.wsp -
Entrez la commande suivante pour copier le fichier
ESSPSolution.wspsur le serveur hôte, en remplaçant{build-version}par le numéro de version de build de l'étape précédente et{crawler-pod-name}par le nom du podcrawler:oc cp {crawler-pod-name}:/opt/ibm/wex/zing/resources/ESSPSolution-${build-version}.wsp ESSPSolution.wsp
Déployer les services web sur le serveur SharePoint
Vous pouvez soit déployer manuellement les services Web sur le serveur SharePoint, soit exécuter un script qui les déploie automatiquement.
Pour exécuter le script qui déploie automatiquement les services web :
-
Exécutez le script
ESSPSolution.wspsur le serveur SharePoint en entrant la cmdlet Windows PowerShell suivante :Add-SPSolution -LiteralPath C:\files\ESSPSolution.wsp -
Dans l' SharePoint,, ouvrez l' SharePoint Administration centrale, puis ouvrez les paramètres système.
-
Déployer le package en utilisant des solutions de ferme.
-
Sélectionnez la solution
esspsolution.wsp, puis déployez-la.Une fois le déploiement terminé, la solution du parc de serveurs est répertoriée dans la console d'administration SharePoint. Un administrateur peut activer ou désactiver la solution et planifier des déclencheurs.
-
Facultatif : Quelle que soit l'approche que vous avez utilisée pour déployer les services Web, pour terminer le déploiement dans certains environnements, vous devrez peut-être appliquer les configurations suivantes au serveur Internet Information Services (IIS) qui héberge le serveur SharePoint et les services Web :
- Autoriser l'emprunt d'identité .NET sur IIS
- Changer le niveau de confiance ASP.NET par WSS_Medium
Vous pouvez appliquer ces configurations dans le Gestionnaire des services Internet.