DefaultAuthenticationModule Klasa

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Gwarantuje, że obiekt uwierzytelniania jest obecny w kontekście. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

DefaultAuthenticationModule

Implementuje

IHttpModule

Przykłady

W poniższym przykładzie użyto zdarzenia DefaultAuthentication_OnAuthenticate , aby sprawdzić, czy User właściwość bieżącego HttpContext wystąpienia to null. User Jeśli właściwość to null, przykład ustawia User właściwość bieżącego HttpContext wystąpienia na GenericPrincipal obiekt, w którym IdentityGenericPrincipal obiekt jest GenericIdentity obiektem o Name wartości "default".

Uwaga

Zdarzenie DefaultAuthentication_OnAuthenticate jest zgłaszane przed zdarzeniem AuthorizeRequest . W związku z tym ustawienie User właściwości bieżącego HttpContext wystąpienia na tożsamość niestandardową może mieć wpływ na zachowanie aplikacji. Jeśli na przykład używasz FormsAuthentication klasy i określisz <deny users="?" /> w sekcji konfiguracji autoryzacji , aby upewnić się, że tylko uwierzytelnieni użytkownicy mają dostęp do witryny, ten przykład spowoduje zignorowanie elementu odmowy , ponieważ użytkownik będzie miał nazwę , która jest "domyślna". Zamiast tego należy określić <deny users="default" /> , aby zagwarantować, że tylko uwierzytelnieni użytkownicy będą mogli uzyskiwać dostęp do witryny.

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

Uwagi

Zapewnia DefaultAuthenticationModule , że User właściwość bieżącego HttpContext wystąpienia jest ustawiona na IPrincipal obiekt dla każdego żądania. Właściwość DefaultAuthenticationModule sprawdza po UserAuthenticateRequest zdarzeniu i przed zdarzeniem AuthorizeRequest . User Jeśli właściwość ma nullwartość , DefaultAuthenticationModule właściwość ustawia User właściwość na GenericPrincipal obiekt, który nie zawiera informacji o użytkowniku.

Jeśli moduł uwierzytelniania ustawi StatusCode właściwość na 401, DefaultAuthenticationModule spowoduje to renderowanie strony błędu odmowy dostępu. Jeśli wartość StatusCode właściwości jest ustawiona na wartość większą niż 200, DefaultAuthenticationModule obiekt zakończy żądanie. W takim przypadku tylko moduły HTTP, które subskrybują EndRequest zdarzenie, są wywoływane przed ukończeniem bieżącego żądania.

Obiekt DefaultAuthenticationModule uwidacznia Authenticate zdarzenie. To zdarzenie umożliwia podanie obiektu niestandardowego IPrincipal dla User właściwości bieżącego HttpContext wystąpienia. Do Authenticate zdarzenia uzyskuje się dostęp, określając zdarzenie o nazwie DefaultAuthentication_OnAuthenticate w pliku Global.asax aplikacji.

Konstruktory

DefaultAuthenticationModule()

Inicjuje nowe wystąpienie klasy DefaultAuthenticationModule.

Metody

Dispose()	Zwalnia wszystkie zasoby, inne niż pamięć, używane przez program DefaultAuthenticationModule.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
Init(HttpApplication)	Inicjuje DefaultAuthenticationModule obiekt.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Authenticate

Występuje po uwierzytelnieniu żądania.

Zobacz też

• Uwierzytelnianie ASP.NET