Configurer le Connecteur de recherche SharePoint Online

Configurez le Connecteur de recherche SharePoint Online locataire et connectez-le à Microsoft SharePoint votre instance. Validez la connexion pour éviter tout échec de configuration avant d’indexer les sites pour la recherche.

Configurer le Microsoft SharePoint locataire

Configurez votre Microsoft SharePoint locataire pour commencer avec le Connecteur de recherche SharePoint Onlinefichier .

Avant de commencer

En tant qu’administrateur Microsoft SharePoint , créez une application personnalisée en spécifiant l’URL racine (https:// <nom du site>.sharepoint.com), le domaine de l’application, l’URL de redirection et d’autres paramètres.

Assurez-vous d’effectuer la configuration comme expliqué à la section .

Connectez-vous avec vos informations d’identification d’administrateur pour accorder les autorisations.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Effectuez la procédure suivante à partir de votre Microsoft SharePoint compte. Pour plus d’informations sur la création et la configuration d’applications personnalisées, consultez le développement SharePoint.
Remarque :
Lorsque les autorisations attribuées dans les applications Azure ont des problèmes de privilèges, le message d’erreur suivant s’affiche : Message d’erreur : Échec de la méthode : (/_api/web/XXXXXXX) avec le code : 401 - Combo nom d’utilisateur/mot de passe non valide. Résolvez ce problème avec les instructions disponibles dans KB1117977.
Lorsque vous souhaitez que les résultats de la recherche n’affichent que les versions publiées du document, assurez-vous de sélectionner des autorisations d’application au lieu des autorisations déléguées lors de la configuration des autorisations expliquées à la section Parlé.
Remarque :
Les administrateurs peuvent limiter l’indexation des versions publiées uniquement, en veillant à ce que les brouillons ou les travaux inachevés ne soient pas affichés dans les résultats de recherche.

Procédure

  1. Accédez à la Azure > Active Directory > Inscriptions des applications > Toutes les applications et sélectionnez votre application.

    Utilisez une application existante ou créez-en une.

  2. Accédez à la Inscriptions des applications > Autorisations d’API, puis cliquez sur Ajouter une autorisation.
  3. Sélectionnez l'une des options suivantes :
    1. Accédez à la Microsoft Graph > Autorisations déléguées pour le graphique.
    2. Accédez à la Microsoft Graph > Autorisations d’application pour le graphique.
    Ajoutez l’autorisation Sites.ReadWrite.All à partir de la liste Sites. L’autorisation Sites.ReadWrite.All facilite la création d’abonnements.

    Ajoutez l’autorisation User.Read dans la liste Utilisateurs.

    Ces autorisations utilisateur sont utilisées pour analyser les Microsoft SharePoint données ultérieurement.
  4. Accédez à la Sharepoint > Autorisations d’application > Sites, puis sélectionnez Sites.FullControl.All ou Sites.Read.All pour REST.
  5. Cliquez sur Accorder le consentement de l’administrateur, sélectionnez Oui, puis cliquez sur Enregistrer et continuer dans l’onglet Autorisation configurée .
  6. Accédez à la Authentification > Web > URL de redirection.
    1. Ajoutez l’URL au format suivant https://<votre URL d’instance ServiceNow>/oauth_redirect.do, par exemple, https://eesharepoint.example.com/oauth_redirect.do et cliquez sur Enregistrer.
  7. Accédez au certificat et à la clé secrète pour votre application et enregistrez-les.
  8. Cliquez sur Ajouter un utilisateur sur le portail d’administration Microsoft, spécifiez les détails de l’utilisateur, puis cliquez sur Terminer.
    Remarque :
    La recherche explore les sites auxquels vous pouvez accéder. Veillez à sélectionner l’utilisateur disposant des autorisations appropriées uniquement pour le contenu requis. Pour plus d’informations, reportez-vous à la section pemissions de l’utilisateur. La sélection d’un utilisateur de haut niveau peut importer plus de documents que vous ne le souhaitez.

    Pour plus d'informations, consultez https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azuread.

Que faire ensuite

Effectuez l’intégration à partir de votre ServiceNow Recherche IA compte. Pour plus d'informations, consultez Intégrer les Microsoft SharePoint sources de recherche aux Recherche IA profils.

Connecter votre ServiceNow instance à un Microsoft SharePoint locataire

Connectez votre ServiceNow instance à un Microsoft SharePoint locataire. Créez des connexions OAuth personnalisées ServiceNow pour Microsoft SharePoint authentifier les ServiceNow demandes.

Avant de commencer

  • Assurez-vous d’avoir une connaissance pratique des outils du programme de développement SharePoint et des autres ressources nécessaires pour configurer l’application.
  • Assurez-vous d’être au courant des ServiceNow® intégrations.
  • Exécutez une validation de votre configuration avant de commencer à indexer les sites.
Rôle requis : sn_sp_con.admin et admin.

Procédure

  1. Accédez à la Instance ServiceNow > OAuth système > Registre d'application.
  2. Cliquez sur Nouveau.
    Le système affiche le message What kind of OAuth application ?
  3. Sélectionnez Se connecter à un fournisseur OAuth tiers.
  4. Créez les registres suivants :
    1. Renseignez les champs du formulaire Connexion graphique.
      Pour obtenir une description de la valeur de champ, reportez-vous à la section Formulaire Connexion graphique.
    2. Renseignez les champs du formulaire Connexion REST.
      Pour obtenir une description de la valeur de champ, reportez-vous à la section Formulaire Connexion REST.
    3. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
Profil de l'entité OAuth
  1. Accédez à la table Profils des entités OAuth [oauth_entity_profile] pour rechercher les entrées suivantes :
    • <Nom du registre d’application graphique>.default_profile
    • <nom du registre d’application REST>.default_profile

    Deux profils d’entité OAuth générés par le système (REST et Graph) sont créés dans la table Profils d’entité OAuth [oauth_entity_profile]. Pour plus d'informations, voir Spécifier un profil OAuth

Périmètres des entités OAuth
  1. Insérez une ligne avec les valeurs suivantes dans la table Périmètres des entités OAuth [oauth_entity_scope] :
    Tableau 1. Périmètres des entités OAuth
    Graphique REST
    Nom : N’importe quel nom de votre choix Nom : N’importe quel nom de votre choix
    Fournisseur OAuth : enregistrement du registre d’application Graph Fournisseur OAuth : enregistrement du registre d’application REST
    Application : globale Application : globale
    (Pour les autorisations déléguées) OAuthscope : offline_access https://graph.microsoft.com/Sites.ReadWrite.All

    (Pour les autorisations d’application) OAuthscope : https://graph.microsoft.com/.default

    		Périmètre OAuth :https://<nom de l’instance>.sharepoint.com/

    Pour plus d'informations, voir Spécifier un périmètre OAuth

Périmètres des profils des entités OAuth
  1. Insérez une ligne avec les valeurs suivantes dans la table Périmètres des profils des entités OAuth [oauth_entity_profile_scope] :
    Tableau 2. Périmètres des profils des entités OAuth
    Graphique REST
    Profil de l’entité OAuth : profil d’entité de graphique généré dans la table Profils des entités OAuth [oauth_entity_profile]. Profil de l’entité OAuth : profil de l’entité REST généré dans la table Profils des entités OAuth [oauth_entity_profile].
    Périmètre de l’entité OAuth : sélectionnez la table Périmètre de l’entité OAuth graphique [oauth_entity_profile_scope] créée. Périmètre de l’entité OAuth : sélectionnez la table Périmètre de l’entité OAuth REST [oauth_entity_profile_scope] créée.
    Application : globale Application : globale
Informations d’identification
  1. Accédez à la Connexions et informations d'identification > Identifiantset créez les informations d’identification OAuth 2.0 :
    1. Renseignez les champs des formulaires Informations d’identification Graphique ou REST.
      Tableau 3. Formulaire Informations d’identification OAuth 2.0
      Champ Description
      Nom Nom de votre choix.
      Profil de l'entité OAuth (pour le graphique) Profil d’entité de graphique identifié.

      (Pour REST) Profil de l’entité REST identifié.
    2. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
      Remarque :
      Pour plus d’informations sur les entités, les alias de connexion et d’informations d’identification, consultez .
Connexion
  1. Accédez à la Connexions et informations d'identification > Connexion, puis cliquez sur Nouveau pour créer des connexions HTTP(s) pour le graphique ou REST suivant.
    1. Renseignez les champs du formulaire
      Tableau 4. Formulaire de connexion
      Champ Description
      Nom : n’importe quel nom de votre choix pour le graphique Nom : n’importe quel nom de votre choix pour REST
      Informations d’identification : sélectionnez le graphique Informations d’identification Informations d’identification : sélectionnez les informations d’identification REST
      Alias de connexion : sn_sp_spoke. Microsoft SharePointGraph Alias de connexion : sn_sp_spoke. MicrosoftSharePointOnline
      URL de connexion : https://graph.microsoft.com/v1.0/ URL de connexion : https://<URL de l’hôte de votre instance SharePoint>/
      Domaine : global Domaine : global
    2. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
    Pour plus d'informations, consultez Connexions et informations d'identification et Créer une connexion HTTP(s).
Locataires
  1. Accédez à Locataires.
    1. Cliquez sur Nouveau pour créer des connexions Graph ou REST .
    2. Renseignez les champs du formulaire.
      Tableau 5. Formulaire Connexion du locataire
      Champ Description
      Nom Nom de votre choix.
      Alias Pour Graph :sn_sp_spoke. Microsoft SharePointGraph

      Pour REST :sn_sp_spoke. MicrosoftSharePointOnline
      URL racine SharePoint URL racine en tant que <SiteName>.sharepoint.com
      ID de locataire ID de locataire spécifique requis pour la connexion Graph ou REST.
      Domaine Global
    3. Cliquez avec le bouton droit sur l’en-tête de la rubrique, puis cliquez sur Enregistrer.
    Pour plus d’informations, consultez , Configurer l’enregistrement de l’alias de connexion et d’informations d’identification de l’abonnement au site racine de SharePoint Graphet Définir les locatairesCréer des alias pour plusieurs locataires
Certificats
  1. Accédez à la Définition du système > Certificats > Certificat Microsoft SharePoint Online.
    1. Joignez le certificat Java Key Store généré sur le portail Azure AD.
      Pour plus d'informations, consultez .
    2. Mettez à jour le mot de passe du magasin de clés avec le mot de passe du fichier Java Key Store (.jks).
    3. Mettez à jour le type vers le magasin de clés Java.
    4. Cliquez avec le bouton droit sur l’en-tête de la rubrique, puis cliquez sur Enregistrer.
    Pour plus d'informations, consultez .
Clés JWT
  1. Accédez à la OAuth système > Clés JWT > Clés JWT Microsoft SharePoint Online.
    1. Mettre à jour la clé de signature avec le mot de passe du fichier de certificat (.cer).
    2. Cliquez avec le bouton droit sur l’en-tête de la rubrique, puis cliquez sur Enregistrer.
  2. Accédez à la OAuth système > Fournisseurs JWT > Fournisseur Microsoft SharePoint Online JWT.
    1. Mettez à jour la réclamation aud avec https://login.microsoftonline.com/<Tenant-id>/oauth2/token.
    2. Mettez à jour l’ISS et le sous-sinistre avec les ID clients respectifs sur les inscriptions d’applications Azure AD.
    3. Cliquez sur Enregistrer.
Connexion
  1. Accédez à la Connexions et informations d'identification > Connexion.
    1. Ouvrez l’enregistrement de connexion REST et, dans l’onglet Attributs , spécifiez l’empreinte du certificat codé en base 64.
    2. Sélectionnez l’option Informations d’identification suivante :
      • (Pour le graphique) : accédez à la table [Informations d’identification] (oauth_2_0_credentials), ouvrez Graphique, puis cliquez sur Obtenir le jeton OAuth.

        Veillez à vous connecter à votre Microsoft SharePoint instance avec les informations d’identification de l’utilisateur que vous avez créé pour obtenir le jeton OAuth pour la connexion Graph. Conservez les informations d’identification dans l’instance.

      • ( Pour REST) : accédez à la table [Informations d’identification] (oauth_2_0_credentials), ouvrez REST, puis cliquez sur Obtenir le jeton OAuth.

        Assurez-vous de vous connecter à votre Microsoft SharePoint instance avec les informations d’identification de l’administrateur de locataire pour obtenir le jeton OAuth pour la connexion REST. Conservez les informations d’identification dans l’instance.

        Validez les informations d’identification pour éviter toute erreur de configuration. Pour plus d’informations sur la validation de la connexion SharePoint, voir Valider la Microsoft SharePoint connexion.

    3. Cliquez sur Enregistrer.
Domaines approuvés
  1. Accédez à la table Domaines de confiance (sn_ais_spoke_trusted_domains) et cliquez sur Nouveau pour créer un enregistrement de domaine.
    1. Renseignez les champs du formulaire.
      Tableau 6. Formulaire d’enregistrement de domaine
      Champ Description
      Nom Nom de votre choix.
      Domaine <URL de l’hôte de votre Microsoft SharePoint locataire>.
    2. Cliquez sur Enregistrer.
      Pour plus d'informations, consultez Configurer le Recherche IA spoke.
      Remarque :
      Assurez-vous de créer un enregistrement de domaine de confiance pour chaque locataire, lorsqu’il existe plusieurs locataires.
Utilisateur d’ingestion SharePoint
  1. Accédez à la Connexions et informations d'identification > Alias de connexion et d'informations d'identification > Utilisateur d’ingestion SharePoint (sn_sp_con. Sharepoint_Ingest_User).
    1. Cliquez sur Nouveau dans Informations d’identification pour créer des informations d’identification d’authentification de base pour l’ingestion de contenu externe par AIS.
    2. Spécifiez le nom d’utilisateur et le mot de passe de l’utilisateur (sys_user) qui dispose ais_external_content rôle.
      Ingérer l’utilisateur
    3. Cliquez sur Envoyer.
      Pour plus d'informations, consultez Créer des alias pour plusieurs locataires.
    4. Configurez la connexion au serveur Recherche IA avant de passer aux étapes suivantes.
Entity View Action Mapper (EVAM) pour le portail ESC et Virtual Agent
  1. Accédez à la Mappeur d'actions de vue d'entité (EVAM) > Définitions EVAM.
    1. Sélectionnez Recherche du portail ESC et ouvrez les M2M de configuration de l’ensemble de configuration de vue EVAM (ou) sélectionnez Recherche d’agent virtuel et ouvrez les M2M de configuration de l’ensemble de configuration de vue EVAM.
    2. Ajoutez une source de données en sélectionnant Lier existant.
    3. Renseignez les champs du formulaire.
      Tableau 7. Formulaire de création de source de données de recherche (portail ESC et Virtual Agent)
      Champ Description
      Commande Valeur la plus basse de la liste.
      Ensemble de configuration de vue Microsoft SharePoint Rechercher un groupe
    4. Cliquez sur Envoyer.
    Pour plus d’informations sur la définition EVAM, reportez-vous aux sections Create an EVAM action definition et Create a multi-data source list display in Entity View Action Mapper.
Profil de recherche par défaut du portail ESC
  1. Accédez à la Recherche IA > Profils Search et ouvrez le profil de recherche par défaut du portail ESC.
    1. Accédez à Sources de recherche, cliquez sur Lier existant et ajoutez SharePoint comme source de recherche.

      Pour plus d'informations, consultez Create a search profile.

    2. Accédez à Mots vides et vérifiez l’état de l’enregistrement.
    3. Ouvrez l’enregistrement et cliquez sur Publier, si l’état n’est pas Publié.

      Pour plus d'informations, consultez Search profiles in AI Search.

    4. Accédez à Synonymes pour vérifier l’état de l’enregistrement.
    5. Ouvrez l’enregistrement et cliquez sur Publier, si l’état n’est pas Publié.

      Pour plus d'informations, consultez Synonyms.

    6. Accédez à l’onglet Sources de recherche .
    7. Sélectionnez SharePoint et ajoutez la condition et les critères de filtre parmi les options disponibles.

      En fonction de votre configuration, vos employés peuvent afficher le contenu filtré à partir Microsoft SharePoint des résultats de recherche.

  2. Cliquez sur Publier dans le profil de recherche pour publier le profil avec la nouvelle Microsoft SharePoint source de recherche.
Profil de recherche par défaut NowMobile
  1. Accédez aux profils Recherche IA et ouvrez le profil de recherche par défaut NowMobile.
    1. Dans l’onglet Sources de recherche, cliquez sur Lier existant.
      • Source de recherche : SharePoint
      • Application : globale
    2. Accédez à Mots vides et vérifiez l’état de l’enregistrement.
    3. Ouvrez l’enregistrement et cliquez sur Publier.
    4. Accédez à Synonymes et vérifiez l’état de l’enregistrement.
    5. Ouvrez l’enregistrement et cliquez sur Publier.
Rechercher des applications
  1. Accédez aux applications de recherche (sys_search_context_config).
    Mettez à jour les valeurs suivantes pour l’application de recherche par défaut de l’Agent virtuel
    • Moteur de recherche : AI Search.
    • Profil de recherche : profil de recherche par défaut du portail ESC. Cette valeur de champ dynamique est visible après que vous avez modifié la valeur du moteur de recherche .
    Pour plus d'informations, consultez Créer une configuration d’application de recherche pour.
Rechercher les post-traitements avec script
  1. Accédez à l’onglet Rechercher les post-traitements scriptés et cliquez sur Nouveau pour l’application de recherche par défaut du portail ESC.
    1. Spécifiez les informations suivantes.
      • Ordre : utilisez l’ordre de votre choix, par exemple 100 ou 200.
      • Rechercher le traitement avec script : script de connecteur SharePoint.
    2. Spécifiez les mêmes informations pour les configurations de recherche de l’application NowMobile.
    Pour plus d'informations, consultez Utilisation de post-traitements avec script de recherche dans les configurations d’application.
Configuration de l’élément M2M de la recherche globale
  1. Accédez à la configuration de l’élément M2M de la recherche globale (sys_sg_global_search_m2m_master_item) et créez les entrées suivantes : 
    Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Excel Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search File Main Item 
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search HTML Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Pages Main View
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search PDF Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search PPT Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Site Main Item
Application: SharePoint Search Connector

Global Search Configuration: Homepage Search - Catalog, Knowledge, People
Item Configuration: Sharepoint External Search Word Main Item
Application: SharePoint Search Connector

Résultats

Votre configuration est terminée.

Que faire ensuite

Valider la Microsoft SharePoint connexion afin d’écarter toute erreur de configuration avant l’indexation d’un site d’échantillon.

Valider la Microsoft SharePoint connexion

Exécutez une validation après avoir connecté votre ServiceNow instance à un Microsoft SharePoint locataire pour vérifier toute erreur dans la configuration.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

La validation exclut toute erreur de configuration et assure un processus de configuration sans faille.

Procédure

  1. Accédez à la Interface utilisateur du système > Pages de l'interface utilisateur > Utilitaire SharePoint.
  2. Sélectionnez Essayer pour accéder à la page de validation de la connexion SharePoint.
  3. Saisissez les informations requises et sélectionnez Valider.
    Les erreurs, le cas échéant, sont affichées dans la section Réponse.
  4. Vérifiez les liens de nom de table et corrigez les erreurs en fonction de la valeur actuelle et de la valeur attendue affichées dans la section Réponse.

    Si des informations sont manquantes, le champ Erreur affiche les données.

    S’il n’y a pas d’erreur, la section Réponse affiche une validation réussie.

Que faire ensuite

Indexez les sites pour la recherche. Pour plus d'informations, consultez Indexer les sites pour la recherche.