Partilhar via


anonymousIdentification Element (ASP.NET Settings Schema)

Configura identificação anônima para autorização aplicativos. Isso é necessário para identificar entidades que não são autenticadas quando autorização é necessária.

Esse elemento é novo no .NET Framework versão 2.0.

<anonymousIdentification  
   enabled="[true | false]"
   cookieless="[UseUri | UseCookies | AutoDetect | UseDeviceProfile]"
   cookieName=""
   cookiePath=""
   cookieProtection="[None | Validation | Encryption | All]"
   cookieRequireSSL="[true | false]"
   cookieSlidingExpiration="[true | false]"
   cookieTimeout="[DD.HH:MM:SS]"
   domain="cookie domain"
/>

Atributos e elementos

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

Atributos

Atributo

Descrição

cookieless

Especifica se deve usar cookies para um aplicativo Web. O HttpCookieMode enumeração é usada para especificar o valor para este atributo na seção de configuração. Ele é usado por todos os recursos que oferecem suporte à autenticação cookieless. Quando o AutoDetect valor for especificado, ASP.NET consultará o navegador ou dispositivo para determinar se ele suporta cookies. Se o navegador ou dispositivo oferece suporte a cookies, os cookies são usados para persistir os dados do usuário; Caso contrário, um identificador é usado na seqüência de consulta.

Observação

Quando você configura um aplicativo habilitado para AJAX do ASP.NET Web site, use apenas o valor padrão de UseCookies para o cookieless atributo.Configurações de cookies codificados em URL não são suportadas pelo ASP.Bibliotecas de scripts de cliente NET AJAX.

Esse atributo pode ser um dos seguintes valores possíveis.

ValorDescrição
AutoDetect Especifica que o ASP.NET determina se o dispositivo ou navegador solicitante suporta cookies.Se o dispositivo ou navegador solicitante oferece suporte a cookies, AutoDetect usa cookies para manter os dados do usuário; Caso contrário, um identificador é usado na seqüência de consulta.Se o navegador ou dispositivo oferece suporte a cookies, mas no momento em que os cookies estão desabilitados, os cookies ainda são usados pelo recurso do solicitante.
UseCookies Especifica que os cookies são usados para persistir os dados do usuário, independentemente se o navegador ou dispositivo oferece suporte a cookies.Este é o padrão.
UseDeviceProfile Especifica que o ASP.NET determina se deve usar cookies com base no HttpBrowserCapabilities configuração.Se a configuração indica que o navegador ou dispositivo oferece suporte cookies, os cookies são usados; Caso contrário, um identificador é usado na seqüência de consulta.
UseUri Especifica que o recurso de chamada usa a seqüência de caracteres de consulta para armazenar um identificador, independentemente se o navegador ou dispositivo oferece suporte a cookies.

O padrão é "UseCookies".

cookieName

Especifica o nome atribuído ao cookie.

O valor padrão é ".ASPXANONYMOUS".

cookiePath

Especifica o caminho para o diretório onde o cookie está armazenado. O caminho diferencia maiúsculas de minúsculas.

O padrão é o diretório raiz que é especificado por "/".

cookieProtection

Especifica o esquema de proteção do cookie.

Esse atributo pode ser um dos seguintes valores possíveis.

ValorDescrição
All Especifica que tanto o Validation e Encryption valores são usados para proteger as informações no cookie.
Encryption Criptografa as informações no cookie.
None Especifica que as informações do cookie não estão protegidas.Informações no cookie são armazenadas em texto não criptografado e não são validadas quando as informações são enviadas de volta para o servidor.
Validation Garante que as informações no cookie não tem sido alteradas antes das informações são enviadas de volta para o servidor.

O padrão é "Validation".

cookieRequireSSL

Especifica se o cookie requer uma conexão Secure Sockets Layer (SSL), quando ele é transmitido ao cliente. Porque ASP.NET define a propriedade de cookie de autenticação, Secure, o cliente não retorna o cookie a menos que uma conexão SSL está em uso.

O padrão é false.

cookieSlidingExpiration

Obrigatório Boolean atributo.

Especifica se o tempo limite do cookie é redefinido em cada solicitação ou em um intervalo fixo predefinidos. Se true, o tempo limite do cookie ocorre quando menos de 50 por cento do tempo de vida (TTL) permanece. Se false, os tempos de cookie out após a cookieTimeout duração passou.

O padrão é true.

cookieTimeout

Obrigatório TimeSpan atributo.

Especifica o intervalo de tempo de expiração do cookie, em minutos.

O padrão é 100000 minutos (69 dias, 10 horas, e 40 minutos).

O valor máximo é de 2 anos.

domain

Especifica o domínio do cookie. Este atributo permite que o cookie de identificação anônima para ser compartilhado entre domínios que têm um espaço de nomes DNS comuns (por exemplo, todos os sites que terminam em contoso.com). Para compartilhar os cookies de identificação anônima, os sites devem compartilhar descriptografia comuns e chaves de validação. Outra configuração de identificação anônima atributos, como cookiePath e cookieName, deve ser o mesmo para todos os sites. Para obter mais informações, consulte HttpCookie.

The default is an empty string ("").

enabled

Opcional Boolean atributo.

Especifica se a identificação anônima está ativada. Se true, um cookie (ou valor cookieless) é usado para gerenciar o identificador anônimo. do usuário

O padrão é false.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e a.Aplicativos do NET Framework.

system.web

Especifica o elemento raiz para o ASP.Definições de configuração de rede em uma configuração de arquivo e contém elementos que configurar aplicativos ASP.NET e controlar como os aplicativos se comportam.

Comentários

O <anonymousIdentification> elemento configura identificação anônima para autorização de aplicativo. Isso é necessário para identificar entidades que não são autenticadas quando você usar o recurso de perfil.

Quando você envia o tíquete de identificação anônima no URI, você pode exceder o tamanho máximo do URI. Se a combinação de ticket de identificação anônima, constitui o tíquete de autenticação, identificação de sessão e os dados do usuário for maiores que o comprimento máximo permitido do URI, a solicitação falhará com um erro de solicitação de 400 com defeito.

Configuração padrão

O seguinte padrão <anonymousIdentification> é o elemento não explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, é a configuração padrão que é retornada por um aplicativo.

<anonymousIdentification 
   enabled="false" 
   cookieName=".ASPXANONYMOUS" 
   cookieTimeout="100000"    
   cookiePath="/" 
   cookieRequireSSL="false" 
   cookieSlidingExpiration="true" 
   cookieProtection="Validation"    
   cookieless="UseCookies" 
   domain="" 
/>

Exemplo

O exemplo de código a seguir demonstra como configurar um site para a identificação anônima.

<configuration>
    <system.web>
      <anonymousIdentification 
        enabled="true"
        cookieless="UseCookies"
        cookieName=".ASPXANONYMOUS"
        cookieTimeout="30"
        cookiePath="/"
        cookieRequireSSL="false"
        cookieSlidingExpiration = "true"
        cookieProtection="Clear"
      />
    </system.web>
</configuration>

Informações do elemento

Manipulador da seção de configuração

AnonymousIdentificationSection

Membro de configuração

AnonymousIdentification

Locais configuráveis

Machine.config

Web. config de nível de raiz

Web. config de nível de aplicativo

Requisitos

De da (IIS) versões 5.0, 5.1 ou 6.0

A.NET Framework versão 2.0

Microsoft Visual Studio 2003 ou 2005 de Visual Studio

Consulte também

Tarefas

Como: Configurar Diretórios Específicos Usando Configurações por Localização

Como: Bloquear definições de configuração ASP.NET

Referência

system.web Element (ASP.NET Settings Schema)

configuração Element (Geral Configurações Schema)

System.Configuration

System.Web.Configuration

AnonymousIdentificationSection

AnonymousIdentification

Conceitos

Protegendo propriedades de perfil

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

Protegendo a configuração do ASP.NET

Cenários de configuração ASP.NET

Outros recursos

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Administração de Sites do ASP.NET

API de Configuração do ASP.NET