Partilhar via

Autorização elemento (esquema configurações ASP.NET)

  • Artigo

Configura a autorização para um aplicativo Web Web, controlar o acesso do cliente aos recursos da URL.

configuração elemento (Geral Settings esquema)
  System.Web elemento (esquema configurações ASP.NET) 
    Autorização elemento (esquema configurações ASP.NET)

<authorization> 
   <allow .../>
   <deny .../>
</authorization>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Nenhum.

Elementos filho

Submarca

Descrição

allow

Adiciona o mapeamento de regras uma autorização de regra que permite o acesso a um recurso de autorização.

deny

Adiciona o mapeamento de regras uma autorização de regra que nega acesso a um recurso de autorização.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz exigido em todos os arquivos de configuração usado pelo common linguagem tempo de execução e os aplicativos do .NET estrutura.

system.web

Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração e contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.

Comentários

The authorization elemento configura a autorização para um aplicativo Web Web, controlar o acesso do cliente aos recursos da URL.

Em time de execução, o módulo de autorização itera através de allow e deny elementos, começando no arquivo de configuração mais local, até que o módulo de autorização localiza a primeira regra de acesso que se ajuste a uma determinada conta de usuário. Em seguida, o módulo de autorização concede ou nega acesso a um recurso de URL de acordo com a primeira regra de acesso encontrada um allow ou um deny regra. A regra de autorização padrão é <allow users="*"/>. Assim, por padrão, o acesso é permitido a menos que configurado de outra forma.

Para facilitar a implantação, o período (.) há suporte para a notação de atalho para o computador corrente. Isso permite que você prefixar cada usuário ou função com uma sequência de barra invertida do período (. \), as follows:

<allow roles=".\roleName"/>
<allow users=".\userName"/>

Em time de execução, as seqüências de barra invertida do período são substituídas por "nome_do_computador_local\" seqüências. A substituição é feita somente se uma identidade do Microsoft Windows for usada com a solicitação. Isso é para evitar conflitos caso as seqüências de sequência de barra invertida do período são usadas em funções arbitrárias com objetos personalizados.

Porque o authorization elemento não representa uma coleção, há nenhum clear ou remove elementos filho. Para desmarcar programaticamente os mapeamentos de regras de autorização, use o Clear() ou Remove(AuthorizationRule) método.

Configuração padrão

O seguinte padrão authorization elemento é configurado no arquivo raiz Web.config no .NET estrutura versão 2.0 e configurado no arquivo computador.config no .NET estrutura versões 1.1 e 1.0.

<authorization>
   <allow users="*" />
</authorization>

Exemplo

O exemplo de código a seguir demonstra como permitir o acesso a todos os Admins membros da função e negar acesso a todos users membros da função.

<configuration>
   <system.web>
      <authorization>
         <allow roles="Admins"/>
         <deny users="*"/>
      </authorization>
   </system.web>
</configuration>

Informações do elemento

Manipulador de seção de configuração

AuthorizationSection

Configuração de membro

Authorization

AuthorizationRuleCollection

Locais configuráveis

Machine.config

Web.config de nível de raiz

Web.config de nível de aplicativo

Virtual ou físico diretório–nível Web.config

Requisitos

Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0

O .NET estrutura versão 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou o Visual Studio 2005

Consulte também

Tarefas

Como: Configurar diretórios específicos usando configurações de local

Como: Bloquear ASP.NET Configuration Settings

Conceitos

Autorização ASP.NET

Hierarquia e Herança do Arquivo de Configuração do ASP.NET

Protegendo configuração ASP.NET

Cenários de configuração ASP.NET

Referência

System.Web elemento (esquema configurações ASP.NET) 

Permitir elemento (ASP.NET Settings esquema) de autorização

Negar elemento (ASP.NET Settings esquema) de autorização

configuração elemento (Geral Settings esquema)

Outros recursos

Gerenciando Autorização Usando Funções

Configurações gerais (ASP.NET)

Definições de configuração ASP.NET

Administrando ites da Web do ASP.NET

API de Configuração do ASP.NET