Dela via


Implementera personifiering i ett ASP.NET program

Den här artikeln beskriver olika sätt att implementera personifiering i ett ASP.NET program.

Ursprunglig produktversion: ASP.NET
Ursprungligt KB-nummer: 306158

Sammanfattning

Den här artikeln beskriver hur du implementerar personifiering genom att ändra Web.config-filen och köra ett visst kodavsnitt.

Den refererar till följande namnområden för Microsoft .NET Framework-klassbibliotek:

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

Du kan använda följande kod för att avgöra vilken användare tråden kör som:

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

Personifiera IIS-autentiserat konto eller användare

Om du vill personifiera IIS-autentiseringsanvändaren (Internet Information Services) för varje begäran för varje sida i ett ASP.NET program måste du inkludera en <identity> tagg i Web.config filen för det här programmet och ange personifieringsattributet till true. Till exempel:

<identity impersonate="true" />

Personifiera en specifik användare för alla begäranden i ett ASP.NET program

Om du vill personifiera en specifik användare för alla begäranden på alla sidor i ett ASP.NET program kan du ange attributen userName och password i taggen <identity> för den Web.config filen för programmet. Till exempel:

<identity impersonate="true" userName="accountname" password="password" />

Obs!

Identiteten för den process som personifierar en specifik användare i en tråd måste ha behörigheten Agera som en del av operativsystemets behörighet. Som standard körs Aspnet_wp.exe-processen under ett datorkonto med namnet ASPNET. Det här kontot har dock inte de behörigheter som krävs för att personifiera en viss användare. Du får ett felmeddelande om du försöker personifiera en viss användare. Den här informationen gäller endast för .NET Framework 1.0. Den här behörigheten krävs inte för .NET Framework 1.1.

Använd någon av följande metoder för att lösa det här problemet:

  • Bevilja lagen som en del av operativsystemets behörighet till ASPNET-kontot (det minst privilegierade kontot).

    Obs!

    Även om du kan använda den här metoden för att kringgå problemet rekommenderar Microsoft inte den här metoden.

  • Ändra det konto som Aspnet_wp.exe processen körs under till systemkontot i konfigurationsavsnittet <processModel> i Machine.config-filen.

Personifiera den autentiserande användaren i kod

Om du bara vill personifiera den autentiserande användaren (User.Identity) när du kör ett visst kodavsnitt kan du använda koden som ska följas. Den här metoden kräver att den autentiserande användaridentiteten är av typen 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();
    

Personifiera en specifik användare i kod

Om du bara vill personifiera en viss användare när du kör ett visst kodavsnitt använder du följande kod:

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>

Identiteten för den process som personifierar en specifik användare i en tråd måste ha behörigheten Agera som en del av operativsystemet om Aspnet_wp.exe processen körs på en Windows 2000-baserad dator. Lagen som en del av operativsystemets behörighet krävs inte om Aspnet_wp.exe-processen körs på en Windows XP-baserad dator eller på en Windows Server 2003-baserad dator. Som standard körs Aspnet_wp.exe-processen under ett datorkonto med namnet ASPNET. Det här kontot har dock inte de behörigheter som krävs för att personifiera en viss användare. Du får ett felmeddelande om du försöker personifiera en viss användare.

Använd någon av följande metoder för att lösa det här problemet:

  • Bevilja lagen som en del av operativsystemets behörighet till ASPNET-kontot.

    Obs!

    Vi rekommenderar inte den här metoden för att kringgå problemet.

  • Ändra det konto som Aspnet_wp.exe processen körs under till systemkontot i konfigurationsavsnittet <processModel> i Machine.config-filen.

Referenser

ASP.NET säkerhetsöversikt