DefaultAuthenticationModule Класс

  • Ссылка

Определение

Пространство имен:
System.Web.Security
Сборка:
System.Web.dll

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

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
Наследование
Object
DefaultAuthenticationModule
Реализации
IHttpModule

Примеры

В следующем примере событие DefaultAuthentication_OnAuthenticate используется для проверки того, User имеет ли свойство текущего HttpContext экземпляра значение null. User Если свойство имеет значение null, то в примере свойству User текущего HttpContext экземпляра присваивается объект , GenericPrincipal в котором IdentityGenericPrincipal объект является GenericIdentity объектом со значением Name default.

Примечание

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

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

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

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