DefaultAuthenticationModule Klasse

Definition

Stellt sicher, dass ein Authentifizierungsobjekt im Kontext vorhanden ist.Ensures that an authentication object is present in the context. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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
DefaultAuthenticationModule
Implementiert

Beispiele

Im folgenden Beispiel wird das DefaultAuthentication_OnAuthenticate -Ereignis verwendet, um zu testen, ob die- User Eigenschaft der aktuellen HttpContext Instanz ist null .The following example uses the DefaultAuthentication_OnAuthenticate event to test whether the User property of the current HttpContext instance is null. Wenn die- User Eigenschaft null auf festgelegt ist, wird im Beispiel die- User Eigenschaft der aktuellen Instanz auf ein-Objekt festgelegt, bei dem der HttpContext des- GenericPrincipal Identity GenericPrincipal Objekts ein GenericIdentity mit dem Name Wert "Default" ist.If the User property is null, then the sample sets the User property of the current HttpContext instance to a GenericPrincipal object where the Identity of the GenericPrincipal object is a GenericIdentity with a Name value of "default."

Hinweis

Das DefaultAuthentication_OnAuthenticate -Ereignis wird vor dem- AuthorizeRequest Ereignis ausgelöst.The DefaultAuthentication_OnAuthenticate event is raised before the AuthorizeRequest event. Wenn Sie also die- User Eigenschaft der aktuellen HttpContext Instanz auf eine benutzerdefinierte Identität festlegen, kann sich dies auf das Verhalten der Anwendung auswirken.As a result, if you set the User property of the current HttpContext instance to a custom identity, it can affect the behavior of your application. Wenn Sie z. b. die FormsAuthentication -Klasse verwenden und <deny users="?" /> im Abschnitt zur Autorisierungs Konfiguration angeben, um sicherzustellen, dass nur authentifizierte Benutzer auf Ihre Website zugreifen können, wird in diesem Beispiel das Deny -Element ignoriert, da der Benutzer einen Namen hat, der "Default" lautet.For example, if you are using the FormsAuthentication class and you specify <deny users="?" /> in the authorization configuration section to ensure that only authenticated users have access to your site, this sample will cause the deny element to be ignored, as the user will have a name, which is "default." Stattdessen geben Sie an, <deny users="default" /> um sicherzustellen, dass nur authentifizierte Benutzer auf Ihre Website zugreifen können.Instead, you would specify <deny users="default" /> to ensure that only authenticated users can access your site.

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

Der DefaultAuthenticationModule stellt sicher, dass die- User Eigenschaft der aktuellen HttpContext Instanz auf ein- IPrincipal Objekt für jede Anforderung festgelegt ist.The DefaultAuthenticationModule ensures that the User property of the current HttpContext instance is set to an IPrincipal object for each request. Unter DefaultAuthenticationModule sucht die User -Eigenschaft nach dem AuthenticateRequest -Ereignis und vor dem- AuthorizeRequest Ereignis.The DefaultAuthenticationModule examines the User property after the AuthenticateRequest event and before the AuthorizeRequest event. Wenn die- User Eigenschaft ist null , DefaultAuthenticationModule legt die- User Eigenschaft auf ein-Objekt fest, GenericPrincipal das keine Benutzerinformationen enthält.If the User property is null, the DefaultAuthenticationModule sets the User property to a GenericPrincipal object that contains no user information.

Wenn das Authentifizierungs Modul die- StatusCode Eigenschaft auf 401 festlegt, DefaultAuthenticationModule wird die Fehlerseite "Zugriff verweigert" gerenbt.If the authentication module sets the StatusCode property to 401, the DefaultAuthenticationModule will render an access-denied error page. Wenn der Wert der- StatusCode Eigenschaft auf einen Wert größer als 200 festgelegt ist, DefaultAuthenticationModule wird die Anforderung vom-Objekt beendet.If the value of the StatusCode property is set to a value greater than 200, the DefaultAuthenticationModule object will end the request. In diesem Fall werden nur HTTP-Module, die das EndRequest Ereignis abonnieren, vor dem Abschluss der aktuellen Anforderung aufgerufen.In that case, only HTTP modules that subscribe to the EndRequest event are called prior to the completion of the current request.

Der Macht DefaultAuthenticationModule ein Authenticate Ereignis verfügbar.The DefaultAuthenticationModule exposes an Authenticate event. Sie können dieses Ereignis verwenden, um ein benutzerdefiniertes- IPrincipal Objekt für die- User Eigenschaft der aktuellen Instanz bereitzustellen HttpContext .You can use this event to provide a custom IPrincipal object for the User property of the current HttpContext instance. Der Authenticate Zugriff auf das Ereignis erfolgt durch Angabe eines Ereignisses namens DefaultAuthentication_OnAuthenticate in der Datei "Global. asax" der Anwendung.The Authenticate event is accessed by specifying an event named DefaultAuthentication_OnAuthenticate in the application's Global.asax file.

Konstruktoren

DefaultAuthenticationModule()

Initialisiert eine neue Instanz der DefaultAuthenticationModule-Klasse.Initializes a new instance of the DefaultAuthenticationModule class.

Methoden

Dispose()

Gibt alle Ressourcen mit Ausnahme des Arbeitsspeichers frei, die vom DefaultAuthenticationModule verwendet werden.Releases all resources, other than memory, used by the DefaultAuthenticationModule.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
Init(HttpApplication)

Initialisiert das DefaultAuthenticationModule-Objekt.Initializes the DefaultAuthenticationModule object.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Ereignisse

Authenticate

Tritt ein, nachdem die Anforderung authentifiziert wurde.Occurs after the request has been authenticated.

Gilt für:

Weitere Informationen