DefaultAuthenticationModule Класс

Определение

Обеспечивает присутствие в контексте объекта проверки подлинности. Этот класс не наследуется.

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 для проверки, является ли User свойство текущего экземпляра свойством HttpContext null . Если User свойство имеет значение null , то в образце User свойство текущего HttpContext экземпляра устанавливается в объект, GenericPrincipal где Identity GenericPrincipal объект является объектом GenericIdentity со Name значением "default".

Примечание

Событие DefaultAuthentication_OnAuthenticate возникает перед AuthorizeRequest событием. В результате, если User для свойства текущего HttpContext экземпляра задать пользовательское удостоверение, оно может повлиять на поведение приложения. Например, если вы используете FormsAuthentication класс и указываете <deny users="?" /> в разделе Конфигурация авторизации , чтобы убедиться, что только пользователи, прошедшие проверку подлинности, имеют доступ к сайту, этот пример приведет к игнорированию элемента Deny , так как пользователь будет иметь имя, которое является "по умолчанию". Вместо этого следует указать <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

Комментарии

Объект DefaultAuthenticationModule гарантирует, что User для свойства текущего HttpContext экземпляра задается IPrincipal объект для каждого запроса. Объект DefaultAuthenticationModule проверяет User свойство после AuthenticateRequest события и перед AuthorizeRequest событием. Если User свойство имеет значение null , DefaultAuthenticationModule User свойство устанавливает для свойства GenericPrincipal объект, который не содержит сведений о пользователе.

Если модуль проверки подлинности устанавливает StatusCode для свойства значение 401, DefaultAuthenticationModule будет отображена страница ошибки доступ запрещен. Если значение StatusCode свойства равно значению больше 200, то DefaultAuthenticationModule объект завершит запрос. В этом случае только модули HTTP, которые подписываются на EndRequest событие, вызываются до завершения текущего запроса.

Объект DefaultAuthenticationModule предоставляет Authenticate событие. Это событие можно использовать для предоставления пользовательского IPrincipal объекта для User свойства текущего HttpContext экземпляра. Доступ к этому Authenticate событию осуществляется путем указания события с именем DefaultAuthentication_OnAuthenticate в файле Global. asax приложения.

Конструкторы

DefaultAuthenticationModule()

Инициализирует новый экземпляр класса DefaultAuthenticationModule.

Методы

Dispose()

Освобождает все используемые модулем DefaultAuthenticationModule ресурсы, кроме памяти.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
Init(HttpApplication)

Выполняет инициализацию объекта DefaultAuthenticationModule.

MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

События

Authenticate

Происходит после проверки подлинности запроса.

Применяется к

См. также раздел