Quels sont les documents explorés ?

• Lors de l'exploration initiale du contenu, les documents de tous les objets accessibles à partir du chemin d'accès à la collection de sites que vous avez spécifié sont explorés et ajoutés à votre collection. Les métadonnées personnalisées associées au contenu de SharePoint sont également explorées.
• Vous pouvez explorer un chemin d'accès à la collection de sites par collection.
• 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 et ne supprime jamais de contenu dans la source de données d'origine.

Discovery peut explorer les objets suivants :

• Collections de sites
• Sites
• SubSites
• Listes
• Liste des éléments
• Bibliothèques de documents
• Liste des pièces jointes

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 Online source de données doit répondre aux conditions suivantes :

• La collection de sites à laquelle vous vous connectez doit être créée avec un plan Entreprise. Il ne peut s'agir d'une collection créée dans le cadre d'un plan pour les travailleurs de première ligne.

• La prise en charge de l'authentification diffère en fonction du type de principal que vous spécifiez lorsque vous configurez la méthode d'authentification. Déterminez le type de principal que vous souhaitez utiliser avant de créer la collection ; vous ne pouvez pas modifier le type de principal ultérieurement. Les options suivantes sont disponibles :

  • Utilisateur: Le compte d'utilisateur crawl doit satisfaire aux exigences suivantes :

    • Le compte doit avoir un ID utilisateur Azure Active Directory avec l'autorisation d'accéder à tous les objets que vous voulez extraire. Par exemple, admin_user@company.onmicrosoft.com. L'ID de l'utilisateur doit avoir l'autorisation Site Collection Administrator.

    • L'authentification ancienne doit être activée pour le compte. Pour activer l'authentification héritée, allez sur le portail Azure ou contactez votre Azure Active Directory administrateur.

      Le connecteur prend en charge la méthode Password hash synchronization (PHS) pour activer l'identité hybride uniquement. L'utilisation de tout autre type d'authentification (comme l'authentification de passage ou la Fédération) est à vos risques et périls. À moins que vous n'ayez créé votre compte SharePoint Online avant janvier 2020, l'authentification à deux facteurs est activée par défaut pour le compte. Vous devez désactiver l'authentification à deux facteurs.

      Pour afficher et modifier votre statut d'authentification multifacteur, consultez les sections Afficher le statut d'un utilisateur ou Modifier le statut d'un utilisateur.

  • Service: Lorsque vous vous connectez à vos données en tant que principal de service Azure Active Directory, vous pouvez utiliser l'authentification multifactorielle.

Pour plus d'informations sur l' SharePoint, consultez la documentation Microsoft SharePoint pour les développeurs.

curl -s -XPOST -H "Authorization: ${access_token}" -H "Content-Type: application/json" \
  https://graph.microsoft.com/v1.0/sites/{site}/permissions -d '{
  "roles": ["read"],
  "grantedToIdentities": [{
    "application": {
      "id": "{azure_ad_app_id}",
      "displayName": "{display_name}"
    }
  }]
}'

Se connecter à une source de données en ligne SharePoint

À partir de votre projet d' Discovery, procédez comme suit :

1. Dans le volet de navigation, choisissez Gestion des collections.

2. Cliquez sur Nouvelle collection.

3. Cliquez sur SharePoint Online, puis cliquez sur Suivant.

4. Nommez la collection.

5. 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.

6. En option: Modifier le calendrier de synchronisation.

   Pour plus d'informations, voir Options de planification du ramassage.

7. Dans la section Méthode d'authentification, spécifiez le type de principal que vous souhaitez utiliser lorsque vous vous authentifiez avec SharePoint parmi les options suivantes :

   • Utilisateur: Un utilisateur de votre organisation Active Directory.

     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, par exemple crawl_username@company.onmicrosoft.com.

     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.

   • Service: Une identité de sécurité utilisée par les applications, les services et les outils d'automatisation créés par l'utilisateur pour accéder à des ressources Azure spécifiques. Il s'agit d'une identité d'utilisateur (vérifiée à l'aide d'un certificat) qui a un rôle spécifique et des autorisations étroitement contrôlées.

     La prise en charge de l'utilisation d'un service principal a été ajoutée à la version 4.0.3.

     Dans la section Entrez vos données d'identification, remplissez les champs suivants :

     Nom du titulaire

     Le locataire où résident les données. Par exemple, ibm.onmicrosoft.com.

     ID d'application

     L'identifiant de votre application. Par exemple, 19ce9f74-cd14-4b68-8dfc-4bcc75ed2fe9. Téléchargez les fichiers suivants :

     Dossier de certification

     Le fichier de certification que vous avez créé dans SharePoint. Par exemple, myinfo.crt.

     Fichier de clé privée

     Le fichier de clé privée que vous avez créé dans SharePoint. Par exemple, private.app.key.

     Si un mot de passe pour la clé privée est requis, indiquez-le. Si ce crawler a le droit d'accéder uniquement à la collection de sites spécifiée, réglez le commutateur Azure Access Control Service sur On, puis fournissez les valeurs suivantes :

     • ID de client
     • Secret client

8. Dans la section Spécifiez ce que vous voulez explorer, ajoutez des valeurs aux champs suivants :

   Url de la collection de sites

   Le service web SharePoint URL. Par exemple, https://organization_name.com.

   Principal de l'utilisateur uniquement

   Dans le champ Site Collection Name, indiquez le nom utilisé par la collection de sites. Obtenir le nom à partir des paramètres de la collection de sites.

9. 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.

10. 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. Pour plus d'informations, voir Supporting document-level security.

    Utilisateur principal uniquement: Lorsque vous activez cette option, vous devez ajouter au champ Identifiant de l'application l'identifiant Azure qui a été attribué à l'application lors de son enregistrement.

    Pour activer la sécurité au niveau des documents, vous devez enregistrer votre application auprès de SharePoint. Pour plus d'informations, voir les étapes préalables pour le type de principal que vous utilisez.

11. 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.

12. 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.