anonymousIdentification elementu (ASP.Schemat ustawień netto)
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Konfiguruje identyfikator anonimowy dla aplikacji autoryzacji. Jest to wymagane do identyfikacji jednostek, które nie są uwierzytelniane, gdy wymagane jest zezwolenie.
Ten element jest nowego w.NET Framework w wersji 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"
/>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty i elementy podrzędne elementy nadrzędne.
Atrybuty
Atrybut |
Opis |
---|---|
cookieless |
Określa, czy używać plików cookie dla aplikacji sieci Web. HttpCookieMode Wyliczenie jest używana do określenia wartości dla tego atrybutu w sekcji konfiguracji. Jest on używany przez wszystkie funkcje, które obsługują uwierzytelnianie cookieless. Gdy AutoDetect wartość jest określona, ASP.NET kwerendy przeglądarki lub urządzenie, aby ustalić, czy obsługuje on pliki cookie. Jeśli przeglądarka lub urządzenie obsługuje pliki cookie, pliki cookie są używane do utrwalania danych użytkownika; w przeciwnym razie identyfikator jest używany w ciągu kwerendy.
Note
Po skonfigurowaniu aplikacji ASP z obsługą technologii AJAX.NET witryny sieci Web, należy użyć tylko wartości domyślne z UseCookies do cookieless atrybut.Ustawienia, które używają plików cookie zakodowane w adresie URL nie są obsługiwane przez program ASP.NET AJAX bibliotek skrypt klienta.
Ten atrybut może być jedną z następujących możliwych wartości.
WartośćOpis
AutoDetect Określa, że program ASP.NET określa, czy wnioskujący przeglądarki lub urządzenie obsługuje pliki cookie.Jeżeli wnioskujące przeglądarki lub urządzenie obsługuje pliki cookie, AutoDetect używa plików cookie do utrwalania danych użytkownika; w przeciwnym razie identyfikator jest używany w ciągu kwerendy.Jeśli przeglądarka lub urządzenie obsługuje pliki cookie, ale pliki cookie są aktualnie wyłączone, pliki cookie są nadal używane przez funkcję wnioskującego.
UseCookies Określa, że pliki cookie są używane do utrwalania danych użytkownika, niezależnie od tego, czy przeglądarka lub urządzenie obsługuje pliki cookie.Jest to wartość domyślna.
UseDeviceProfile Określa, że program ASP.NET określa, czy używać plików cookie oparte na HttpBrowserCapabilities ustawienie.Jeśli ustawienie wskazuje obsługuje pliki cookie do przeglądarki lub urządzenia, pliki cookie są używane; w przeciwnym razie identyfikator jest używany w ciągu kwerendy.
UseUri Określa, że wywołania funkcji używa ciąg kwerendy do przechowywania identyfikatora, niezależnie od tego, czy przeglądarka lub urządzenie obsługuje pliki cookie.
Wartością domyślną jest "UseCookies". |
cookieName |
Określa nazwę, która jest przypisana do pliku cookie. Wartością domyślną jest ".ASPXANONYMOUS". |
cookiePath |
Określa ścieżkę do katalogu, w którym jest przechowywany plik cookie. Ścieżka jest uwzględniana wielkość liter. Wartością domyślną jest katalogu głównego, który jest określony przez "/". |
cookieProtection |
Określa system ochrony plików cookie. Ten atrybut może być jedną z następujących możliwych wartości.
WartośćOpis
All Określa, że zarówno Validation i Encryption wartości są używane do ochrony informacji w pliku cookie.
Encryption Szyfruje informacje w pliku cookie.
None Określa, że informacje o pliku cookie nie jest chroniony.Informacje w pliku cookie są przechowywane w postaci zwykłego tekstu i nie jest sprawdzana, kiedy informacja jest wysyłana z serwerem.
Validation Zapewnia, że informacje zawarte w pliku cookie nie została zmieniona przed wysłaniem informacji do serwera.
Wartością domyślną jest "Validation". |
cookieRequireSSL |
Określa, czy plik cookie jest on transmitowany do klienta, wymaga połączenia Secure Sockets Layer (SSL). Ponieważ program ASP.NET ustawia właściwość pliku cookie uwierzytelniania, Secure, chyba, że używane jest połączenie SSL, klient nie zwraca pliku cookie. Wartością domyślną jest false. |
cookieSlidingExpiration |
Wymagane Boolean atrybut. Określa, czy limit czasu plików cookie jest resetowany, na każde żądanie lub na wstępnie zdefiniowanego interwału stałych. Jeśli true, limit czasu plików cookie występuje, kiedy pozostanie mniej niż 50 procent czasu wygaśnięcia (TTL). Jeśli false, razy plik cookie out po cookieTimeout upłynął czas trwania. Wartością domyślną jest true. |
cookieTimeout |
Wymagane TimeSpan atrybut. Określa interwał czasu wygaśnięcia pliku cookie, w minutach. Wartością domyślną jest 100000 minut (69 dni, 10 godzin, a 40 minut). Maksymalna wartość to 2 lata. |
domain |
Określa domeny pliku cookie. Atrybut ten umożliwia cookie anonimowe identyfikacji ma być udostępniony w domenach, które mają wspólne nazw DNS (na przykład wszystkie witryny, które kończą się contoso.com). Aby udostępnić pliki cookie identyfikacji anonimowe, witryn należy udostępnić odszyfrowywania wspólne i klucze sprawdzania poprawności. Inne anonimowy identyfikator konfiguracji atrybuty, takie jak cookiePath i cookieName, musi być taka sama dla wszystkich witryn. Aby uzyskać więcej informacji, zobacz HttpCookie. Wartością domyślną jest ciąg pusty (""). |
enabled |
Opcjonalny Boolean atrybut. Określa, czy jest włączone anonimowe identyfikacji. Jeśli true, plik cookie (lub wartość cookieless) jest używana do zarządzania anonimowy identyfikator użytkownika. Wartością domyślną jest false. |
Elementy podrzędne
Brak.
Elementy nadrzędne
Element |
Opis |
---|---|
configuration |
Określa element główny wymagane w każdym pliku konfiguracyjnym, który jest używany przez aparatu plików wykonywalnych języka wspólnego oraz.NET Framework aplikacji. |
system.web |
Określa element główny dla aplikacji ASP.Ustawienia konfiguracji netto w konfiguracji pliku i zawiera elementy, które konfigurowania aplikacji ASP.NET aplikacje sieci Web i kontrolować zachowanie tych aplikacji. |
Uwagi
<anonymousIdentification> Element konfiguruje anonimowy identyfikator aplikacji autoryzacji. Jest to wymagane do identyfikacji jednostek, które nie są uwierzytelniane przy użyciu funkcji profilu.
Maksymalny rozmiar identyfikatora URI może przekroczyć podczas wysyłania bilet identyfikacji anonimowe w identyfikatorze URI. Jeśli kombinacja bilet anonimowy identyfikator formularze biletu uwierzytelniania, identyfikator sesji i dane użytkownika jest większa niż maksymalna dopuszczalna długość identyfikatora URI, nie powiedzie się błędem żądania 400-Złe żądanie.
Domyślna konfiguracja
Następujące domyślne <anonymousIdentification> element nie jest jawnie skonfigurowane w pliku Machine.config lub głównego pliku Web.config. Jednakże jest domyślnej konfiguracji, który jest zwracany przez aplikację.
<anonymousIdentification
enabled="false"
cookieName=".ASPXANONYMOUS"
cookieTimeout="100000"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration="true"
cookieProtection="Validation"
cookieless="UseCookies"
domain=""
/>
Przykład
Poniższy przykład kodu demonstruje, jak skonfigurować witrynę do identyfikacji anonimowe.
<configuration>
<system.web>
<anonymousIdentification
enabled="true"
cookieless="UseCookies"
cookieName=".ASPXANONYMOUS"
cookieTimeout="30"
cookiePath="/"
cookieRequireSSL="false"
cookieSlidingExpiration = "true"
cookieProtection="Clear"
/>
</system.web>
</configuration>
Informacje o elementach
Program obsługi sekcji konfiguracji |
|
Członkowskie konfiguracji |
|
Lokalizacje konfigurowalne |
Machine.config Web.config na poziomie katalogu głównego Poziom aplikacji Web.config |
Wymagania |
Microsoft Internet Information Services (IIS) w wersji 5.0, 5.1 lub 6.0 .NET Framework w wersji 2.0 Microsoft Visual Studio 2003 lub Visual Studio 2005 |
Zobacz też
Zadania
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Informacje
System.Web elementu (ASP.Schemat ustawień netto)
Konfiguracja elementu (schemat ustawień ogólne)
AnonymousIdentificationSection
Koncepcje
ASP.NET Configuration File Hierarchy
Inne zasoby
Ogólne ustawienia konfiguracji (ASP.(NET)
ASP.NET ustawienia konfiguracji