Étape 3 : déployer le composant WebPart personnalisé

Notes

Cette rubrique décrit la fonctionnalité qui fait partie de la Infrastructure Update for Microsoft Office Servers. Pour télécharger la mise à jour, voir Description de la mise à jour d'infrastructure SharePoint Server 2007 : 15 juillet 2008.

L'étape 3 décrit comment déployer et inscrire le composant WebPart de recherche fédérée personnalisée. Elle traite également d'un problème de sécurité que vous devez envisager avant de déployer le composant WebPart.

L'exemple de composant WebPart décrit dans cette procédure pas à pas fonctionne pour les emplacements fédérés configurés pour utiliser les types suivants d'authentification par utilisateur :

• Authentification de base

• Authentification Digest

• Authentification NTLM

Voici les étapes de base pour déployer le projet :

• Donnez un nom fort à l'assembly CustomFederatedResultsSample, puis créez-le.

• Installez l'assembly CustomFederatedResultsSample dans le Global Assembly Cache.

• Créez un fichier .dwp pour le composant WebPart CustomFederatedResultsSample.

• Inscrivez le composant WebPart CustomFederatedResultsSample en tant que contrôle sécurisé.

• Ajoutez le composant WebPart CustomFederatedResultsSample à la page des résultats de recherche.

Vous pouvez télécharger le code complet de l'exemple de composant WebPart personnalisé Résultats de la recherche fédérée dans l'onglet Version (en anglais)dans la page de ressources Exemples de recherches du Kit de développement logiciel (SDK) Microsoft Office SharePoint Server 2007 (en anglais) de la de la bibliothèque de code MSDN (en anglais).

Aspects relatifs à la sécurité

L'exemple de composant WebPart personnalisé de recherche fédérée fournit une interface utilisateur pour entrer des informations d'identification et les envoyer au serveur. Lorsque l'utilisateur clique sur le bouton Ouverture de session, les informations d'identification sont passées en texte clair au serveur dans la demande. Dans ce scénario, nous recommandons d'utiliser SSL (Secure Sockets Layer) pour sécuriser les communications entre le navigateur client et le serveur Web.

Après avoir reçu les informations d'identification, l'exemple de composant WebPart chiffre les valeurs et les stocke dans des cookies, qui sont passés entre le navigateur client et le serveur Web pour chaque demande ultérieure. De ce fait, vous devez configurer SSL pour le site et non seulement pour l'ouverture de session initiale.

Pour utiliser des connexions SSL sur votre serveur Web, vous devez configurer le serveur à l'aide d'un certificat provenant d'une autorité de certification reconnue. Pour plus d'informations sur les certificats du serveur, voir Obtention de certificats pour les serveurs.

Pour plus d'informations sur la configuration de SSL, voir les ressources suivantes :

• Planifier les communications sécurisées dans une batterie de serveurs (Office SharePoint Server)

• Créer une application Web (en anglais)

• Planifier les méthodes d'authentification (Office SharePoint Server)

• Procédure : configurer SSL sur un serveur Web

• Configuration de SSL sur un serveur Web ou un site Web

Procédures

Donner un nom fort à l'assembly et le créer

1. Le projet CustomFederatedResultsSample étant ouvert dans Microsoft Visual Studio 2008, dans le menu Projet, cliquez sur Propriétés CustomFederatedResultsSample.

2. Dans l'onglet Signature, activez la case Signer l'assembly.

3. Dans la liste Choisir un fichier de clé de nom fort, cliquez sur Nouveau.

4. Dans la boîte de dialogue Créer une clé de nom fort, pour Nom du fichier de clé, tapez un nom pour votre fichier de clé, puis cliquez sur OK. Si vous avez un fichier de clé existant à utiliser, sélectionnez Parcourir au lieu de Nouveau pour cette étape et recherchez le fichier existant.

5. Dans le menu Générer, cliquez sur Générer la solution.

Pour plus d'informations sur cette tâche, voir How to: Sign an Assembly (Visual Studio). Vous pouvez également utiliser Assembly Linker (AI.exe), disponible dans le Kit de développement logiciel (SDK) Microsoft .NET Framework, pour signer l'assembly avec un nom fort décrit dans How to: Sign an Assembly with a Strong Name. Pour plus d'informations sur les assemblys avec nom fort, voir Creating and Using Strong-Named Assemblies et Strong-Name Signing for Managed Applications.

Après avoir signé votre assembly avec un nom fort, vous pouvez l'installer dans le global assembly cache. Pour plus d'informations, voir How to: Install an Assembly into the Global Assembly Cache.

La procédure ci-dessous décrit l'installation de la DLL dans le Global Assembly Cache à l'aide de l'utilitaire de ligne de commande gacutil.exe . Cet utilitaire est fourni dans le Kit de développement logiciel (SDK) Microsoft .NET Framework. Pour plus d'informations, voir les articles Global Assembly Cache Tool (Gacutil.exe) et .NET Framework Tools.

Installer l'assembly dans le Global Assembly Cache.

1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Microsoft .NET Framework SDK v2.0, puis cliquez sur SDK Command Prompt.

2. À l'invite de commandes du SDK, tapez la commande suivante :

   gacutil /if Path to Assembly\CustomFederatedResultsSample.dll 
   

   Remplacez Path to Assembly par le chemin d'accès à votre DLL.

   Notes

   Lorsque vous utilisez le commutateur /if , l'outil remplace la version précédente de l'assembly par la nouvelle version que vous installez dans le Global Assembly Cache.

Vous devez également obtenir la valeur du jeton de clé publique de l'assembly.

Obtenir la valeur du jeton de clé publique

1. Dans l'Explorateur Windows, recherchez CustomFederatedResultsSample.dll dans le chemin d'accès Disque_local:\WINDOWS\assembly\.

2. Cliquez avec le bouton droit sur l'assembly, puis cliquez sur Propriétés.

3. Dans la boîte de dialogue Propriétés, dans l'onglet Général, sélectionnez le jeton et copiez-le.

Vous pouvez alors créer le fichier .DWP du composant WebPart CustomFederatedResultsSample. Ce fichier XML décrit le composant WebPart : vous l'utilisez pour importer le composant WebPart dans la galerie de composants WebPart.

Créer le fichier .dwp

1. Ouvrez un nouveau fichier dans un éditeur de texte (ex. Bloc-notes) et ajoutez le code XML suivant à ce fichier :

   <?xml version="1.0"?>
   <WebPart xmlns="https://schemas.microsoft.com/WebPart/v2">
       <Assembly>CustomFederatedResultsSample, Version=1.0.0.0, Culture=Neutral, PublicKeyToken=PublicKeyTokenForYourWebPart</Assembly>
          <TypeName>CustomFederatedResultsSample.PerUserAuthWebPart</TypeName>
       <Title>Per User Authentication Federated Results</Title>
   </WebPart>
   

2. Remplacez PublicKeyTokenForYourWebPartAssembly par la valeur du jeton de clé publique réelle de l'assembly de votre composant WebPart.

3. Nommez le fichier CustomFederatedResultsSample.dwp, puis enregistrez-le.

Inscrire le composant WebPart comme contrôle sécurisé

1. Ouvrez le fichier web.config du site auquel vous souhaitez ajouter le composant WebPart. Ce fichier se trouve dans le dossier racine du site. Pour plus d'informations à propos de la recherche du fichier web.config de votre site, voir Utiliser des fichiers Web.config et Procédure : rechercher la racine de votre application Web dans le Kit de développement logiciel (SDK) Windows SharePoint Services 3.0.

2. Ajoutez l'élément SafeControl à la section SafeControls du fichier web.config.

   <SafeControl 
       Assembly="CustomFederatedResultsSample, 
       Version=1.0.0.0, 
       Culture=neutral,
       PublicKeyToken=PublicKeyTokenForYourWebPart" 
       Namespace="CustomFederatedResultsSample" 
       TypeName="*" 
       Safe="True"
    />
   

3. Remplacez PublicKeyTokenForYourWebPartAssembly par la valeur du jeton de clé publique réelle de l'assembly de votre composant WebPart.

4. Enregistrez vos modifications, puis fermez le fichier web.config.

5. Réinitialisez Internet Information Services (IIS). À l'invite de commandes, tapez iisreset.

Ajouter le composant WebPart à la page des résultats de recherche

1. Ouvrez le site Centre de recherche dans votre navigateur, cliquez sur Actions du site, puis sur Modifier la page.

2. Cliquez sur Ajouter un composant WebPart dans la zone à droite.

3. Dans la boîte de dialogue Ajouter des composants WebPart, cliquez sur Galerie et options des composants WebPart avancés.

4. Cliquez sur Parcourir, puis sur Importer.

5. Cliquez sur Parcourir, recherchez l'endroit où vous avez enregistré le fichier CustomFederatedResultsSample.dwp, sélectionnez-le, puis cliquez sur Ouvrir.

   Vous devez alors voir les Résultats fédérés de l'authentification par utilisateur dans la boîte de dialogue. Vous pouvez le faire glisser dans la page pour l'utiliser.

6. Dans Résultats fédérés de l'authentification par utilisateur, cliquez sur la flèche vers le bas pour afficher le menu du composant WebPart ; cliquez ensuite sur Modifier le composant WebPart partagé.

7. Dans Propriétés de l'emplacement, dans la liste Emplacement, sélectionnez le nom d'un emplacement fédéré que vous avez configuré pour utiliser l'authentification NTLM, l'authentification de base ou l'authentification Digest.

8. Cliquez sur OK.

9. Cliquez sur Actions du site, puis sur Quitter le mode Edition pour fermer la page de modification.

Voir aussi

Référence

FormsCredentials
FederatedResultsWebPart
FederatedResultsDatasource
FederatedResultsDatasourceView
SearchResultsBaseWebPart
SearchResultsBaseDatasource
SearchResultsBaseDatasourceView

Autres ressources

Étape 1 : configurer le projet pour le composant WebPart personnalisé
Étape 2 : ajouter le code pour le composant WebPart personnalisé
Création d'un composant WebPart personnalisé de recherche fédérée avec une interface utilisateur informations d'identification
Vue d'ensemble de la recherche fédérée