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

아티클
05/27/2012

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

역할 관리에 대한 응용 프로그램을 구성합니다.

이 요소는 .NET Framework 버전 2.0에서 새로 도입되었습니다.

<roleManager
    cacheRolesInCookie="true|false"
    cookieName="name"
    cookiePath="/"
    cookieProtection="All|Encryption|Validation|None"
    cookieRequireSSL="true|false "
    cookieSlidingExpiration="true|false "
    cookieTimeout="number of minutes"
    createPersistentCookie="true|false"
    defaultProvider="provider name"
    domain="cookie domain">
    enabled="true|false"
    maxCachedResults="maximum number of role names cached"
    <providers>...</providers>
</roleManager>

특성 및 요소

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

특성

특성	설명
cacheRolesInCookie	선택적 Boolean 특성입니다. 사용자가 특정 역할에 포함되어 있는지 확인하는 경우 역할 공급자를 사용하여 데이터 소스의 역할 목록을 검사하기 전에 쿠키를 검사하도록 지정합니다. true이면 현재 사용자에 대해 쿠키의 역할 이름 목록이 캐시되고, 그렇지 않으면 false입니다. 기본값은 false입니다.
cookieName	선택적 String 특성입니다. 역할 이름이 저장되어 있는 쿠키의 이름을 지정합니다. 기본값은 ".ASPXROLES"입니다.
cookiePath	선택적 String 특성입니다. 역할 이름 쿠키의 경로입니다. 기본값은 "/"입니다.
cookieProtection	선택적 CookieProtection 특성입니다. CookieProtection 열거형 값 중 하나를 지정합니다. 기본값은 All입니다.
cookieRequireSSL	선택적 Boolean 특성입니다. 역할 이름 쿠키를 서버에 전달할 때 SSL을 사용해야 할지 여부를 지정합니다. true로 설정하면 역할 이름 쿠키를 서버에 전달할 때 SSL을 사용해야 합니다. 기본값은 false입니다.
cookieSlidingExpiration	선택적 Boolean 특성입니다. 역할 이름 쿠키의 만료 날짜 및 시간을 정기적으로 다시 설정할지 여부를 지정합니다. true로 설정하면 처음에는 현재 날짜 및 시간에 CookieTimeout 값(분)을 더한 값으로 쿠키 만료가 설정됩니다. 사용자가 ASP.NET 응용 프로그램을 계속 사용하는 동안 남은 CookieTimeout 값이 50% 미만이 되면 쿠키의 만료 날짜 및 시간이 자동으로 업데이트됩니다. 자세한 내용은 Expires를 참조하십시오. 기본값은 true입니다.
cookieTimeout	선택적 Int32 특성입니다. 역할 이름 쿠키가 만료되기 전에 경과해야 하는 시간(분)입니다. 기본값은 "30"(분)입니다.
createPersistentCookie	선택적 Boolean 특성입니다. 역할 이름 쿠키가 세션 쿠키인지 여부, 즉 브라우저를 닫으면 쿠키가 손실되는지 여부를 지정합니다. true로 설정하면 역할 이름 쿠키는 여러 브라우저 세션에서 사용할 수 있는 영구 쿠키가 됩니다. 영구 쿠키의 만료 날짜 및 시간은 현재 날짜 및 시간에 CookieTimeout 값(분)을 더한 값으로 설정됩니다. 기본값은 false입니다.
defaultProvider	선택적 String 특성입니다. 기본 역할 공급자 이름입니다. 자세한 내용은 Provider를 참조하십시오. 기본값은 "AspNetSqlRoleProvider"입니다.
domain	선택적 String 특성입니다. 역할 이름 쿠키의 Domain 값을 지정합니다. 기본값은 HttpCookie 속성 기본값으로 빈 문자열("")입니다.
enabled	선택적 Boolean 특성입니다. 역할 관리를 사용할지 여부를 지정합니다. true로 설정하면 역할 관리가 사용됩니다. 기본값은 Machine.config 파일에서 false입니다.
maxCachedResults	선택적 Int32 특성입니다. 역할 쿠키에 캐시되는 역할 이름의 최대 개수를 지정합니다. 기본값은 25입니다.
상속된 특성	선택적 특성입니다. 모든 section 요소가 상속하는 특성입니다. 자세한 내용은 section 요소에서 상속된 일반 특성을 참조하십시오.

자식 요소

요소	설명
providers	선택적 요소입니다. 역할 관리에 대한 역할 공급자의 컬렉션을 정의합니다.

providers

선택적 요소입니다.

역할 관리에 대한 역할 공급자의 컬렉션을 정의합니다.

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.
system.web	ASP.NET 구성 섹션의 루트 요소를 지정합니다.

설명

roleManager 요소는 역할 관리에 대한 응용 프로그램을 구성합니다.

응용 프로그램 코드에서 roleManager 요소의 구성 값에 액세스하여 수정하는 방법에 대한 내용은 RoleManagerSection을 참조하십시오.

기본 구성

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

<roleManager 
   enabled="false" 
   cacheRolesInCookie="false" 
   cookieName=".ASPXROLES" 
   cookieTimeout="30" 
   cookiePath="/" 
   cookieRequireSSL="false" 
   cookieSlidingExpiration="true" 
   cookieProtection="All" 
   defaultProvider="AspNetSqlRoleProvider" 
   createPersistentCookie="false" 
   maxCachedResults="25">
   <providers>
      <clear />
      <add 
         connectionStringName="LocalSqlServer" 
         applicationName="/" 
         name="AspNetSqlRoleProvider" 
         type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
      <add 
         applicationName="/" 
         name="AspNetWindowsTokenRoleProvider" 
         type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
   </providers>
</roleManager>

예제

다음 코드 예제에서는 SqlRoleProvider 클래스를 사용하여 역할 정보를 저장하고 검색하도록 ASP.NET 응용 프로그램을 구성하는 방법을 보여 줍니다.

<configuration>
  <system.web>
    <roleManager defaultProvider="SqlProvider" 
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="false"
      cookieSlidingExpiration="true"
      cookieProtection="All" >
      <providers>
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices" 
          applicationName="SampleApplication" />
      </providers>
    </roleManager>
  </system.web>
</configuration>

요소 정보

구성 섹션 처리기	RoleManagerSection
구성 멤버	RoleManager
구성 가능한 위치	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

참고 항목