DefaultAuthenticationModule Klasse

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Stellt sicher, dass ein Authentifizierungsobjekt im Kontext vorhanden ist. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

DefaultAuthenticationModule

Implementiert

IHttpModule

Beispiele

Im folgenden Beispiel wird das DefaultAuthentication_OnAuthenticate-Ereignis verwendet, um zu testen, ob die User -Eigenschaft der aktuellen HttpContext Instanz ist null. Wenn die User -Eigenschaft ist null, legt das Beispiel die User -Eigenschaft der aktuellen HttpContext Instanz auf ein GenericPrincipal -Objekt fest, wobei der Identity des GenericPrincipal -Objekts ein GenericIdentity mit dem Name Wert "default" ist.

Hinweis

Das DefaultAuthentication_OnAuthenticate-Ereignis wird vor dem AuthorizeRequest Ereignis ausgelöst. Wenn Sie die User -Eigenschaft der aktuellen HttpContext Instanz auf eine benutzerdefinierte Identität festlegen, kann sich dies auf das Verhalten Ihrer Anwendung auswirken. Wenn Sie beispielsweise die FormsAuthentication -Klasse verwenden und im Abschnitt zur Autorisierungskonfiguration angeben<deny users="?" />, um sicherzustellen, dass nur authentifizierte Benutzer Zugriff auf Ihre Website haben, wird in diesem Beispiel das Deny-Element ignoriert, da der Benutzer einen Namen hat, der "Standard" lautet. Stattdessen würden Sie angeben<deny users="default" />, um sicherzustellen, dass nur authentifizierte Benutzer auf Ihre Website zugreifen können.

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

Hinweise

Stellt DefaultAuthenticationModule sicher, dass die User -Eigenschaft der aktuellen HttpContext Instanz für jede Anforderung auf ein IPrincipal -Objekt festgelegt wird. Die DefaultAuthenticationModule untersucht die User -Eigenschaft nach dem AuthenticateRequest -Ereignis und vor dem AuthorizeRequest -Ereignis. Wenn die User -Eigenschaft ist null, DefaultAuthenticationModule legt die - User Eigenschaft auf ein GenericPrincipal -Objekt fest, das keine Benutzerinformationen enthält.

Wenn das Authentifizierungsmodul die StatusCode -Eigenschaft auf 401 festlegt, DefaultAuthenticationModule wird eine Fehlerseite mit Zugriff verweigert gerendert. Wenn der Wert der StatusCode -Eigenschaft auf einen Wert größer als 200 festgelegt ist, beendet das DefaultAuthenticationModule Objekt die Anforderung. In diesem Fall werden vor Abschluss der aktuellen Anforderung nur HTTP-Module aufgerufen, die das EndRequest Ereignis abonnieren.

Macht DefaultAuthenticationModule ein Authenticate -Ereignis verfügbar. Sie können dieses Ereignis verwenden, um ein benutzerdefiniertes IPrincipal Objekt für die User -Eigenschaft der aktuellen HttpContext Instanz bereitzustellen. Auf Authenticate das Ereignis wird zugegriffen, indem ein Ereignis namens DefaultAuthentication_OnAuthenticate in der Datei Global.asax der Anwendung angegeben wird.

Konstruktoren

DefaultAuthenticationModule()

Initialisiert eine neue Instanz der DefaultAuthenticationModule-Klasse.

Methoden

Dispose()	Gibt alle Ressourcen mit Ausnahme des Arbeitsspeichers frei, die vom DefaultAuthenticationModule verwendet werden.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Init(HttpApplication)	Initialisiert das DefaultAuthenticationModule-Objekt.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

Authenticate

Tritt ein, nachdem die Anforderung authentifiziert wurde.

Weitere Informationen

• ASP.NET-Authentifizierung