anonymousIdentification 요소(ASP.NET 설정 스키마)

아티클
05/27/2012

[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]

응용 프로그램 권한 부여에 대해 익명 ID를 구성합니다. 이 ID는 권한 부여가 필요한 경우 인증되지 않은 엔터티를 식별하는 데 사용됩니다.

이 요소는 .NET Framework 버전 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"
/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
cookieless	웹 응용 프로그램에 쿠키를 사용할 것인지 여부를 지정합니다. HttpCookieMode 열거형은 구성 섹션에서 이 특성의 값을 지정하는 데 사용됩니다. 쿠키 없는 인증을 지원하는 모든 기능에서 이 열거형을 사용합니다. AutoDetect 값을 지정하면 ASP.NET에서 브라우저나 장치를 쿼리하여 쿠키가 지원되는지 여부를 확인합니다. 브라우저나 장치에서 쿠키를 지원하면 쿠키를 사용하여 사용자 데이터를 유지하고 그렇지 않으면 쿼리 문자열에 식별자를 사용합니다. Note AJAX 사용 ASP.NET 웹 사이트를 구성할 때는 cookieless 특성에 UseCookies의 기본값만 사용합니다.URL로 인코딩된 쿠키를 사용하는 설정은 ASP.NET AJAX 클라이언트 스크립트 라이브러리에서 지원되지 않습니다. 이 특성은 다음 값 중 하나일 수 있습니다. 값설명 AutoDetect ASP.NET에서 요청 브라우저 또는 장치에 쿠키가 지원되는지 여부를 확인하도록 지정합니다.요청 브라우저 또는 장치에 쿠키가 지원되면 AutoDetect는 쿠키를 사용하여 사용자 데이터를 유지하고 그렇지 않으면 쿼리 문자열에 식별자가 사용됩니다.브라우저 또는 장치에서 쿠키를 지원하지만 쿠키가 현재 비활성화되어 있는 경우에도 요청 기능에서 쿠키를 사용할 수 있습니다. UseCookies 브라우저나 장치에서 쿠키를 지원하는지 여부에 관계없이 쿠키를 사용하여 사용자 데이터를 유지하도록 지정합니다.이 값이 기본값입니다. UseDeviceProfile ASP.NET에서 HttpBrowserCapabilities 설정에 따라 쿠키 사용 여부를 결정하도록 지정합니다.브라우저 또는 장치에서 쿠키를 지원하도록 설정되어 있으면 쿠키가 사용되고, 그렇지 않으면 쿼리 문자열에 식별자가 사용됩니다. UseUri 브라우저나 장치에서 쿠키를 지원하는지 여부에 관계없이 호출 기능에서 쿼리 문자열을 사용하여 식별자를 저장하도록 지정합니다. 기본값은 "UseCookies"입니다.
cookieName	쿠키에 할당되는 이름을 지정합니다. 기본값은 ".ASPXANONYMOUS"입니다.
cookiePath	쿠키가 저장되는 디렉터리의 경로를 지정합니다. 경로는 대/소문자가 구분됩니다. 기본 위치는 "/"로 지정되는 루트 디렉터리입니다.
cookieProtection	쿠키 보호 스키마를 지정합니다. 이 특성은 다음 값 중 하나일 수 있습니다. 값설명 All Validation 값과 Encryption 값을 모두 사용하여 쿠키 정보를 보호하도록 지정합니다. Encryption 쿠키 정보를 암호화합니다. None 쿠키 정보를 보호하지 않도록 지정합니다.쿠키 정보는 일반 텍스트로 저장되며 서버로 다시 전송할 때 유효성이 검사되지 않습니다. Validation 쿠키 정보를 서버로 다시 전송하기 전에 해당 내용이 변경되지 않도록 합니다. 기본값은 "Validation"입니다.
cookieRequireSSL	쿠키를 클라이언트로 전송할 때 SSL(Secure Sockets Layer) 연결이 필요한지 여부를 지정합니다. ASP.NET에서 인증 쿠키 속성인 Secure를 설정하므로 SSL 연결을 사용하지 않으면 클라이언트에서 쿠키를 반환하지 않습니다. 기본값은 false입니다.
cookieSlidingExpiration	필수 Boolean 특성입니다. 쿠키 시간 제한을 요청할 때마다 다시 설정할지 아니면 미리 정의된 고정 시간 간격으로 다시 설정할지 지정합니다. true이면 남은 TTL(Time to Live)이 50% 미만일 때 쿠키가 종료됩니다. false이면 cookieTimeout 기간이 경과한 후에 쿠키가 종료됩니다. 기본값은 true입니다.
cookieTimeout	필수 TimeSpan 특성입니다. 쿠키 만료 시간 간격(분)을 지정합니다. 기본값은 100000분(69일, 10시간, 40분)입니다. 최대값은 2년입니다.
domain	쿠키 도메인을 지정합니다. 이 특성을 사용하면 contoso.com으로 끝나는 모든 사이트의 경우처럼 공용 DNS 네임스페이스를 가지는 도메인에서 익명 ID 쿠키를 공유할 수 있습니다. 익명 ID 쿠키를 공유하려면 사이트에서 공용 암호 해독 및 유효성 검사 키를 공유해야 합니다. cookiePath 및 cookieName 등의 기타 익명 ID 구성 특성은 모든 사이트에 대해 동일해야 합니다. 자세한 내용은 HttpCookie를 참조하십시오. 기본값은 빈 문자열("")입니다.
enabled	선택적 Boolean 특성입니다. 익명 ID를 사용할 수 있는지 여부를 지정합니다. true이면 쿠키 또는 쿠키를 사용하지 않는 값을 사용하여 해당 사용자의 익명 식별자를 관리합니다. 기본값은 false입니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.
system.web	구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 요소를 포함합니다.

설명

<anonymousIdentification> 요소는 응용 프로그램 권한 부여에 대해 익명 ID를 구성합니다. 프로필 기능을 사용할 때 인증되지 않은 엔터티를 식별하려면 이 요소가 필요합니다.

URI를 사용하여 익명 ID 티켓을 보내는 경우 최대 URI 크기를 초과할 수 있습니다. 익명 ID 티켓, 폼 인증 티켓, 세션 ID 및 사용자 데이터의 조합이 허용 가능한 최대 URI 길이보다 큰 경우에는 400-잘못된 요청 오류와 함께 요청이 실패합니다.

기본 구성

다음의 기본 <anonymousIdentification> 요소는 Machine.config 파일 또는 루트 Web.config 파일에 명시적으로 구성되어 있지 않습니다. 그러나 이 요소는 응용 프로그램에서 반환하는 기본 구성입니다.

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

예제

다음 코드 예제에서는 익명 ID에 대해 사이트를 구성하는 방법을 보여 줍니다.

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

요소 정보

구성 섹션 처리기	AnonymousIdentificationSection
구성 멤버	AnonymousIdentification
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 2.0 Microsoft Visual Studio 2003 또는 Visual Studio 2005

참고 항목