Реализация олицетворения в приложении ASP.NET

В этой статье описаны различные способы реализации олицетворения в приложении ASP.NET.

Исходная версия продукта: ASP.NET
Исходный номер базы знаний: 306158

Сводка

В этой статье описывается, как реализовать олицетворение путем изменения файла Web.config и выполнения определенного раздела кода.

Он ссылается на следующие пространства имен библиотеки классов Microsoft платформа .NET Framework:

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

Чтобы определить пользователя, от имени какого пользователя выполняется поток, можно использовать следующий код:

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

Олицетворения учетной записи или пользователя, прошедшего проверку подлинности IIS

Чтобы олицетворять пользователя служб IIS, проверяющего подлинность пользователя при каждом запросе для каждой страницы в приложении ASP.NET, необходимо включить <identity> тег в файл Web.config этого приложения и задать для атрибута олицетворения значение true. Например:

<identity impersonate="true" />

Олицетворения конкретного пользователя для всех запросов приложения ASP.NET

Чтобы олицетворить конкретного пользователя для всех запросов на всех страницах приложения ASP.NET, можно указать userName атрибуты и password в <identity> теге файла Web.config для этого приложения. Например:

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

Чтобы обойти эту проблему, используйте один из следующих методов:

• Предоставьте закон как часть привилегий операционной системы учетной записи ASPNET (наименее привилегированной учетной записи).

  Примечание.

  Хотя вы можете использовать этот метод для решения проблемы, корпорация Майкрософт не рекомендует этот метод.

• Измените учетную запись, в которой выполняется процесс Aspnet_wp.exe, на системную учетную запись в <processModel> разделе конфигурации файла Machine.config.

Олицетворение пользователя, проверяющего подлинность, в коде

Чтобы олицетворять пользователя, выполняющего проверку подлинности (User.Identity), только при выполнении определенного раздела кода, можно использовать код для выполнения. Для этого метода требуется, чтобы удостоверение пользователя для проверки подлинности было типа 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();
  

Олицетворения определенного пользователя в коде

Чтобы олицетворить конкретного пользователя только при выполнении определенного раздела кода, используйте следующий код:

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>

Если Aspnet_wp.exe процесс выполняется на компьютере под управлением Windows 2000, удостоверение процесса, олицетворяющего конкретного пользователя в потоке, должно иметь закон в качестве части привилегии операционной системы . Закон как часть привилегии операционной системы не требуется, если процесс Aspnet_wp.exe выполняется на компьютере под управлением Windows XP или на компьютере под управлением Windows Server 2003. По умолчанию процесс Aspnet_wp.exe выполняется под учетной записью компьютера с именем ASPNET. Однако у этой учетной записи нет необходимых привилегий для олицетворения определенного пользователя. При попытке олицетворения определенного пользователя появляется сообщение об ошибке.

Чтобы обойти эту проблему, используйте один из следующих методов:

• Предоставьте закон как часть привилегий операционной системы учетной записи ASPNET.

  Примечание.

  Мы не рекомендуем этот метод для обхода проблемы.

• Измените учетную запись, в которой выполняется процесс Aspnet_wp.exe, на системную учетную запись в <processModel> разделе конфигурации файла Machine.config.

Ссылки

Общие сведения о безопасности ASP.NET