IIS-Module mit ASP.NET Core

Einige der nativen IIS-Module und sämtliche der IIS-verwalteten Module sind nicht in der Lage, Anforderungen für ASP.NET Core-Apps zu verarbeiten. In vielen Fällen bietet ASP.NET Core eine Alternative zu den Szenarien, die von nativen und verwalteten IIS-Modulen abgedeckt werden.

Native Module

Die Tabelle enthält native IIS-Module, die mit ASP.NET Core-Apps und dem ASP.NET Core-Modul funktionieren.

Modul Funktionsfähig mit ASP.NET Core-Apps ASP.NET Core-Option
Anonyme Authentifizierung
AnonymousAuthenticationModule
Ja
Standardauthentifizierung
BasicAuthenticationModule
Ja
Authentifizierung durch Clientzertifikatszuordnung
CertificateMappingAuthenticationModule
Ja
CGI
CgiModule
Nein
Konfigurationsvalidierung
ConfigurationValidationModule
Ja
HTTP-Fehler
CustomErrorModule
Nein Middleware für Statuscodeseiten
Benutzerdefinierte Protokollierung
CustomLoggingModule
Ja
Standarddokument
DefaultDocumentModule
Nein Middleware für Standarddateien
Hashwertauthentifizierung
DigestAuthenticationModule
Ja
Verzeichnissuche
DirectoryListingModule
Nein Middleware für Verzeichnissuche
Dynamische Komprimierung
DynamicCompressionModule
Ja Antworten komprimierende Middleware
Ablaufverfolgung für Anforderungsfehler
FailedRequestsTracingModule
Ja ASP.NET Core-Protokollierung
Dateizwischenspeicherung
FileCacheModule
Nein Antworten zwischenspeichernde Middleware
HTTP-Zwischenspeicherung
HttpCacheModule
Nein Antworten zwischenspeichernde Middleware
HTTP-Protokollierung
HttpLoggingModule
Ja ASP.NET Core-Protokollierung
HTTP-Umleitung
HttpRedirectionModule
Ja URL-umschreibende Middleware
HTTP-Ablaufverfolgung
TracingModule
Ja
Authentifizierung durch IIS-Clientzertifikatszuordnung
IISCertificateMappingAuthenticationModule
Ja
IP- und Domäneneinschränkungen
IpRestrictionModule
Ja
ISAPI-Filter
IsapiFilterModule
Ja Middleware
ISAPI
IsapiModule
Ja Middleware
Protokollunterstützung
ProtocolSupportModule
Ja
Anforderungsfilterung
RequestFilteringModule
Ja URL-umschreibende MiddlewareIRule
Anforderungsüberwachung
RequestMonitorModule
Ja
URL-Umschreibung
RewriteModule
Ja URL-umschreibende Middleware
Serverseitige Includedateien
ServerSideIncludeModule
Nein
Statische Komprimierung
StaticCompressionModule
Nein Antworten komprimierende Middleware
Statischer Inhalt
StaticFileModule
Nein Middleware für statische Dateien
Token-Zwischenspeicherung
TokenCacheModule
Ja
URI-Zwischenspeicherung
UriCacheModule
Ja
URL-Autorisierung
UrlAuthorizationModule
Ja ASP.NET Core Identity
Windows-Authentifizierung
WindowsAuthenticationModule
Ja

†Die Übereinstimmungstypen isFile und isDirectory des URL-Rewrite-Moduls können aufgrund der Änderungen in der Verzeichnisstruktur nicht in ASP.NET Core-Apps ausgeführt werden.

Verwaltete Module

Verwaltete Module sind mit gehosteten ASP.NET Core-Apps nicht funktionsfähig, wenn die .NET CLR-Version des App-Pools auf Kein verwalteter Code festgelegt ist. ASP.NET Core bietet in verschiedenen Fällen Alternativen für Middleware an.

Modul ASP.NET Core-Option
AnonymousIdentification
DefaultAuthentication
FileAuthorization
FormsAuthentication Middleware für Cookieauthentifizierung
OutputCache Antworten zwischenspeichernde Middleware
Profile
RoleManager
ScriptModule-4.0
Sitzung Middleware für Sitzungen
UrlAuthorization
UrlMappingsModule URL-umschreibende Middleware
UrlRoutingModule-4.0 ASP.NET Core Identity
WindowsAuthentication

IIS Manager-Anwendungsänderungen

Bei Verwendung von IIS Manager für die Konfiguration von Einstellungen wurde die Datei web.config der App geändert. Wenn eine App bereitgestellt und web.config einbezogen wird, werden sämtliche mit IIS Manager vorgenommene Änderungen von der bereitgestellten Datei web.config überschrieben. Wenn Änderungen an der Datei web.config des Servers vorgenommen werden, kopieren Sie die aktualisierte Datei web.config auf dem Server direkt in das lokale Projekt.

Deaktivieren von IIS-Modulen

Wenn ein IIS-Modul auf Serverebene konfiguriert wird und für eine App deaktiviert werden muss, ist dies durch eine Erweiterung der Datei web.config der App möglich. Lassen Sie das Modul an der Stelle und deaktivieren Sie es mit einer Konfigurationseinstellung (falls verfügbar), oder entfernen Sie das Modul aus der App.

Deaktivierung von Modulen

Viele Module bieten eine Konfigurationseinstellung, mit der sie deaktiviert werden können, ohne aus der App entfernt werden zu müssen. Dies ist der einfachste und schnellste Weg zur Deaktivierung eines Moduls. Das HTTP-Umleitungsmodul kann beispielsweise mit dem <httpRedirect>-Element in web.config deaktiviert werden:

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

Für weitere Informationen zum Deaktivieren von Modulen mit Konfigurationseinstellungen folgen Sie den Links im Abschnitt Untergeordnete Elemente von IIS <system.webServer>.

Entfernen von Modulen

Wenn Sie ein Modul mit einer Einstellung in der Datei web.config entfernen können, entsperren Sie das Modul, und entsperren Sie zunächst den Abschnitt <modules> in der Datei web.config:

  1. Entsperren Sie das Modul auf Serverebene. Wählen Sie den IIS-Server in der IIS-Manager-Sidebar Verbindungen aus. Öffnen Sie Module im Bereich IIS. Wählen Sie das Modul aus der Liste aus. Wählen Sie in der Sidebar Aktionen auf der rechten Seite die Option Entsperren aus. Wenn der Aktionseintrag für das Modul Lock (Sperren) lautet, wurde das Modul bereits entsperrt, und es ist keine weitere Aktion erforderlich. Entsperren Sie alle Module, die Sie später aus web.config entfernen möchten.

  2. Stellen Sie die App ohne den Abschnitt <modules> in der Datei web.config bereit. Wenn eine App bereitgestellt wird, in der die Datei web.config den Abschnitt <modules> enthält, ohne dass der Abschnitt zuvor in IIS-Manager entsperrt wurde, löst der Configuration Manager bei dem Versuch, den Abschnitt zu entsperren, eine Ausnahme aus. Daher sollten Sie die App ohne einen Abschnitt <modules> bereitstellen.

  3. Entsperren Sie den Abschnitt <modules> in der Datei web.config. Wählen Sie in der Sidebar Verbindungen unter Sites die Website aus. Öffnen Sie im Bereich Verwaltung den Konfigurations-Editor. Wählen Sie mithilfe der Navigationssteuerelemente den Abschnitt system.webServer/modules aus. Wählen Sie in der Seitenleiste Aktionen auf der rechten Seite die Option Entsperren für den Abschnitt aus. Wenn der Aktionseintrag für den Modulabschnitt Lock Section (Abschnitt sperren) lautet, wurde der Modulabschnitt bereits entsperrt, und es ist keine weitere Aktion erforderlich.

  4. Fügen Sie den Abschnitt <modules> zur Datei web.config mit dem Element <remove> hinzu, um das Modul aus der App zu entfernen. Es können mehrere <remove>-Elemente hinzugefügt werden, um mehrere Module zu entfernen. Wenn auf dem Server Änderungen an der Datei web.config vorgenommen werden, nehmen Sie sofort lokal die gleichen Änderungen an der Datei web.config des Projekts vor. Wenn ein Modul auf diese Weise entfernt wird, hat dies keine Auswirkungen auf die Verwendung des Moduls mit anderen Apps auf dem Server.

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

Sie können Module für IIS Express mit web.config hinzufügen oder entfernen. Ändern Sie dazu die Datei applicationHost.config, und entsperren Sie den Abschnitt <modules>:

  1. Öffnen Sie {ANWENDUNGSSTAMM}\.vs\config\applicationhost.config.

  2. Machen Sie das Element <section> für IIS-Module ausfindig, und ändern Sie overrideModeDefault von Deny in Allow:

    <section name="modules"
             allowDefinition="MachineToApplication"
             overrideModeDefault="Allow" />
    
  3. Machen Sie den Abschnitt <location path="" overrideMode="Allow"><system.webServer><modules> ausfindig. Ändern Sie für alle zu entfernenden Module lockItem von true in false. Im folgenden Beispiel wird das CGI-Modul entsperrt:

    <add name="CgiModule" lockItem="false" />
    
  4. Nachdem der Abschnitt <modules> und die einzelnen Module entsperrt wurden, können Sie IIS-Module mit der web.config-Datei der App hinzufügen, um die App in IIS Express auszuführen.

Ein IIS-Modul kann auch mit Appcmd.exe entfernt werden. Geben Sie MODULE_NAME und APPLICATION_NAME im Befehl an:

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

Entfernen Sie beispielsweise DynamicCompressionModule aus „Default Web Site“ (Standardwebsite):

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

Modulmindestkonfiguration

Die einzigen Module, die für die Ausführung einer ASP.NET Core-App erforderlich sind, sind das anonyme Authentifizierungsmodul und das ASP.NET Core-Modul.

Mit dem URI-Zwischenspeicherungsmodul (UriCacheModule) kann IIS die Websitekonfiguration auf URL-Ebene zwischenspeichern. Ohne dieses Modul muss IIS die Konfiguration bei der Anforderung lesen und analysieren, selbst dann, wenn wiederholt die gleiche URL angefordert wird. Das Analysieren der Konfiguration bei jeder Anforderung führt zu erheblichen Leistungseinbußen. Auch wenn das URI-Zwischenspeicherungsmodul grundsätzlich nicht für die Ausführung einer gehosteten ASP.NET Core-App erforderlich ist, wird empfohlen, das URI-Zwischenspeicherungsmodul für sämtliche ASP.NET Core-Bereitstellungen zu aktivieren.

Das HTTP-Zwischenspeicherungsmodul (HttpCacheModule) implementiert den IIS-Ausgabecache und die Logik für das Zwischenspeichern von Elementen im HTTP.sys-Cache. Ohne dieses Modul werden Inhalte nicht mehr im Kernelmodus zwischengespeichert, und Cacheprofile werden ignoriert. Das Entfernen des HTTP-Zwischenspeicherungsmoduls hat in der Regel negative Auswirkungen auf Leistung und Ressourcennutzung. Auch wenn das HTTP-Zwischenspeicherungsmodul grundsätzlich nicht für die Ausführung einer gehosteten ASP.NET Core-App erforderlich ist, wird empfohlen, das HTTP-Zwischenspeicherungsmodul für sämtliche ASP.NET Core-Bereitstellungen zu aktivieren.

Zusätzliche Ressourcen