Implementowanie personifikacji w aplikacji ASP.NET

2025-02-05

W tym artykule opisano różne sposoby implementowania personifikacji w aplikacji ASP.NET.

Oryginalna wersja produktu: ASP.NET
Oryginalny numer KB: 306158

Podsumowanie

W tym artykule przedstawiono sposób implementowania personifikacji przez zmodyfikowanie pliku Web.config i uruchomienie określonej sekcji kodu.

Odwołuje się ona do następujących przestrzeni nazw biblioteki klas programu Microsoft .NET Framework:

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

Możesz użyć następującego kodu, aby określić, który użytkownik wykonuje wątek jako:

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

Personifikuj uwierzytelnione konto lub użytkownika usług IIS

Aby personifikować użytkownika uwierzytelniającego się w usługach Internet Information Services (IIS) na każdym żądaniu dla każdej strony w aplikacji ASP.NET, należy dołączyć <identity> tag w pliku Web.config tej aplikacji i ustawić personifikat atrybutu na true. Na przykład:

<identity impersonate="true" />

Personifikuj określonego użytkownika dla wszystkich żądań aplikacji ASP.NET

Aby personifikować określonego użytkownika dla wszystkich żądań na wszystkich stronach aplikacji ASP.NET, możesz określić userName atrybuty i password w <identity> tagu pliku Web.config dla tej aplikacji. Na przykład:

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

Uwaga 16.

Tożsamość procesu, który personifikuje określonego użytkownika w wątku, musi mieć uprawnienie Act w ramach uprawnień systemu operacyjnego. Domyślnie proces Aspnet_wp.exe jest uruchamiany na koncie komputera o nazwie ASPNET. Jednak to konto nie ma wymaganych uprawnień do personifikacji określonego użytkownika. Podczas próby personifikacji określonego użytkownika zostanie wyświetlony komunikat o błędzie. Te informacje dotyczą tylko programu .NET Framework 1.0. To uprawnienie nie jest wymagane dla programu .NET Framework 1.1.

Aby obejść ten problem, użyj jednej z następujących metod:

Przyznaj ustawie jako część uprawnień systemu operacyjnego do konta ASPNET (najmniej uprzywilejowanego konta).

Uwaga 16.

Chociaż można użyć tej metody do obejścia problemu, firma Microsoft nie zaleca tej metody.
Zmień konto, w ramach którego proces Aspnet_wp.exe jest uruchamiany na koncie System w <processModel> sekcji konfiguracji pliku Machine.config.

Personifikuj uwierzytelniającego użytkownika w kodzie

Aby personifikować uwierzytelnionego użytkownika (User.Identity) tylko wtedy, gdy uruchamiasz konkretną sekcję kodu, możesz użyć kodu do naśladowania. Ta metoda wymaga, aby uwierzytelnianie tożsamości użytkownika było typu WindowsIdentity.

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();

Personifikuj określonego użytkownika w kodzie

Aby personifikować określonego użytkownika tylko wtedy, gdy uruchamiasz konkretną sekcję kodu, użyj następującego kodu:

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>

Tożsamość procesu, który personifikuje określonego użytkownika w wątku, musi mieć uprawnienie Act jako część uprawnień systemu operacyjnego, jeśli proces Aspnet_wp.exe jest uruchomiony na komputerze z systemem Windows 2000. Ustawa jako część uprawnień systemu operacyjnego nie jest wymagana, jeśli proces Aspnet_wp.exe jest uruchomiony na komputerze z systemem Windows XP lub na komputerze z systemem Windows Server 2003. Domyślnie proces Aspnet_wp.exe jest uruchamiany na koncie komputera o nazwie ASPNET. Jednak to konto nie ma wymaganych uprawnień do personifikacji określonego użytkownika. Podczas próby personifikacji określonego użytkownika zostanie wyświetlony komunikat o błędzie.

Aby obejść ten problem, użyj jednej z następujących metod:

Przyznaj ustawie jako część uprawnień systemu operacyjnego do konta ASPNET.

Uwaga 16.

Nie zalecamy, aby ta metoda działała w celu obejścia problemu.
Zmień konto, w ramach którego proces Aspnet_wp.exe jest uruchamiany na koncie System w <processModel> sekcji konfiguracji pliku Machine.config.

Informacje

Omówienie zabezpieczeń ASP.NET

Udostępnij za pośrednictwem