Doc produitsMenu

Configuration et indexation d'une source Active Directory

Une source définit un groupe de paramètres de connecteur qui spécifient où et comment analyser Active Directory dans un certain domaine. Le connecteur de Coveo pour Microsoft Active Directory utilise Lightweight Directory Access Protocol (LDAP) afin de lire le contenu d'Active Directory. Le connecteur effectue une recherche LDAP afin de retrouver tous les éléments à indexer.

Pour configurer et indexer une source Active Directory

  1. Dans le serveur Coveo, accédez à l'Outil d'administration (voir Ouverture de l'Outil d'administration).

  2. Sélectionnez Index > Sources et collections.

  3. Dans la section Collections :

    1. Sélectionnez une collection existante dans laquelle vous souhaitez ajouter la nouvelle source.

      OU

    2. Cliquez sur Ajouter pour créer une nouvelle collection (voir Ajout d'une collection).

  4. Dans la section Sources, cliquez sur Ajouter.

  5. Dans la section Paramètres généraux (General Settings) de la page Ajouter une source (Add Source) :

    1. Tapez la bonne valeur pour les paramètres obligatoires suivants :

      Nom (Name)

      Tapez un nom descriptif de votre choix pour la source du connecteur.

      Exemple : Active Directory Domain A

      Type de source

      Sélectionnez le connecteur utilisé par cette source. Dans ce cas, sélectionnez Active Directory.

      Adresses

      La liste d'URI LDAP qui indique les emplacements de départ à indexer, une entrée par ligne.

      Exemple : Avec le domaine domainA.MyOrganization.com, les valeurs acceptables peuvent être :
      • LDAP://MyOrganization

      • LDAP://domainA.MyOrganization.com

      • LDAP://DC=domainA,DC=MyOrganization,DC=com

      Si vous souhaitez ne sélectionner que les utilisateurs d'une unité d'organisation (OU) particulière, tapez l'adresse sous la forme : LDAP://OU=ouName,DC=domainA,DC=MyOrganization,DC=com

      Important : Dans les URL de LDAP, vous devez entrer les mots clés (LDAP, OU, DV...) en majuscules.

    2. Évaluez la valeur des paramètres suivants, qui, la plupart du temps, n'ont pas à être modifiés :

      Appréciation (Rating)

      Changez la valeur seulement si vous souhaitez changer globalement la cote associée à tous les éléments de cette source par rapport à la cote des éléments d'autres sources (voir Fonctionnement du classement des résultats de recherche).

      Types de document (Document Types)

      Si vous avez créé un groupe personnalisé de types de documents pour cette source, sélectionnez-le (voir Création d'un groupe de types de documents).

      Langues actives (Active Languages)

      Si vous avez défini des groupes personnalisés de langues actives, veillez à sélectionner celui qui convient le mieux à cette source (voir Ajout et configuration d'un groupe de langues).

      Champs (Fields)

      Si vous avez défini des groupes personnalisés de champs, veillez à sélectionner celui qui convient le mieux à cette source (voir Que sont les groupes de champs?).

      Horaire d'actualisation (Refresh Schedule)

      Intervalle de temps à laquelle l'index est automatiquement actualisé afin de garder le contenu de l'index à jour. Par défaut, l'option Chaque jour (Every day) recommandée force CES à actualiser la source chaque jour, à minuit.

      Note : Vous pouvez créer de nouveaux horaires d'actualisation de source ou modifier ceux qui existent (voir Création ou modification d'un horaire de source).

  6. Dans la section Paramètres et options spécifiques au connecteur (Specific Connector Parameters & Options) de la page Ajouter une source (Add Source) :

    1. Tapez la bonne valeur pour les paramètres suivants :

      Incremental Refresh Delay

      Détermine l'intervalle de temps, en secondes, entre les mises à jour d'actualisation incrémentale (voir À propos de l'actualisation incrémentale et de la surveillance en temps réel). La valeur par défaut et recommandée est 3600 secondes (1 heure).

      Filtres LDAP (LDAP Filters)

      Les filtres utilisés afin d'affiner la requête LDAP à Active Directory. Vous souhaitez habituellement analyser tous les utilisateurs dans Active Directory. Selon la configuration d'Active Directory, il est possible que les utilisateurs non désirés soient analysés. La valeur par défaut est mail=*. Ceci permet d'obtenir tous les utilisateurs qui ont également une boîte de réception Exchange.

      Note : Le connecteur contient un filtre intégré caché : (&(objectclass=user)(objectclass=person)). Ceci est une opération AND logique qui trouve des utilisateurs étant de véritables personnes, éliminant ainsi d'autres boîtes de réception. Le filtre que vous saisissez dans Filtres LDAP est ajouté à l'opération AND du filtre intégré caché (ex. : (&(objectclass=user)(objectclass=person)(mail=*)).

      Paramètres (Parameters)

      Cliquez sur Ajouter un paramètre (Add Parameter) si vous souhaitez afficher des paramètres de source avancés cachés.

    2. Dans la section Option, évaluez la valeur des paramètres suivants, qui, la plupart du temps, n'ont pas à être modifiés :

      Indexer les sous-dossiers (Index Subfolders)

      Cochez pour indexer tous les sous-dossiers sous les adresses de départ spécifiées. Sélectionné par défaut.

      Indexer les métadonnées des documents (Index the document's metadata)

      Lorsque sélectionné, CES indexe toutes les métadonnées du document, mêmes celles qui ne sont pas associées à un champ. Les métadonnées orphelines sont ajoutées au body du document afin qu'elles puissent être recherchées à l'aide de requêtes en texte libre.

      Lorsque non-coché (par défaut), seules les valeurs de champs système et personnalisés dont l'attribut Requêtes textuelles est sélectionné pourront être recherchées sans l'aide d'une requête de champ (voir Ajout d'un champ à utiliser pour la recherche et Que sont les requêtes par champs et les requêtes en texte libre?).

      Exemple : Un document contient deux métadonnées :

      • LastEditedBy, renfermant la valeur Hector Smith

      • Department, renfermant la valeur RH

      Dans CES, le champ personnalisé CorpDepartment est lié à la métadonnée Department, et son attribut Free Text Queries est sélectionné.

      Si l'option Indexer les métadonnées des documents n'est pas cochée, rechercher RH retourne le document, car un champ indexe cette valeur. Rechercher hector ne retourne pas le document, car aucun champ n'indexe cette valeur.

      Si l'option Indexer les métadonnées des documents est sélectionnée, rechercher hector retourne également le document, car CES a indexé les métadonnées orphelines.

      Les adresses de document sont sensibles à la casse (Document's addresses are case-sensitive)

      Laissez la case décochée. Ce paramètre doit être coché seulement, dans de rares situations, pour les systèmes sensibles à la casse dans lesquels des documents distincts peuvent avoir le même nom de fichier, mais une casse différente.

      Générer une version HTML en cache des documents indexés (Generate a cached HTML version of indexed documents)

      Si vous cochez cette case (recommandé), en temps d'indexation, CES crée des versions HTML des documents indexés et les enregistre dans l'index unifié. Dans les interfaces de recherche, les utilisateurs peuvent alors évaluer plus rapidement le contenu en cliquant sur le lien Aperçu rapide pour ouvrir la version HTML de l'élément plutôt qu'en ouvrant le document d’origine avec l'application originale.

      Vous devriez décocher ces cases seulement si vous ne souhaitez pas utiliser les liens Aperçu rapide ou enregistrer des ressources pendant la génération de la source.

      Ouvrir les résultats avec la version cache (Open results with cached version)

      Laissez cette case décochée (recommandé) afin que, dans les interfaces de recherche, le lien principal de résultats de recherche ouvre le document d'origine avec l'application originale. Vous devriez cocher cette case seulement si vous ne souhaitez pas que les utilisateurs puissent ouvrir le document original, mais qu'ils ne voient que la version HTML du document en tant qu'Aperçu rapide. Si cette option est sélectionnée, vous devez également cocher Générer une version HTML en cache des documents indexés.

  7. Dans la section Sécurité (Security) de la page Ajouter une source :

    1. Dans la liste déroulante Fournisseur de sécurité (Security Provider), sélectionnez le fournisseur de sécurité Active Directory par défaut, modifié ou nouveau que vous souhaitez appliquer à cette source (voir Configuration d'un fournisseur de sécurité Active Directory).

    2. Dans la liste déroulante Authentification (Authentication), sélectionnez l'identité d'utilisateur que vous avez sélectionnée pour cette source (voir Ajout d'une identité d'utilisateur).

    3. Cliquez sur Enregistrer et activer (Save and Start) pour sauvegarder la configuration de la source et débuter l'indexation de cette source.

  8. Confirmez que le processus de génération de la source est exécuté sans erreur :

    • Dans le panneau de navigation situé à gauche, cliquez sur État, puis confirmez que l'indexation se fait sans erreur.

      OU

    • Ouvrez la console CES afin de surveiller les activités de génération de la source (voir Utilisation de la Console CES.

Prochaines étapes?

Définissez un horaire d'actualisation incrémentale pour votre source (voir Planification d'une actualisation incrémentale de source).

Ajoutez la collection renfermant cette nouvelle source à la portée des interfaces de recherche désirées (voir Configuration de la portée d'une interface de recherche).