DefaultAuthenticationModule Klasse

  • Referenz

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 des aktuellen HttpContext instance istnull. Wenn die User -Eigenschaft istnull, legt das Beispiel die User Eigenschaft des aktuellen HttpContext instance auf ein GenericPrincipal Objekt fest, bei dem das 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 also die User Eigenschaft des aktuellen HttpContext instance auf eine benutzerdefinierte Identität festlegen, kann dies das Verhalten Ihrer Anwendung beeinflussen. Wenn Sie beispielsweise die FormsAuthentication -Klasse verwenden und im Abschnitt 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 geben Sie an<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 des aktuellen HttpContext instance für jede Anforderung auf ein IPrincipal Objekt festgelegt ist. Die DefaultAuthenticationModule untersucht die User Eigenschaft nach dem AuthenticateRequest Ereignis und vor dem AuthorizeRequest Ereignis. Wenn die User -Eigenschaft ist null, legt die DefaultAuthenticationModule - 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 Zugriffsverweigerung 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 nur HTTP-Module aufgerufen, die das EndRequest Ereignis abonnieren, bevor die aktuelle Anforderung abgeschlossen wird.

Macht DefaultAuthenticationModule ein Authenticate Ereignis verfügbar. Sie können dieses Ereignis verwenden, um ein benutzerdefiniertes IPrincipal Objekt für die User Eigenschaft des aktuellen HttpContext instance bereitzustellen. Auf Authenticate das Ereignis wird zugegriffen, indem ein Ereignis mit dem Namen DefaultAuthentication_OnAuthenticate in der Global.asax-Datei 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.

Gilt für:

Weitere Informationen