Le istruzioni di inclusione sul lato server (SSI, Server-Side Include) indicano al server Web di inserire vari tipi di contenuto in una pagina Web. Tali tipi di contenuto possono includere il valore di una variabile del server, talvolta denominata variabile CGI, l'output di un comando della shell, una data di modifica e/o la dimensione di un file oppure il contenuto di un altro file, quando si utilizza l'istruzione #include. Le istruzioni possono includere inoltre una stringa di errori SSI.
È possibile utilizzare le istruzioni SSI per indicare al server Web di includere testo, grafica o output dell'applicazione in una pagina Web immediatamente prima di inviare le informazioni al browser. È possibile utilizzare le istruzioni SSI per includere, ad esempio, un timestamp, note di copyright o un modulo che i clienti possono compilare e restituire. L'inclusione di un file rappresenta un metodo semplice per incorporare testo o collegamenti a grafici che vengono ripetuti in molti file. SSI offre speciali istruzioni di preelaborazione che consentono di accedere a informazioni su un file o di visualizzare il valore di una variabile del server. Fornisce inoltre un'istruzione per l'inserimento in una pagina Web dell'output di un'applicazione o di un comando della shell. Anziché aggiungere il contenuto o l'output in ogni file, è possibile salvarlo in un file di inclusione. Questo file verrà chiamato attraverso una semplice istruzione che indica al server Web di inserire il contenuto o l'output nelle pagine Web appropriate.
IIS elabora istruzioni SSI durante l'elaborazione di una pagina Web. Quando il server Web riscontra un'istruzione SSI, inserirà il contenuto del file di inclusione o l'output dell'applicazione direttamente nella pagina Web. Se il file di inclusione contiene un'istruzione SSI, verranno inseriti anche il file o l'output. Oltre alle istruzioni di base per l'inclusione di file sono disponibili istruzioni SSI per l'inserimento di informazioni relative a un file, ad esempio le dimensioni, oppure per l'esecuzione di un'applicazione o di un comando della shell.
Per impostazione predefinita, IIS è impostato per elaborare file di inclusione sul lato server con estensioni stm, shtm o shtml, sebbene sia possibile configurare anche l'elaborazione di altre estensioni di file. Inoltre, IIS esegue la ricerca ed elabora istruzioni #include in file con estensione asp. Assicurarsi che tutti i file contenenti istruzioni SSI dispongano di una estensione SSI definita. Le istruzioni SSI, come altri mapping di script, funzionano in tutti i file le cui estensioni siano associate a ssinc.dll. Se, per qualsiasi motivo, le estensioni sono state eliminate dall'elenco dei mapping delle applicazioni, utilizzare la procedura riportata di seguito per aggiungere all'elenco l'estensione del file SSI.
Assicurarsi anche di inserire i file SSI in una directory con autorizzazioni di accesso Script o Esecuzione. È necessario limitare l'accesso degli utenti a tale directory per evitare intrusioni da parte di utenti non autorizzati. Per ulteriori informazioni, vedere Controllo dell'accesso con IIS 6.0 e Impostazione delle autorizzazioni NTFS per directory o file.
Importante |
|---|
|
Per eseguire la procedura o le procedure seguenti, è necessario appartenere al gruppo Administrators del computer locale. Per una protezione ottimale, accedere al computer mediante un account non appartenente al gruppo Administrators e quindi utilizzare il comando runas per eseguire Gestione IIS come amministratore. Al prompt dei comandi digitare runas /User:Nomeaccount_Amministrativo "mmc %systemroot%\system32\inetsrv\iis.msc". |
Procedure
Per abilitare le inclusioni sul lato server
In Gestione IIS, espandere la struttura del computer locale, fare clic con il pulsante destro del mouse sulla cartella Siti Web, per abilitare SSI in tutti i siti Web, oppure fare clic con il pulsante destro del mouse su un sito Web specifico e scegliere Proprietà.
Fare clic sulla scheda Home directory.
Nella sezione Impostazioni applicazioni fare clic su Configurazione.
Nella scheda Mapping fare clic su Aggiungi.
Nella finestra di dialogo Aggiungi/Modifica mapping estensioni applicazioni immettere tutte le informazioni richieste.
Fare clic su OK.
Per disabilitare l'istruzione delle inclusioni sul lato server sul server Web di IIS, è necessario rimuovere le estensioni SSI dall'elenco dei mapping delle applicazioni. Se il server Web riceve una richiesta per una pagina e l'estensione SSI è stata rimossa, le istruzioni di inclusione sul lato server contenute nella pagina non verranno elaborate da ISS. È possibile disabilitare l'elaborazione delle istruzioni di inclusione sul lato server su tutti i siti Web o su un sito Web specifico.
Per disabilitare le inclusioni sul lato server
In Gestione IIS, espandere la struttura del computer locale, fare clic con il pulsante destro del mouse sulla cartella Siti Web, per disabilitare SSI in tutti i siti Web, oppure fare clic con il pulsante destro del mouse su un sito Web specifico e scegliere Proprietà.
Scegliere la scheda Home directory.
Nella sezione Impostazioni applicazione, scegliere Configurazione.
Nella scheda Mapping scorrere l'elenco Mapping applicazioni, fare clic sull'estensione SSI da disabilitare e quindi scegliere Rimuovi.
Scegliere OK.
Informazioni correlate
-
Per informazioni sull'abilitazione dell'esecuzione dei comandi della shell, vedere la sezione SSIEnableCmdDirective in WWW Service Registry Entries.
-
Per informazioni specifiche a livello di programmazione sull'implementazione delle istruzioni SSI, eseguire la ricerca di "ssi" sul sito Web Microsoft Developer Network (MSDN).