IIS Modules Overview (Panoramica dei moduli IIS)

di IIS Team, Mike Volodarsky

Compatibilità

Introduzione

Il set di funzionalità server Web IIS 7 e versioni successive viene inserito in più di trenta moduli indipendenti.

Un modulo è una DLL Win32 (modulo nativo) o un tipo .NET 2.0 contenuto in un assembly (modulo gestito). Analogamente a un set di blocchi predefiniti, i moduli vengono aggiunti al server per fornire le funzionalità desiderate per le applicazioni. Analogamente, tutti i moduli IIS possono essere rimossi o sostituiti con moduli personalizzati sviluppati usando le API C++ di IIS o le API ASP.NET 2.0 familiari.

Questo articolo descrive le attività comuni di gestione dei moduli IIS e illustra in dettaglio ogni modulo, incluse le impostazioni di configurazione e il potenziale effetto della rimozione di un modulo nel server Web. Gli esempi di gestione vengono forniti usando gestione IIS con interfaccia grafica e lo strumento da riga di comando AppCmd .

Prerequisiti

Per seguire la procedura descritta in questo documento, è consigliabile eseguire un'installazione completa di IIS.

Per eseguire un'installazione completa di IIS in Windows Vista, Windows 7, Windows 8, Windows 10 o Windows 11

1. Fare clic sul pulsante Start e scegliere Pannello di controllo.
2. Nella Pannello di controllo fare clic su Programmi.
3. In Programmi e funzionalità fare clic su Attivazione o disattivazione delle funzionalità Windows.
4. Nella finestra di dialogo Funzionalità di Windows espandere Internet Information Services e selezionare tutte le funzionalità.
   Potrebbe essere necessario espandere alcune categorie per selezionare tutte le funzionalità di tale categoria.
5. Fare clic su OK.

Per eseguire un'installazione completa di IIS in Windows Server 2008/R2, Windows Server 2012/R2 o Windows Server 2016

1. Aprire Ruoli di Server Manager>e selezionare Server Web (IIS).
2. Controllare tutte le funzionalità in Server Web.

Introduzione ai moduli

Per aggiungere un modulo al server, è necessario eseguire due passaggi:

1. Installare un modulo nel server (solo moduli nativi).
2. Abilitare il modulo in un'applicazione.

Il primo passaggio registra il modulo a livello globale con il server, rendendolo disponibile all'interno di ogni processo di lavoro del server. È necessario solo per i moduli nativi a causa della natura attendibile del codice nativo ed è disponibile solo per gli amministratori.

Il secondo passaggio consente all'esecuzione del modulo all'interno di un'applicazione specifica e consente in modo efficace all'amministratore dell'applicazione di controllare le funzionalità del server abilitate per l'applicazione. Questo passaggio consente l'abilitazione di moduli nativi installati e moduli gestiti per ogni applicazione.

Per installare un modulo nativo

Per installare un modulo nativo, è necessario registrarlo con il server usando una delle opzioni seguenti:

• Modifica manuale dell'archivio di configurazione IIS. In IIS 7.5 e versioni successive è possibile usare l'Editor di configurazione in Gestione IIS.
• Utilizzo di Gestione IIS
• Uso dello strumento da riga di comando AppCmd.exe

Tutte e tre queste opzioni comportano l'aggiunta della voce del <modulo alla sezione di configurazione di IIS globalModules> , che può essere impostata solo a livello di server. Per esaminare il contenuto di questa sezione, aprire il file di configurazione radice disponibile in %windir%\system32\inetsrv\config\applicationhost.confige cercare la stringa "<globalModules>".

Dopo un'installazione completa di IIS, questa sezione contiene una voce per ognuno dei moduli nativi forniti con IIS, specificando un nome e il percorso della DLL del modulo:

<globalModules>
    <add name="DefaultDocumentModule" image="%windir%\system32\inetsrv\defdoc.dll" />
    <add name="DirectoryListingModule" image="%windir%\system32\inetsrv\dirlist.dll" />
    <add name="StaticFileModule" image="%windir%\system32\inetsrv\static.dll" />
    ...

</globalModules>

Tutti questi moduli sono descritti in dettaglio più avanti in questo documento.

Per disinstallare un modulo nativo

È possibile disinstallare un modulo nativo se tale modulo non è più in uso nel server o se si vuole sostituirlo con un altro modulo. Rimuovere la voce del modulo corrispondente dall'elenco <di configurazione globalModules> e la voce associata nell'elenco <modules> di configurazione usando una delle opzioni seguenti:

• Modifica manuale dell'archivio di configurazione IIS. In IIS 7.5 e versioni successive è possibile usare l'editor di configurazione.
• Utilizzo di Gestione IIS
• Uso dello strumento da riga di comando AppCmd.exe

Abilitazione di un modulo per un'applicazione

Prima di poter fornire un servizio per una determinata applicazione, è necessario abilitare un modulo. Per abilitare un modulo nativo, è necessario prima installarlo nel server (vedere la sezione precedente Per installare un modulo nativo).

Un modulo gestito non richiede l'installazione e può essere abilitato direttamente per ogni applicazione. Ciò consente alle applicazioni di includere i moduli gestiti direttamente all'interno dell'applicazione registrandoli nel file web.config dell'applicazione e fornendo l'implementazione nelle directory /BIN o /App_Code.

Per abilitare un modulo, eseguire una delle operazioni seguenti:

• Modificare manualmente l'archivio di configurazione IIS, a livello globale per abilitare il modulo per tutte le applicazioni nel server o in un file web.config specifico che si trova all'interno di ogni applicazione per cui si vuole abilitare questo modulo. In IIS 7.5 o versione successiva è possibile usare l'editor di configurazione.
• Usare Gestione IIS
• Usare lo strumento da riga di comando AppCmd.exe

Tutte e tre queste opzioni aggiungono la voce del modulo alla <modules> sezione configurazione iis, che può essere impostata sia a livello di server che di applicazione. Esaminare il contenuto di questa sezione aprendo il file di configurazione radice che si trova in %windir%\system32\inetsrv\config\applicationhost.confige cercando la stringa "<modules>".

A differenza dei moduli nativi, un modulo gestito non richiede l'aggiunta <di una voce alla sezione di configurazione globalModules> .

Dopo un'installazione completa di IIS, la sezione di configurazione contiene una voce per ogni modulo (sia gestito che nativo) fornito con IIS. La voce indica che tutti questi moduli sono abilitati per impostazione predefinita per tutte le applicazioni nel server. Ogni voce di questa sezione specifica il nome di un modulo nativo installato in precedenza nel server oppure il nome e il tipo .NET di un modulo gestito:

<modules>
<add name="DefaultDocumentModule" />
<add name="DirectoryListingModule" />
<add name="StaticFileModule"/>
 ...

</modules>

Disabilitazione di un modulo in un'applicazione

Disabilitare un modulo se tale modulo non è più in uso nell'applicazione o se si vuole sostituirlo con un altro modulo. Per disabilitare un modulo, rimuovere la voce del <modules> modulo corrispondente dalla raccolta di configurazione per una determinata applicazione in cui non si vuole eseguire questo modulo. Se il modulo è abilitato a livello di server, rimuoverlo per disabilitarlo in tutte le applicazioni nel server per impostazione predefinita. Usare una delle opzioni seguenti per rimuovere il modulo a livello di server:

• Modificare manualmente la <sezione di configurazione system.webServer>/<modules> nell'applicazione.
• Usare Gestione IIS.
• Usare lo strumento da riga di comando AppCmd.exe .

Dopo che il modulo è stato rimosso dall'applicazione, non sarà attivo in tale applicazione. Tuttavia, se il modulo è nativo, verrà comunque caricato nel processo di lavoro del server e può essere usato da altre applicazioni che non lo hanno rimosso.

Condizioni preliminari

Esiste un altro attributo in una voce di modulo denominata precondizione. Il motore principale di IIS usa le precondizioni per determinare quando abilitare un modulo specifico. I motivi delle prestazioni, ad esempio, potrebbero determinare che si vogliono eseguire solo moduli gestiti per le richieste che passano anche a un gestore gestito. La precondizione nell'esempio seguente (precondizione="managedHandler") abilita solo il modulo di autenticazione basata su form per le richieste gestite anche da un gestore gestito, ad esempio le richieste ai file .aspx o asmx:

<add name="FormsAuthentication"type="System.Web.Security.FormsAuthenticationModule" preCondition="managedHandler" />

Se si rimuove l'attributo precondizione="managedHandler", l'autenticazione basata su form si applica anche al contenuto non gestito dai gestori gestiti, ad esempio .html, .jpg, .doc, ma anche per le estensioni ASP (.asp) classiche o PHP (.php). Per un esempio di abilitazione dell'esecuzione di moduli ASP.NET per tutto il contenuto, vedere "How to Advantage of IIS Integrated Pipeline" (Come sfruttare i vantaggi della pipeline integrata IIS).

È anche possibile usare un collegamento per consentire l'esecuzione di tutti i moduli gestiti (ASP.NET) per tutte le richieste nell'applicazione, indipendentemente dalla precondizione "managedHandler". Per consentire l'esecuzione di tutti i moduli gestiti per tutte le richieste senza configurare ogni voce di modulo per rimuovere la precondizione "managedHandler", usare la proprietà runAllManagedModulesForAllRequests nella <modules> sezione :

<modules runAllManagedModulesForAllRequests="true"/>

Quando si usa questa proprietà, la precondizione "managedHandler" non ha alcun effetto e tutti i moduli gestiti vengono eseguiti per tutte le richieste.

Esecuzione di query, aggiunta e rimozione di moduli tramite Gestione IIS

Gestione IIS offre un modo semplice per eseguire query, aggiungere o rimuovere moduli.

1. Per aprire Gestione IIS, fare clic su Start, digitare inetmgr nella casella Di ricerca e quindi premere INVIO.
2. Fare clic sul nome del computer del server IIS.
3. Fare clic sull'icona Moduli nella categoria IIS .

Figura 1: Gestione IIS

Per gestire i moduli abilitati per una determinata applicazione

1. Connessione a tale applicazione usando la visualizzazione albero a sinistra.
2. Passare al riquadro funzionalità Moduli.
3. Fare clic su Aggiungi modulo gestito per aggiungere un modulo gestito all'applicazione. L'aggiunta del modulo nativo consente solo di aggiungere un modulo già registrato a livello di server.

Per rimuovere un modulo dall'applicazione

1. Fare clic sul modulo nell'elenco. L'attività Rimuovi viene visualizzata nel riquadro sinistro.
2. Fare clic su Rimuovi.

Figura 2: Elenco moduli in Gestione IIS

Gestione dei moduli dalla riga di comando

Per gestire rapidamente i moduli dalla riga di comando o dalle attività di gestione dei moduli script, usare lo strumento da riga di comando AppCmd.exe .

Per installare un modulo usando AppCmd.exe

Al prompt dei comandi digitare il comando seguente, sostituendo i valori in corsivo con i valori per il modulo nel computer.

Appcmd.exe install module /name:MODULE_NAME /image:PATH_TO_DLL

Ad esempio, il comando seguente installa il modulo Documento predefinito.

%windir%\system32\inetsrv\appcmd.exe install module /name:DefaultDocumentModule /image:%windir%\system32\inetsrv\defdoc.dll

Se si esegue il comando in un computer in cui il modulo è già caricato, verrà visualizzato un messaggio di errore simile al seguente:

ERROR (message:Failed to add duplicate collection element "DefaultDocumentModule".)

Per disinstallare un modulo usando AppCmd.exe

Al prompt dei comandi digitare il comando seguente, sostituendo i valori in corsivo con i valori per il modulo nel computer.

Appcmd.exe uninstall module MODULE_NAME

Ad esempio, il comando seguente disinstalla il modulo Documento predefinito. Questo comando viene fornito solo come esempio. È consigliabile eseguirlo solo in un server di test.

%windir%\system32\inetsrv\appcmd.exe uninstall module DefaultDocumentModule

Per elencare i moduli abilitati per un'applicazione o a livello globale

Al prompt dei comandi digitare il comando seguente, sostituendo i valori in corsivo con i valori per il modulo nel computer.

Appcmd.exe list modules [/app.name:APPLICATION_NAME]

Ad esempio, il comando seguente elenca i moduli abilitati per il sito Web predefinito.

%windir%\system32\inetsrv\appcmd.exe list modules /app.name:"Default Web Site"

Questo comando elenca i moduli installati a livello globale.

%windir%\system32\inetsrv\appcmd.exe list modules

Per abilitare un modulo per una particolare applicazione o a livello globale

Al prompt dei comandi digitare il comando seguente, sostituendo i valori in corsivo con i valori per il modulo nel computer.

Appcmd.exe add module /name:MODULE_NAME /type:MGD_TYPE

Ad esempio, il comando seguente aggiunge il modulo Autenticazione basata su form al sito Web predefinito.

%windir%\system32\inetsrv\appcmd.exe add module /name:FormsAuthentication /type:System.Web.Security.FormsAuthenticationModule /app.name:"Default Web Site"

Questo comando aggiunge il modulo di autenticazione basata su form a livello globale.

%windir%\system32\inetsrv\appcmd.exe add module /name:FormsAuthentication /type:System.Web.Security.FormsAuthenticationModule

Per disabilitare un modulo per una particolare applicazione o a livello globale

Al prompt dei comandi digitare il comando seguente, sostituendo i valori in corsivo con i valori per il modulo nel computer.

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

Ad esempio, il comando seguente rimuove il modulo Autenticazione basata su form dal sito Web predefinito.

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

Questo comando rimuove il modulo di autenticazione basata su form a livello globale.

%windir%\system32\inetsrv\appcmd.exe delete module FormsAuthentication

Per ottenere altre informazioni sulla sintassi per ognuno dei comandi di Cmd.exe app

Per visualizzare i comandi supportati nell'oggetto Module, digitare il comando seguente:

Appcmd.exe module /?

Per visualizzare l'utilizzo di ogni comando, digitare il comando seguente:

Appcmd.exe install module /?Appcmd add module /?

informazioni di riferimento sul modulo

Il server IIS è pronto per la personalizzazione. Leggere attentamente l'elenco seguente per evitare effetti collaterali, perdita di funzionalità o rimozione delle funzionalità di sicurezza.

Moduli di utilità

Questi moduli non forniscono servizi di richiesta, ma supportano invece il motore del server con il relativo funzionamento interno.

Moduli gestiti: