DefaultAuthenticationModule 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
인증 개체가 컨텍스트에 있는지 확인합니다. 이 클래스는 상속할 수 없습니다.
public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule
public sealed class DefaultAuthenticationModule : System.Web.IHttpModule
type DefaultAuthenticationModule = class
interface IHttpModule
Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule
- 상속
-
DefaultAuthenticationModule
- 구현
예제
다음 예제에서는 DefaultAuthentication_OnAuthenticate 이벤트를 사용하여 현재 HttpContext 인스턴스의 속성이 있는지 여부를 User 테스트합니다null. 속성이 User 면 샘플은 null현재 HttpContext 인스턴스 GenericPrincipal 의 속성을 개체의 GenericPrincipal 값이 Identity "default"인 개체 GenericIdentity 로 Name 설정합니다User.
메모
DefaultAuthentication_OnAuthenticate 이벤트는 이벤트 전에 발생합니다AuthorizeRequest. 따라서 현재 HttpContext 인스턴스의 속성을 사용자 지정 ID로 설정 User 하면 애플리케이션의 동작에 영향을 줄 수 있습니다. 예를 들어 클래스를 FormsAuthentication 사용하고 인증된 사용자만 사이트에 액세스할 수 있도록 권한 부여 구성 섹션에서 지정 <deny users="?" /> 하는 경우 이 샘플에서는 사용자가 "기본값"인 이름을 가지기 때문에 거부 요소가 무시됩니다. 대신 인증된 사용자만 사이트에 액세스할 수 있도록 지정 <deny users="default" /> 합니다.
public void DefaultAuthentication_OnAuthenticate(object sender,
DefaultAuthenticationEventArgs args)
{
if (args.Context.User == null)
args.Context.User =
new System.Security.Principal.GenericPrincipal(
new System.Security.Principal.GenericIdentity("default"),
new String[0]);
}
Public Sub DefaultAuthentication_OnAuthenticate(sender As Object, _
args As DefaultAuthenticationEventArgs)
If args.Context.User Is Nothing Then
args.Context.User = _
new System.Security.Principal.GenericPrincipal( _
new System.Security.Principal.GenericIdentity("default"), _
new String(0) {})
End If
End Sub
설명
현재 DefaultAuthenticationModuleHttpContext 인스턴스의 User 속성이 각 요청에 대한 개체로 IPrincipal 설정되어 있는지 확인합니다. 이벤트 DefaultAuthenticationModule 뒤 AuthenticateRequest 와 이벤트 전에 속성을 검사 User 합니다AuthorizeRequest. 속성이 UsernullDefaultAuthenticationModule 면 사용자 정보가 없는 개체로 GenericPrincipal 속성을 설정합니다User.
인증 모듈이 StatusCode 속성을 401 DefaultAuthenticationModule 로 설정하면 액세스 거부 오류 페이지가 렌더링됩니다. 속성 값 StatusCode 이 200보다 큰 값으로 설정되면 개체가 DefaultAuthenticationModule 요청을 종료합니다. 이 경우 현재 요청이 완료되기 전에 이벤트를 구독하는 EndRequest HTTP 모듈만 호출됩니다.
이벤트를 DefaultAuthenticationModule 노출합니다 Authenticate . 이 이벤트를 사용하여 현재 HttpContext 인스턴스의 속성에 User 대한 사용자 지정 IPrincipal 개체를 제공할 수 있습니다. 애플리케이션 Authenticate 의 Global.asax 파일에서 DefaultAuthentication_OnAuthenticate 이벤트를 지정하여 이벤트에 액세스합니다.
생성자
| Name | Description |
|---|---|
| DefaultAuthenticationModule() |
DefaultAuthenticationModule 클래스의 새 인스턴스를 초기화합니다. |
메서드
| Name | Description |
|---|---|
| Dispose() |
에서 사용하는 메모리를 제외한 모든 리소스를 DefaultAuthenticationModule해제합니다. |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object) |
| GetHashCode() |
기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object) |
| GetType() |
현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object) |
| Init(HttpApplication) |
초기화는 DefaultAuthenticationModule 개체입니다. |
| MemberwiseClone() |
현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
이벤트
| Name | Description |
|---|---|
| Authenticate |
요청이 인증된 후에 발생합니다. |