Comment ça marche

La solution d'authentification unique de Coveo utilise des redirections de navigateur identiques à ce que Windows Identity Foundation fait pour authentifier les utilisateurs avec des applications web prenant en charge Claims :

• Un utilisateur accède à l'interface de recherche Coveo .NET avec un navigateur.

• Si le cookie SharePoint Claims de Coveo n'est pas disponible ou est expiré, l'app web de l'interface de recherche Coveo redirige le navigateur vers une page web spécifique déployée par Coveo, dans le serveur SharePoint.

• Cette page web SharePoint utilise NTLM ou Kerberos afin qu'elle puisse récupérer les identités Claims complètes de l'utilisateur ou, autrement, invite l'utilisateur à se connecter à SharePoint.

• La page web SharePoint chiffre, met en boîte et renvoie Claims à l'app web de l'interface de recherche Coveo.

• L'app web de l'interface de recherche Coveo reçoit le colis Claims de l'utilisateur, crée le cookie, et recharge la page de l'interface de recherche Coveo.

• L'utilisateur a maintenant les identités Claims complètes pour effectuer ses requêtes.

• L'aller-retour peut être remarqué ou non, selon votre environnement.

Exigences

• SharePoint 2013/2010 sur place

• Application web du serveur SharePoint configurée dans Windows Claims (NTLM ou Kerberos)

• Version 12.0.614+ de Coveo .NET Front-End (février 2014)

Configuration du serveur SharePoint

1. À l'aide d'un compte d'administrateur, connectez-vous au système opérationnel de votre serveur d'interface SharePoint.

2. Si ce n'est pas déjà fait, déployez l'intégration Coveo dans votre application web SharePoint afin de veiller à ce qu'au moins l'option Service Web SharePoint soit installée (voir Installation du service Web Coveo, de la boîte de recherche et de l'interface de recherche dans SharePoint).

3. Dans le premier serveur d'interface de votre batterie SharePoint, créez deux fichiers vides qui seront remplis avec les clés de signature des communications privées et publiques.

   Note : Les clés privées et publiques sont générées par le serveur d'interface à la première installation. Vous pouvez facilement régénérer de nouvelles clés en supprimant tout simplement les fichiers de clés originaux et en recréant ces deux fichiers vides.

   Dans d'autres serveurs d'interface de votre batterie SharePoint, collez plutôt une copie de ces fichiers remplis (ne copiez pas les fichiers vides) pour veiller à ce que tous les serveurs d'interface utilisent les mêmes fichiers de clés privées et publiques.

   Exemple : Les fichiers pourraient être :

   • C:\Program Files\Coveo .NET Front-End 12\Web\ClaimsAuthenticationKeys\ClaimsAuthenticationPublicKey.bin

   • C:\Program Files\Coveo .NET Front-End 12\Web\ClaimsAuthenticationKeys\ClaimsAuthenticationPrivateKey.bin

   Important : Protégez votre fichier de clé publique une fois qu'il est créé. Ce fichier ne devrait jamais être partagé ou envoyé par courriel. Toute personne ayant accès à cette clé peut l'utiliser pour créer son propre Claims et être en mesure d'avoir accès à tous les documents SharePoint de CES.

4. Cliquez, avec le bouton droit de la souris, sur le dossier du fichier de clé, puis utilisez ses Propriétés pour veiller à ce que l'identité du pool d'applications qui exécute l'application web où Coveo est intégré ait des accès en lecture et en écriture aux fichiers de clés.

5. À l'aide d'un éditeur de texte :

   1. Ouvrez le fichier web.config du site de l'application web SharePoint.

      Exemple : Le fichier est, typiquement :

      C:\inetpub\wwwroot\wss\VirtualDirectories\12345\web.config

   2. Sous coveoEnterpriseSearch, si elle n'est pas déjà présente, ajoutez une section claimsAuthentication, veillez à ce qu'elle contienne les attributs suivants, puis mettez à jour les valeurs des attributs selon votre installation :

      • identityReceiverUrl="https://YourCoveoFrontEnd/ClaimsIdentityReceiver.aspx"

      • identityProviderPrivateKeyPath="PathToPrivateKey"

      • identityProviderPublicKeyPath="PathToPublicKey"

      Exemple : La section claimsAuthentication ressemble à :

      <claimsAuthentication identityReceiverUrl="https://YourCoveoFrontEnd/ClaimsIdentityReceiver.aspx" identityProviderPrivateKeyPath="C:\Program Files\Coveo .NET Front-End 12\Web\ClaimsAuthenticationKeys\ClaimsAuthenticationPrivateKey.bin" identityProviderPublicKeyPath="C:\Program Files\Coveo .NET Front-End 12\Web\ClaimsAuthenticationKeys\ClaimsAuthenticationPublicKey.bin" />

   3. Si plus d'un serveur d'interface Coveo unique utilise cette application web SharePoint en tant que fournisseur d'identité, ou si le serveur d'interface Coveo unique peut être atteint à partir de plusieurs URL, dans la sous-section <identityReceivers>, configurez chacun pour leur permettre de retrouver le cookie.

      Exemple :

      <claimsAuthentication identityReceiverUrl="https://DefaultCoveoFrontEnd/ClaimsIdentityReceiver.aspx" identityProviderPrivateKeyPath="PathToPrivateKey" identityProviderPublicKeyPath="PathToPublicKey">
        <identityReceivers>
          <add domain="CoveoFrontEnd1" url="https://CoveoFrontEnd1/ClaimsIdentityReceiver.aspx" />
          <add domain="CoveoFrontEnd1DifferentUrl" url="https://CoveoFrontEnd1DifferentUrl/ClaimsIdentityReceiver.aspx" />
          <add domain="CoveoFrontEnd2" url="https://CoveoFrontEnd2/ClaimsIdentityReceiver.aspx" />
        </identityReceivers>
      </claimsAuthentication>

      Notes :

      • Coveo .NET Front-End 12.0.777+ (mai 2014) Soutien de la sous-section <identityProviders>.

      • Vous devriez également laisser une URL de réception de l'identité dans la section <claimsAuthentication>, qui sera utilisée si l'utilisateur provient d'un autre domaine.

   4. Enregistrez le fichier.

6. À l'aide d'un navigateur, accédez à l'URL sous la forme suivante pour faire l'essai de votre installation :

   https://YourSharePointSite/_layouts/CES/ClaimsIdentityProvider.aspx?debug=1

   Vous devriez voir une page web qui contient diverses informations sur Claims. Vous ne devriez pas voir d'erreurs. Les fichiers de clés privées et publiques devraient maintenant être remplis avec les nouvelles données des clés.

7. Ici, si vous le souhaitez, vous pouvez retirer l'accès en écriture de l'identité du pool d'applications web vers le chemin d'accès des fichiers de clés.

Configuration du serveur Coveo .NET Front-End

1. À l'aide d'un compte d'administrateur, connectez-vous au système opérationnel de votre serveur Coveo .NET Front-End.

2. Copiez le fichier de clé publique créé dans votre serveur d'interface SharePoint et collez-le dans le serveur d'interface Coveo.

   Exemple : Dans le serveur Coveo .NET Front-End, vous pouvez copier le fichier dans :

   C:\Program Files\Coveo .NET Front-End 12\Web\ClaimsAuthenticationKeys\ClaimsAuthenticationPublicKey.bin

   Note : Le fichier de clé publique n'a pas à être sécurisé comme le fichier de clé privée. Il peut être partagé de façon sécuritaire dans un partage de fichiers ou envoyé par courriel.

3. À l'aide d'un éditeur de texte :

   1. Ouvrez le fichier web.config de Coveo .NET Front-End.

      Exemple : Le fichier est, typiquement :

      C:\Program Files\Coveo .NET Front-End 12\Web\Web.config

   2. Sous coveoEnterpriseSearch, si elle n'est pas déjà présente, ajoutez une section claimsAuthentication, veillez à ce qu'elle contienne les attributs suivants, puis mettez à jour les valeurs des attributs selon votre installation :

      • identityProviderUrl="https://YourSharePointSite/_layouts/CES/ClaimsIdentityProvider.aspx"

      • identityValidatorPublicKeyPath="PathToPublicKey"

      Exemple : La section claimsAuthentication ressemble à :

      <claimsAuthentication identityProviderUrl="https://YourSharePointSite/_layouts/CES/ClaimsIdentityProvider.aspx" identityValidatorPublicKeyPath="C:\Program Files\Coveo .NET Front-End 12\Web\ClaimsAuthenticationKeys\ClaimsAuthenticationPublicKey.bin" />

   3. S'il n'est pas déjà présent, comme affiché dans l'extrait de fichier suivant, ajoutez l'espace de nom Coveo.CES.Web.Search.Security.

      <configuration>
        <system.web>
          <pages>
            <namespaces>
              ...
              <add namespace="Coveo.CES.Web.Search.Security" />
              ...
            </namespaces>
          </pages>
        </system.web>
      </configuration>

      Note : CES 7.0.6339– (janvier 2014) Vous avez besoin d'au moins deux mises à jour de CES subséquentes à CES 7.0.6424 (février 2014) ou d'une nouvelle installation de Coveo .NET Front-End pour voir l'espace de nom Coveo.CES.Web.Search.Security.

   4. Enregistrez le fichier.

4. À l'aide d'un navigateur, accédez à votre interface de recherche Coveo à l'aide du véritable nom d'hôte du serveur, pas localhost.

   Exemple : L'URL de la page de l'interface de recherche Coveo .NET est, habituellement :

   https://YourCoveoFrontEndServer/

   La première fois que vous accédez à l'interface de recherche avec un certain navigateur, un cookie de sécurité est créé (voir Comment ça marche).

   Note : Si votre serveur SharePoint est configuré afin de demander un mot de passe aux utilisateurs, l'utilisateur devra taper son mot de passe SharePoint.

5. Effectuez la première installation pour configurer Coveo .NET Front-End (voir Première installation de Coveo .NET Front-End).

6. Dans l'interface de recherche Coveo, vérifiez si vous avez accès à tous vos documents SharePoint sécurisés. Si la portée de l'interface de recherche contient du contenu qui n'appartient pas à SharePoint, vérifiez également si vous avez accès à ce contenu.