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 в котором 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 |
Происходит после проверки подлинности запроса. |