<system.webServer>

Artigo
03/12/2024

Visão geral

O elemento <system.webServer> especifica o elemento raiz para muitas das definições de configuração no nível do site e no nível do aplicativo para Serviços de Informações da Internet (IIS) 7 no arquivo ApplicationHost.config e contém elementos de configuração que definem as configurações usadas pelo mecanismo e módulos do servidor Web.

Observação

Ao contrário das configurações encontradas em <system.applicationHost>, as configurações no elemento <system.webServer> podem ser delegadas.

Compatibilidade

Versão	Observações
IIS 10.0	O elemento `<applicationInitialization>` não foi modificado no IIS 10.0.
IIS 8.5	O elemento `<system.webServer>` não foi modificado no IIS 8.5.
IIS 8.0	Os elementos `<applicationInitialization>` e `<webSocket>` foram adicionados como elementos filho.
IIS 7.5	O elemento `<system.webServer>` não foi modificado no IIS 7.5.
IIS 7.0	O elemento `<system.webServer>` foi introduzido no IIS 7.0.
IIS 6,0	N/D

Instalação

O elemento <system.webServer> está incluído na instalação padrão do IIS 7.

Instruções

Não há exemplos específicos para o elemento <system.webServer>. Para obter exemplos que definem as configurações encontradas dentro do elemento <system.webServer>, confira os elementos filho listados na seção detalhes da configuração deste tópico.

Configuração

O elemento <system.webServer> é definido no arquivo ApplicationHost.config, embora as configurações no elemento <system.webServer> possam ser delegadas para os arquivos Web.config.

Atributos

Nenhum.

Elementos filho

Elemento	Descrição
`applicationInitialization`	Elemento opcional. Define as configurações de inicialização do aplicativo que são executadas proativamente antes de uma solicitação ser recebida.
`asp`	Elemento opcional. Define as configurações de aplicativos Active Server Pages (ASP).
`caching`	Elemento opcional. Define as configurações de cache de saída.
`cgi`	Elemento opcional. Define as configurações padrão para aplicativos CGI (Common Gateway Interface).
`defaultDocument`	Elemento opcional. Define as configurações para retornar um documento padrão para um navegador do cliente quando o cliente não especifica um nome de arquivo em uma solicitação.
`directoryBrowse`	Elemento opcional. Configura se a pesquisa no diretório está habilitada ou desabilitada no servidor Web e especifica as informações a serem incluídas em uma listagem de diretórios.
`fastCgi`	Elemento opcional. Contém uma coleção de definições do pool de aplicativos fastCgi.
`globalModules`	Elemento opcional. Especifica as definições de configuração de módulos globais em um servidor Web.
`handlers`	Elemento opcional. Especifica os manipuladores para processar solicitações feitas em sites e aplicativos.
`httpCompression`	Elemento opcional. Define as configurações de compactação HTTP de um servidor Web.
`httpErrors`	Elemento opcional. Configura as mensagens de erro HTTP de um servidor Web.
`httpLogging`	Elemento opcional. Especifica as definições de configuração de registro em log HTTP.sys.
`httpProtocol`	Elemento opcional. Configura os cabeçalhos de resposta personalizados e de redirecionamento a serem enviados do servidor para o cliente.
`httpRedirect`	Elemento opcional. Define as configurações para redirecionar as solicitações de cliente para um novo local.
`httpTracing`	Elemento opcional. Especifica as definições de configuração de rastreamento HTTP.sys.
`isapiFilters`	Elemento opcional. Especifica as definições de configuração de filtros ISAPI em um servidor Web.
`management`	Elemento opcional. Configura um servidor Web para gerenciamento remoto usando o Gerenciador do IIS.
`modules`	Elemento opcional. Especifica as definições de configuração dos módulos em um servidor Web.
`odbcLogging`	Elemento opcional. Configura o registro em log do Open Database Connectivity (ODBC).
`security`	Elemento opcional. Especifica o grupo de seções que contém as seções relacionadas à segurança.
`serverRuntime`	Elemento opcional. Configura os limites de solicitação de aplicativos em um servidor Web.
`serverSideInclude`	Elemento opcional. Especifica se as diretivas de #exec do Server-Side Include (SSI) estão desabilitadas.
`staticContent`	Elemento opcional. Define as configurações do manipulador de solicitação de arquivo estático.
`tracing`	Elemento opcional. Define as configurações de rastreamento de solicitação.
`urlCompression`	Elemento opcional. Configura a compactação de conteúdo estático e dinâmico.
`validation`	Elemento opcional. Configura o IIS 7 para detectar se um aplicativo ASP.NET configurado para ser executado no modo ISAPI precisa de qualquer migração para funcionar corretamente no modo Integrado.
`webdav`	Elemento opcional. Define as configurações de publicação do WebDAV.
`webSocket`	Elemento opcional. Configura as comunicações pelo protocolo WebSocket.

Exemplo de configuração

O exemplo de configuração a seguir define um elemento <system.webServer> simples, somente conteúdo estático.

<system.webServer>
   <asp />
   <caching enabled="true" enableKernelCache="true" />
   <cgi />
   <defaultDocument enabled="true">
      <files>
         <add value="Default.htm" />
         <add value="Index.htm" />
         <add value="Index.html" />
      </files>
   </defaultDocument>
   <directoryBrowse enabled="false" />
   <fastCgi />
   <globalModules>
      <add name="UriCacheModule" image="%windir%\System32\inetsrv\cachuri.dll" />
      <add name="FileCacheModule" image="%windir%\System32\inetsrv\cachfile.dll" />
      <add name="TokenCacheModule" image="%windir%\System32\inetsrv\cachtokn.dll" />
      <add name="HttpCacheModule" image="%windir%\System32\inetsrv\cachhttp.dll" />
      <add name="StaticCompressionModule" image="%windir%\System32\inetsrv\compstat.dll" />
      <add name="DefaultDocumentModule" image="%windir%\System32\inetsrv\defdoc.dll" />
      <add name="DirectoryListingModule" image="%windir%\System32\inetsrv\dirlist.dll" />
      <add name="ProtocolSupportModule" image="%windir%\System32\inetsrv\protsup.dll" />
      <add name="StaticFileModule" image="%windir%\System32\inetsrv\static.dll" />
      <add name="AnonymousAuthenticationModule" image="%windir%\System32\inetsrv\authanon.dll" />
      <add name="RequestFilteringModule" image="%windir%\System32\inetsrv\modrqflt.dll" />
      <add name="CustomErrorModule" image="%windir%\System32\inetsrv\custerr.dll" />
      <add name="HttpLoggingModule" image="%windir%\System32\inetsrv\loghttp.dll" />
      <add name="RequestMonitorModule" image="%windir%\System32\inetsrv\iisreqs.dll" />
   </globalModules>
   <httpCompression directory="%SystemDrive%\inetpub\temp\IIS Temporary Compressed Files">
      <scheme name="gzip" dll="%Windir%\system32\inetsrv\gzip.dll" />
      <staticTypes>
         <add mimeType="text/*" enabled="true" />
         <add mimeType="message/*" enabled="true" />
         <add mimeType="application/javascript" enabled="true" />
         <add mimeType="*/*" enabled="false" />
      </staticTypes>
   </httpCompression>
   <httpErrors>
      <error statusCode="401" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="401.htm" />
      <error statusCode="403" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="403.htm" />
      <error statusCode="404" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="404.htm" />
      <error statusCode="405" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="405.htm" />
      <error statusCode="406" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="406.htm" />
      <error statusCode="412" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="412.htm" />
      <error statusCode="500" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="500.htm" />
      <error statusCode="501" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="501.htm" />
      <error statusCode="502" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="502.htm" />
   </httpErrors>
   <httpLogging dontLog="false" />
   <httpProtocol />
   <httpRedirect />
   <httpTracing />
   <isapiFilters />
   <odbcLogging />
   <security>
      <access sslFlags="None" />
      <applicationDependencies />
      <authentication>
         <anonymousAuthentication enabled="true" userName="IUSR" />
         <basicAuthentication />
         <clientCertificateMappingAuthentication />
         <digestAuthentication />
         <iisClientCertificateMappingAuthentication />
         <windowsAuthentication />
      </authentication>
      <authorization />
      <ipSecurity />
      <isapiCgiRestriction notListedIsapisAllowed="false" notListedCgisAllowed="false">
         <clear />
      </isapiCgiRestriction>
      <requestFiltering>
         <fileExtensions allowUnlisted="true" applyToWebDAV="true" />
         <verbs allowUnlisted="true" applyToWebDAV="true" />
         <hiddenSegments applyToWebDAV="true">
            <add segment="Web.config" />
         </hiddenSegments>
      </requestFiltering>
   </security>
   <serverRuntime />
   <serverSideInclude />
   <staticContent lockAttributes="isDocFooterFileName">
      <mimeMap fileExtension=".png" mimeType="image/gif" />
      <mimeMap fileExtension=".htm" mimeType="text/html" />
      <mimeMap fileExtension=".html" mimeType="text/html" />
      <mimeMap fileExtension=".jpeg" mimeType="image/jpeg" />
      <mimeMap fileExtension=".png" mimeType="image/jpeg" />
      <mimeMap fileExtension=".js" mimeType="application/x-javascript" />
      <mimeMap fileExtension=".png" mimeType="image/png" />
      <mimeMap fileExtension=".txt" mimeType="text/plain" />
   </staticContent>
   <tracing>
      <traceFailedRequests />
      <traceProviderDefinitions />
   </tracing>
   <urlCompression />
   <validation />
   <webSocket />
</system.webServer>

Exemplo de código

Não há exemplos de código específicos para o elemento <system.webServer>. Para obter exemplos de código que definem as configurações encontradas dentro do elemento <system.webServer>, confira os elementos filho listados na seção detalhes da configuração deste tópico.

Compartilhar via