Podelement anonymousIdentification elementu httpHandlers (schéma nastavení ASP.NET)

Článek
08/11/2011

Konfiguruje anonymní identifikaci pro ověření aplikace. To je nutné k rozpoznání entit, které nejsou ověřovány v případě požadování autorizace.

Tento element je v rozhraní .NET Framework verze 2.0 nový.

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
cookieless	Určuje, zda u webové aplikace použít soubory cookie. Výčet HttpCookieMode se používá v konfiguračním oddílu k určení hodnoty pro tento atribut. Je použit všemi funkcemi, které podporují ověřování bez souborů cookie. Pokud je nastavena hodnota AutoDetect, dotáže se technologie ASP.NET prohlížeče nebo zařízení, zda podporuje soubory cookie. Pokud prohlížeč nebo zařízení podporuje soubory cookie, jsou soubory cookie použity k uchování uživatelských dat. Jinak je identifikátor použit v dotazovacím řetězci. Poznámka Při konfiguraci webové stránky ASP.NET s podporou technologie AJAX, používejte pouze výchozí hodnotu UseCookies pro atribut cookieless.Nastavení, která používají cookie kódované v adrese URL, nejsou podporována knihovnami klientských skriptů AJAX technologie ASP.NET. Tento atribut může nabývat jedné z následujících možných hodnot. HodnotaPopis AutoDetect Označuje, že technologie ASP.NET určí, zda dotazující se prohlížeč nebo zařízení podporuje soubory cookie.Pokud dotazující se prohlížeč nebo zařízení podporuje soubory cookie, použije AutoDetect cookie k uchování uživatelských dat. Jinak je identifikátor použit v dotazovacím řetězci.Pokud prohlížeč nebo zařízení podporuje soubory cookie, ale soubory cookie jsou aktuálně neaktivní, jsou soubory cookie nadále používány dotazovací funkcí. UseCookies Určuje, že soubory cookie uchovávají data uživatele bez ohledu na to, zda prohlížeč nebo zařízení podporuje soubory cookie.Tato možnost je výchozí. UseDeviceProfile Určuje, že technologie ASP.NET rozhodne, zda použít soubory cookie na základě nastavení HttpBrowserCapabilities. Pokud nastavení udává, že prohlížeč nebo zařízení podporuje soubory cookie, jsou soubory cookie používány. Jinak je identifikátor použit v dotazovacím řetězci. UseUri Určuje, že volání funkce používá řetězec dotazu k uložení identifikátoru, bez ohledu na to, zda prohlížeč nebo zařízení podporuje soubory cookie. Výchozí je "UseCookies".
cookieName	Určuje název, který je přiřazen ke cookie. Výchozí hodnota je ".ASPXANONYMOUS".
cookiePath	Určuje cestu k adresáři, kde je uložen soubor cookie. V cestě se rozlišují malá a velká písmena. Výchozí hodnota je kořenový adresář určený pomocí "/".
cookieProtection	Určuje schéma ochrany souboru cookie. Tento atribut může nabývat jedné z následujících možných hodnot. HodnotaPopis All Určuje, že se obě hodnoty, Validation a Encryption, používají k ochraně informací v souborech cookie. Encryption Šifruje informace v souboru cookie. None Určuje, že informace v souboru cookie není chráněna.Informace v souboru cookie je uložena jako prostý text a není ověřena při odeslání zpět na server. Validation Zajišťuje, že informace v souboru cookie nebyla změněna před odesláním zpět na server. Výchozí je "Validation".
cookieRequireSSL	Určuje, zda soubor cookie vyžaduje připojení protokolem SSL (Secure Sockets Layer) při přenosu ke klientovi. Vzhledem k tomu, že technologie ASP.NET nastavuje vlastnost ověřování souboru cookie Secure, nevrátí klient soubor cookie dokud není navázáno připojení protokolem SSL. Výchozí je false.
cookieSlidingExpiration	Požadovaný atribut typu Boolean Určuje, zda je časový limit souboru cookie resetován s každou žádostí nebo v předdefinovaný pevný časový interval. V případě hodnoty true nastane časový limit souboru cookie, pokud zbývá méně než 50 procent hodnoty TTL (Time to Live). V případě hodnoty false vyprší soubor cookie po dosažení délky cookieTimeout. Výchozí hodnota je true.
cookieTimeout	Požadovaný atribut typu TimeSpan. Určuje časový interval (v minutách) vypršení platnosti souboru cookie. Výchozí hodnota je 100000 minut (69 dnů, 10 hodin, a 40 minut). Maximální hodnota je 2 roky.
domain	Určuje doménu souborů cookie. Tento atribut umožňuje sdílení souboru cookie s anonymní identifikací napříč doménami, které mají společný obor názvů DNS (například všechny weby, které končí contoso.com). Chcete-li sdílet soubory cookie anonymní identifikace, musí weby sdílet společné dešifrování a ověřování klíčů. Jiné konfigurační atributy anonymní identifikace, například cookiePath a cookieName, musí být stejné pro všechny weby. Další informace naleznete v tématu HttpCookie. Výchozí hodnota je prázdný řetězec ("").
enabled	Nepovinný atribut Boolean. Určuje, zda je povolena anonymní identifikace. V případě true je soubor cookie (nebo hodnota bez souboru cookie) použita ke správě anonymního identifikátoru uživatele. Výchozí je false.

Podřízené prvky

Žádný

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element konfiguračního souboru s nastavením konfigurace technologie ASP.NET a obsahuje konfigurační prvky, které konfigurují webové aplikace ASP.NET a řídí chování aplikací.

Poznámky

Element <anonymousIdentification> konfiguruje anonymní identifikaci pro autorizaci aplikace. To je nutné k označení entit, které nejsou ověřovány, pokud použijete funkce profilu.

Při odeslání anonymního identifikátoru můžete překročit maximální velikost identifikátoru URI. Pokud je kombinace lístku anonymní identifikace, lístku ověřovacího formuláře, ID relace a dat uživatele větší než je maximální přípustná délka identifikátoru URI, žádost se nezdaří s chybou 400 - Špatný požadavek.

Výchozí konfigurace

Následující výchozí element <anonymousIdentification> není explicitně nakonfigurován v souboru Machine.config nebo v kořenovém souboru web.config. To je však výchozí konfigurace, kterou vrací aplikace.

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

Příklad

Následující příklad kódu demonstruje konfiguraci webu pro anonymní identifikaci.

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

Informace prvku

Obslužná rutina konfiguračního oddílu	AnonymousIdentificationSection
Konfigurační člen	AnonymousIdentification
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework verze 2.0 Microsoft Visual Studio 2003 nebo Visual Studio 2005

Viz také

Sdílet prostřednictvím

Podelement anonymousIdentification elementu httpHandlers (schéma nastavení ASP.NET)

Atributy a prvky

v případě vícehodnotových atributů

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály