anonymousIdentification Element (ASP.NET Settings Schema)

Artigo
08/04/2011

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

Compartilhar via

anonymousIdentification Element (ASP.NET Settings Schema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais