Installation des filtres ISAPI

Comme les extensions ISAPI, les filtres ISAPI sont des programmes qui répondent lorsque le serveur Web reçoit une requête HTTP. Ils sont différents des applications dans le sens où ils sont pilotés par les événements du serveur Web, plutôt que par une demande du client. Vous pouvez associer un filtre ISAPI à un événement de serveur Web particulier. Le filtre est ensuite notifié chaque fois que l'événement qui lui est associé se produit. Ainsi, un filtre peut être notifié lorsqu'un événement Lire ou Écrire se produit, après quoi il peut crypter les données brutes qui doivent être renvoyées au client.

Vous pouvez installer des filtres pour tous les sites d'un serveur (filtres globaux) ainsi que pour des sites Web individuels. Si vous installez à la fois des filtres globaux et des filtres de site, les deux listes de filtres sont fusionnées pour le site en question.

Lorsque plusieurs filtres sont inscrits pour le même événement, ils sont appelés de façon séquentielle. Les filtres présentant une priorité plus élevée sont exécutés avant ceux qui ont une priorité plus faible. Si plusieurs filtres ont la même priorité, les filtres globaux définis dans les propriétés principales sont exécutés avant les filtres définis au niveau du site. Les filtres présentant la même priorité et le même niveau d'héritage sont exécutés en fonction de leur ordre de chargement. Vous pouvez modifier l'ordre de chargement des filtres dans les feuilles de propriétés du serveur ou du site Web.

Contrairement aux extensions ISAPI, les filtres ISAPI sont toujours exécutés dans le processus serveur.

Pour ajouter un filtre à un serveur ou un site Web

Dans le composant logiciel enfichable Services Internet (IIS), sélectionnez le serveur Web ou le site Web et ouvrez ses feuilles de propriétés.
Cliquez sur l'onglet Filtres ISAPI.

Remarque Si vous ajoutez des filtres à un site Web, les filtres globaux hérités des propriétés principales du serveur Web n'apparaissent pas. Seuls apparaissent les filtres installés pour le site Web, même si ces deux types de filtres sont exécutés.

Cliquez sur le bouton Ajouter.
Tapez le nom du filtre dans la zone Nom du filtre et tapez ou recherchez le fichier DLL dans la zone Exécutable.
Cliquez sur OK.
Pour modifier l'ordre de chargement d'un filtre, utilisez les flèches.

Remarque Vous pouvez modifier uniquement l'ordre de chargement des filtres de priorité identique.

Si vous avez ajouté ou modifié un filtre global, vous devez arrêter, puis redémarrer le serveur Web pour charger le nouveau filtre dans la mémoire. Un filtre ajouté au niveau du site Web est automatiquement chargé lors de son ajout.

Remarque Si une requête HTTP déclenche un événement pour lequel le filtre est enregistré, ce dernier reçoit les données contenues dans la requête, que celle-ci porte sur un fichier, une application CGI ou une extension ISAPI.