Freigeben über


Implementieren eines Identitätswechsels in einer ASP.NET-Anwendung

In diesem Artikel werden verschiedene Möglichkeiten zum Implementieren des Identitätswechsels in einer ASP.NET Anwendung beschrieben.

Ursprüngliche Produktversion: ASP.NET
Ursprüngliche KB-Nummer: 306158

Zusammenfassung

In diesem Artikel wird erläutert, wie Sie identitätswechseln, indem Sie die Web.config-Datei ändern und einen bestimmten Codeabschnitt ausführen.

Sie bezieht sich auf die folgenden Microsoft .NET Framework-Klassenbibliotheksnamespaces:

  • System.Web.Security
  • System.Security.Principal
  • System.Runtime.InteropServices

Sie können den folgenden Code verwenden, um zu bestimmen, wie der Thread ausgeführt wird:

System.Security.Principal.WindowsIdentity.GetCurrent().Name

Identitätswechsel eines authentifizierten IIS-Kontos oder Benutzers

Um den Identitätswechsel des Internetinformationsdienste (IIS) für jede Anforderung für jede Seite in einer ASP.NET-Anwendung zu imitieren, müssen Sie ein <identity> Tag in die Datei "Web.config" dieser Anwendung einschließen und das Identitätswechselatat-Attribut auf "true" festlegen. Zum Beispiel:

<identity impersonate="true" />

Identität eines bestimmten Benutzers für alle Anforderungen einer ASP.NET-Anwendung

Zum Identitätswechsel eines bestimmten Benutzers für alle Anforderungen auf allen Seiten einer ASP.NET-Anwendung können Sie die userName Attribute und password Attribute im <identity> Tag der Web.config-Datei für diese Anwendung angeben. Beispiel:

<identity impersonate="true" userName="<accountName>" password="<credentialPlaceholder>"/>

Notiz

Die Identität des Prozesses, der den Identitätswechsel eines bestimmten Benutzers in einem Thread vorgibt, muss über die Berechtigung "Act" als Teil des Betriebssystems verfügen. Standardmäßig wird der Aspnet_wp.exe Prozess unter einem Computerkonto namens ASPNET ausgeführt. Dieses Konto verfügt jedoch nicht über die erforderlichen Berechtigungen zum Identitätswechsel eines bestimmten Benutzers. Wenn Sie versuchen, einen bestimmten Benutzer zu imitieren, wird eine Fehlermeldung angezeigt. Diese Informationen gelten nur für .NET Framework 1.0. Diese Berechtigung ist für .NET Framework 1.1 nicht erforderlich.

Verwenden Sie eine der folgenden Methoden, um dieses Problem zu umgehen:

  • Gewähren Sie dem ASPNET-Konto (dem am wenigsten privilegierten Konto) die Berechtigung "Act" als Teil des Betriebssystems .

    Notiz

    Obwohl Sie diese Methode verwenden können, um das Problem zu umgehen, empfiehlt Microsoft diese Methode nicht.

  • Ändern Sie das Konto, unter dem der Aspnet_wp.exe-Prozess ausgeführt wird, in das Systemkonto im <processModel> Konfigurationsabschnitt der Datei "Machine.config".

Identität des authentifizierenden Benutzers im Code

Um den Identitätswechsel des authentifizierenden Benutzers (User.Identity) nur dann auszuführen, wenn Sie einen bestimmten Codeabschnitt ausführen, können Sie den Code verwenden, um den Code zu befolgen. Diese Methode erfordert, dass die Authentifizierung der Benutzeridentität vom Typ WindowsIdentityist.

  • Visual Basic .NET

    Dim impersonationContext As System.Security.Principal.WindowsImpersonationContext
    Dim currentWindowsIdentity As System.Security.Principal.WindowsIdentity
    currentWindowsIdentity = CType(User.Identity, System.Security.Principal.WindowsIdentity)
    impersonationContext = currentWindowsIdentity.Impersonate()
    'Insert your code that runs under the security context of the authenticating user here.
    impersonationContext.Undo()
    
  • Visual C# .NET

    System.Security.Principal.WindowsImpersonationContext impersonationContext;
    impersonationContext = ((System.Security.Principal.WindowsIdentity)User.Identity).Impersonate();
    //Insert your code that runs under the security context of the authenticating user here.
    impersonationContext.Undo();
    

Identität eines bestimmten Benutzers im Code

Verwenden Sie den folgenden Code, um den Identitätswechsel eines bestimmten Benutzers nur dann auszuführen, wenn Sie einen bestimmten Codeabschnitt ausführen:

Visual Basic .NET

<%@ Page Language="VB" %>
<%@ Import Namespace = "System.Web" %>
<%@ Import Namespace = "System.Web.Security" %>
<%@ Import Namespace = "System.Security.Principal" %>
<%@ Import Namespace = "System.Runtime.InteropServices" %>

<script runat=server>
Dim LOGON32_LOGON_INTERACTIVE As Integer = 2
Dim LOGON32_PROVIDER_DEFAULT As Integer = 0
Dim impersonationContext As WindowsImpersonationContext

Declare Function LogonUserA Lib "advapi32.dll" (ByVal lpszUsername As String, _
                        ByVal lpszDomain As String, _
                        ByVal lpszPassword As String, _
                        ByVal dwLogonType As Integer, _
                        ByVal dwLogonProvider As Integer, _
                        ByRef phToken As IntPtr) As Integer

Declare Auto Function DuplicateToken Lib "advapi32.dll" ( _
                        ByVal ExistingTokenHandle As IntPtr, _
                        ByVal ImpersonationLevel As Integer, _
                        ByRef DuplicateTokenHandle As IntPtr) As Integer

Declare Auto Function RevertToSelf Lib "advapi32.dll" () As Long
Declare Auto Function CloseHandle Lib "kernel32.dll" (ByVal handle As IntPtr) As Long

Public Sub Page_Load(ByVal s As Object, ByVal e As EventArgs)
    If impersonateValidUser("username", "domain", "password") Then
         'Insert your code that runs under the security context of a specific user here.
         undoImpersonation()
    Else
         'Your impersonation failed. Therefore, include a fail-safe mechanism here.
    End If
End Sub

Private Function impersonateValidUser(ByVal userName As String, _
ByVal domain As String, ByVal password As String) As Boolean

    Dim tempWindowsIdentity As WindowsIdentity
    Dim token As IntPtr = IntPtr.Zero
    Dim tokenDuplicate As IntPtr = IntPtr.Zero
    impersonateValidUser = False

    If RevertToSelf() Then
        If LogonUserA(userName, domain, password, LOGON32_LOGON_INTERACTIVE,
                    LOGON32_PROVIDER_DEFAULT, token) <> 0 Then
            If DuplicateToken(token, 2, tokenDuplicate) <> 0 Then
                tempWindowsIdentity = New WindowsIdentity(tokenDuplicate)
                impersonationContext = tempWindowsIdentity.Impersonate()
                If Not impersonationContext Is Nothing Then
                    impersonateValidUser = True
                End If
            End If
        End If
    End If
    If Not tokenDuplicate.Equals(IntPtr.Zero) Then
        CloseHandle(tokenDuplicate)
    End If
    If Not token.Equals(IntPtr.Zero) Then
        CloseHandle(token)
    End If
End Function

Private Sub undoImpersonation()
    impersonationContext.Undo()
End Sub
</script>

Visual C# .NET

<%@ Page Language="C#"%>
<%@ Import Namespace = "System.Web" %>
<%@ Import Namespace = "System.Web.Security" %>
<%@ Import Namespace = "System.Security.Principal" %>
<%@ Import Namespace = "System.Runtime.InteropServices" %>

<script runat=server>
public const int LOGON32_LOGON_INTERACTIVE = 2;
public const int LOGON32_PROVIDER_DEFAULT = 0;

WindowsImpersonationContext impersonationContext;

[DllImport("advapi32.dll")]
public static extern int LogonUserA(String lpszUserName,
String lpszDomain,
String lpszPassword,
int dwLogonType,
int dwLogonProvider,
ref IntPtr phToken);
[DllImport("advapi32.dll", CharSet=CharSet.Auto, SetLastError=true)]
public static extern int DuplicateToken(IntPtr hToken,
int impersonationLevel,
ref IntPtr hNewToken);

[DllImport("advapi32.dll", CharSet=CharSet.Auto, SetLastError=true)]
public static extern bool RevertToSelf();

[DllImport("kernel32.dll", CharSet=CharSet.Auto)]
public static extern bool CloseHandle(IntPtr handle);

public void Page_Load(Object s, EventArgs e)
{
    if(impersonateValidUser("username", "domain", "password"))
    {
        //Insert your code that runs under the security context of a specific user here.
        undoImpersonation();
    }
    else
    {
        //Your impersonation failed. Therefore, include a fail-safe mechanism here.
    }
}

private bool impersonateValidUser(String userName, String domain, String password)
{
    WindowsIdentity tempWindowsIdentity;
    IntPtr token = IntPtr.Zero;
    IntPtr tokenDuplicate = IntPtr.Zero;

    if(RevertToSelf())
    {
        if(LogonUserA(userName, domain, password, LOGON32_LOGON_INTERACTIVE,
        LOGON32_PROVIDER_DEFAULT, ref token)!= 0)
        {
            if(DuplicateToken(token, 2, ref tokenDuplicate)!= 0) 
            {
                tempWindowsIdentity = new WindowsIdentity(tokenDuplicate);
                impersonationContext = tempWindowsIdentity.Impersonate();
                if (impersonationContext != null)
                {
                    CloseHandle(token);
                    CloseHandle(tokenDuplicate);
                    return true;
                }
            }
        }
    }
    if(token!= IntPtr.Zero)
        CloseHandle(token);
    if(tokenDuplicate!=IntPtr.Zero)
        CloseHandle(tokenDuplicate);
    return false;
}

private void undoImpersonation()
{
    impersonationContext.Undo();
}
</script>

Die Identität des Prozesses, der einen bestimmten Benutzer in einem Thread angibt, muss über die Berechtigung "Act" als Teil des Betriebssystems verfügen, wenn der Aspnet_wp.exe Prozess auf einem Windows 2000-basierten Computer ausgeführt wird. Der Act als Teil der Betriebssystemberechtigung ist nicht erforderlich, wenn der Aspnet_wp.exe Prozess auf einem Windows XP-basierten Computer oder auf einem Windows Server 2003-basierten Computer ausgeführt wird. Standardmäßig wird der Aspnet_wp.exe Prozess unter einem Computerkonto namens ASPNET ausgeführt. Dieses Konto verfügt jedoch nicht über die erforderlichen Berechtigungen zum Identitätswechsel eines bestimmten Benutzers. Wenn Sie versuchen, einen bestimmten Benutzer zu imitieren, wird eine Fehlermeldung angezeigt.

Verwenden Sie eine der folgenden Methoden, um dieses Problem zu umgehen:

  • Gewähren Sie dem ASPNET-Konto die Berechtigung "Act" als Teil des Betriebssystems .

    Notiz

    Wir empfehlen diese Methode nicht, um das Problem zu umgehen.

  • Ändern Sie das Konto, unter dem der Aspnet_wp.exe-Prozess ausgeführt wird, in das Systemkonto im <processModel> Konfigurationsabschnitt der Datei "Machine.config".

References

ASP.NET Sicherheitsübersicht