Modules IIS avec ASP.NET Core

Certains des modules IIS natifs et tous les modules managés IIS ne peuvent pas traiter les requêtes liées aux applications ASP.NET Core. Dans de nombreux cas, ASP.NET Core offre une alternative aux scénarios traités par les modules natifs et managés IIS.

Modules natifs

Le tableau indique les modules IIS natifs qui fonctionnent avec les applications ASP.NET Core et le module ASP.NET Core.

†Les types de correspondance isFile et isDirectory du module de réécriture d’URL ne fonctionnent pas avec les applications ASP.NET Core en raison des modifications apportées à la structure de répertoires.

Modules managés

Les modules managés ne sont pas opérationnels avec les applications ASP.NET Core hébergées quand la version CLR .NET du pool d’applications est définie sur Aucun code managé. ASP.NET Core offre des alternatives de middleware dans plusieurs cas.

Modification de l’application avec le Gestionnaire IIS

Quand vous utilisez le Gestionnaire IIS pour configurer les paramètres, le fichier web.config de l’application est modifié. Si vous déployez une application et que vous incluez web.config, toutes les modifications apportées avec le Gestionnaire IIS sont remplacées par le fichier web.config déployé. Si des modifications sont apportées au fichier web.config du serveur, copiez le fichier web.config mis à jour sur le serveur dans le projet local immédiatement.

Désactivation des modules IIS

Si un module IIS configuré au niveau du serveur doit être désactivé pour une application, un ajout au fichier web.config de l’application peut désactiver le module. Conservez le module en place et désactivez-le à l’aide d’un paramètre de configuration (si disponible) ou supprimez le module de l’application.

Désactivation du module

De nombreux modules disposent d’un paramètre de configuration qui vous permet de les désactiver sans les supprimer de l’application. Il s’agit de la façon la plus simple et plus rapide pour désactiver un module. Par exemple, le module de redirection HTTP peut être désactivé avec l’élément <httpRedirect> dans web.config :

<configuration>
  <system.webServer>
    <httpRedirect enabled="false" />
  </system.webServer>
</configuration>

Pour plus d’informations sur la désactivation de modules avec des paramètres de configuration, suivez les liens dans la section Éléments enfants de la page IIS <system.webServer>.

Suppression de module

Si vous décidez de supprimer un module avec un paramètre dans web.config, déverrouillez le module et déverrouillez la section <modules> de web.config en premier :

1. Déverrouillez le module au niveau du serveur. Sélectionnez le serveur IIS dans la barre latérale Connexions du Gestionnaire IIS. Ouvrez les Modules dans la zone IIS. Sélectionnez le module dans la liste. Dans la barre latérale Actions à droite, sélectionnez Déverrouiller. Si l’entrée d’action du module indique Verrouiller, cela signifie que le module est déjà déverrouillé et qu’aucune action n’est nécessaire. Déverrouillez tous les modules que vous envisagez de supprimer de web.config.

2. Déployez l’application sans section <modules> dans web.config. Si une application est déployée avec un fichier web.config contenant la section <modules> et que celle-ci n’a pas été préalablement déverrouillée dans le Gestionnaire IIS, Configuration Manager lève une exception au moment du déverrouillage de la section. Vous devez donc déployer l’application sans section <modules>.

3. Déverrouillez la section <modules> de web.config. Dans la barre latérale Connexions, sélectionnez le site web dans Sites. Dans la zone Gestion, ouvrez l’Éditeur de configuration. Utilisez les contrôles de navigation pour sélectionner la section system.webServer/modules. Dans la barre latérale Actions à droite, sélectionnez l’option permettant de Déverrouiller la section. Si l’entrée d’action de la section du module indique Verrouiller la section, cela signifie que le module est déjà déverrouillé et qu’aucune action n’est nécessaire.

4. Ajoutez une section <modules> au fichier web.config local de l’application avec un élément <remove> pour supprimer le module de l’application. Ajoutez plusieurs éléments <remove> pour supprimer plusieurs modules. Si des modifications sont apportées au fichier web.config sur le serveur, effectuez immédiatement les mêmes modifications dans le fichier web.config du projet localement. La suppression d’un module à l’aide de cette approche n’affecte pas l’utilisation du module avec d’autres applications sur le serveur.

   <configuration>
    <system.webServer>
      <modules>
        <remove name="MODULE_NAME" />
      </modules>
    </system.webServer>
   </configuration>
   

Pour ajouter ou supprimer des modules pour IIS Express à l’aide de web.config, modifiez applicationHost.config afin de déverrouiller la section <modules> :

1. Ouvrez {RACINE DE L’APPLICATION}.vs\config\applicationhost.config.

2. Recherchez l’élément <section> des modules IIS et changez overrideModeDefault en remplaçant Deny par Allow :

   <section name="modules"
            allowDefinition="MachineToApplication"
            overrideModeDefault="Allow" />
   

3. Recherchez la section <location path="" overrideMode="Allow"><system.webServer><modules>. Pour tous les modules à supprimer, définissez lockItem en remplaçant true par false. Dans l’exemple suivant, le module CGI est déverrouillé :

   <add name="CgiModule" lockItem="false" />
   

4. Une fois que la section <modules> et les modules individuels sont déverrouillés, vous pouvez ajouter ou supprimer des modules IIS à l’aide du fichier web.config de l’application pour permettre l’exécution de l’application sur IIS Express.

Vous pouvez également supprimer un module IIS avec Appcmd.exe. Fournissez MODULE_NAME et APPLICATION_NAME dans la commande :

Appcmd.exe delete module MODULE_NAME /app.name:APPLICATION_NAME

Par exemple, supprimez DynamicCompressionModule du site web par défaut :

%windir%\system32\inetsrv\appcmd.exe delete module DynamicCompressionModule /app.name:"Default Web Site"

Configuration minimale des modules

Les seuls modules requis pour exécuter une application ASP.NET Core sont le module d’authentification anonyme et le module ASP.NET Core.

Le module de mise en cache d’URI (UriCacheModule) permet à IIS de mettre en cache la configuration du site web au niveau de l’URL. Sans ce module, IIS doit lire et analyser la configuration à chaque requête, même quand la même URL est demandée à plusieurs reprises. L’analyse de la configuration à chaque requête entraîne une baisse significative des performances. Bien que le module de mise en cache d’URI ne soit pas absolument nécessaire à l’exécution d’une application ASP.NET Core hébergée, nous vous recommandons de l’activer pour tous les déploiements ASP.NET Core.

Le module de mise en cache HTTP (HttpCacheModule) implémente le cache de sortie IIS, ainsi que la logique de mise en cache des éléments dans le cache HTTP.sys. Sans ce module, le contenu n’est plus mis en cache en mode noyau, et les profils de cache sont ignorés. En règle générale, la suppression du module de mise en cache HTTP a des effets négatifs sur les performances et l’utilisation des ressources. Bien que le module de mise en cache HTTP ne soit pas absolument nécessaire à l’exécution d’une application ASP.NET Core hébergée, nous vous recommandons de l’activer pour tous les déploiements ASP.NET Core.

Ressources supplémentaires

• Présentation des architectures IIS : modules dans IIS
• Vue d’ensemble des modules IIS
• Customizing IIS 7.0 Roles and Modules (Personnalisation des rôles et des modules dans IIS 7.0)
• IIS <system.webServer>