anonymousIdentification Element (ASP.NET Settings Schema)

Artigo
05/28/2012

[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]

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"
/>

Attributes and Elements

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

Attributes

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 consulta o navegador ou dispositivo para determinar se ele oferece suporte a 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. Note Quando você configura um aplicativo habilitado para AJAX do ASP.NET da Web, use apenas o valor padrão de UseCookies para o cookieless atributo.As configurações que usam cookies codificados em URL não são suportadas pelo processo do 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 oferece suporte a cookies.Se o dispositivo ou navegador solicitante oferece suporte a cookies, AutoDetect usa cookies para persistir 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 os cookies foram 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 de 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 a 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 é 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 que as 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 é reinicializado em cada solicitação ou em um intervalo de tempo 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 chaves de validação e descriptografia comuns. Atributos outra configuração de identificação anônima, tais como cookiePath e cookieName, devem ser iguais 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 o valor cookieless) é usado para gerenciar o identificador de anônimo do usuário. O padrão é false.

Child Elements

Nenhum.

Parent Elements

Elemento	Descrição
configuration	Especifica o elemento raiz necessários em cada arquivo de configuração que é usado pelo common language runtime e o.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.

Remarks

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ê usa o recurso de perfil.

Quando você envia o tíquete de identificação anônima no URI, você pode ultrapassar o tamanho máximo do URI. Se a combinação do tíquete de identificação anônima, de forma tíquete de autenticação, identificação de sessão, e 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> elemento não está explicitamente configurado no arquivo Machine. config ou no arquivo Web. config raiz. No entanto, ele é 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>

Element Information

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	Serviços de Informações da Internet da Microsoft (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

anonymousIdentification Element (ASP.NET Settings Schema)

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

Configuração padrão

Exemplo

Element Information

Consulte também

Tasks

Reference

Concepts

Other Resources

Recursos adicionais