WindowsAuthenticationModule-Klasse
Legt die Identität des Benutzers für eine ASP.NET-Anwendung fest, wenn die Windows-Authentifizierung aktiviert ist. Diese Klasse kann nicht geerbt werden.
Namespace: System.Web.Security
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public NotInheritable Class WindowsAuthenticationModule
Implements IHttpModule
'Usage
Dim instance As WindowsAuthenticationModule
public sealed class WindowsAuthenticationModule : IHttpModule
public ref class WindowsAuthenticationModule sealed : IHttpModule
public final class WindowsAuthenticationModule implements IHttpModule
public final class WindowsAuthenticationModule implements IHttpModule
Hinweise
Wenn der Authentifizierungs-Mode auf Windows festgelegt ist, legt das WindowsAuthenticationModule die User-Eigenschaft des aktuellen HttpContext auf ein IPrincipal-Objekt fest, das die durch IIS für die aktuelle Anforderung bereitgestellte Windows-Identität darstellt. Wenn IIS die anonyme Authentifizierung verwendet, dann verwendet das WindowsAuthenticationModule die von der GetAnonymous-Methode zurückgegebene Identität.
Das WindowsAuthenticationModule macht ein Authenticate-Ereignis verfügbar, mit dem Sie ein benutzerdefiniertes IPrincipal-Objekt für die User-Eigenschaft des aktuellen HttpContext bereitstellen können. Der Zugriff auf das Authenticate-Ereignis erfolgt durch Angeben einer Unterroutine mit dem Namen WindowsAuthentication_OnAuthenticate in der Datei Global.asax für die ASP.NET-Anwendung.
Beispiel
Im folgenden Codebeispiel wird die User-Eigenschaft des aktuellen HttpContext mit dem WindowsAuthentication_OnAuthenticate-Ereignis an ein benutzerdefiniertes IPrincipal-Objekt gebunden.
Public Sub WindowsAuthentication_OnAuthenticate(sender As Object, args As WindowsAuthenticationEventArgs)
If Not args.Identity.IsAnonymous Then
args.User = New Samples.AspNet.Security.MyPrincipal(args.Identity)
End If
End Sub
public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
if (!args.Identity.IsAnonymous)
{
args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
}
}
.NET Framework-Sicherheit
- AspNetHostingPermission für das Verwenden der WindowsAuthenticationModule-Klasse in einer Hostumgebung. Anforderungswert: LinkDemand. Berechtigungswert: Minimal.
Vererbungshierarchie
System.Object
System.Web.Security.WindowsAuthenticationModule
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
WindowsAuthenticationModule-Member
System.Web.Security-Namespace