ASP.NET uygulamasında kimliğe bürünme uygulama

Bu makalede, bir ASP.NET uygulamasında kimliğe bürünme uygulamanın farklı yolları açıklanmaktadır.

Orijinal ürün sürümü: ASP.NET
Özgün KB numarası: 306158

Özet

Bu makalede, Web.config dosyasını değiştirip kodun belirli bir bölümünü çalıştırarak kimliğe bürünme uygulama işlemi anlatılır.

Aşağıdaki Microsoft .NET Framework Sınıf Kitaplığı ad alanlarını ifade eder:

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

İş parçacığının hangi kullanıcı olarak yürütüleceğini belirlemek için aşağıdaki kodu kullanabilirsiniz:

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

Kimliği doğrulanmış IIS hesabı veya kullanıcı kimliğine bürünme

Bir ASP.NET uygulamasındaki her sayfanın her isteğinde Internet Information Services (IIS) kimlik doğrulama kullanıcısının kimliğine bürünmek için, bu uygulamanın Web.config dosyasına bir <identity> etiket eklemeniz ve kimliğe bürünme özniteliğini true olarak ayarlamanız gerekir. Örneğin:

<identity impersonate="true" />

ASP.NET uygulamasının tüm istekleri için belirli bir kullanıcının kimliğine bürünme

bir ASP.NET uygulamasının tüm sayfalarındaki tüm istekler için belirli bir kullanıcının kimliğine bürünmek için, ve password özniteliklerini ilgili uygulamanın Web.config dosyasının etiketinde <identity> belirtebilirsinizuserName. Örneğin:

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

Not

Bir iş parçacığında belirli bir kullanıcının kimliğine bürünen işlemin kimliği , işletim sistemi ayrıcalığının bir parçası olarak davran'a sahip olmalıdır. Varsayılan olarak, Aspnet_wp.exe işlemi ASPNET adlı bir bilgisayar hesabı altında çalışır. Ancak bu hesabın belirli bir kullanıcının kimliğine bürünmek için gerekli ayrıcalıkları yoktur. Belirli bir kullanıcının kimliğine bürünmeye çalışırsanız bir hata iletisi alırsınız. Bu bilgiler yalnızca .NET Framework 1.0 için geçerlidir. Bu ayrıcalık, .NET Framework 1.1 için gerekli değildir.

Bu sorunu geçici olarak çözmek için aşağıdaki yöntemlerden birini kullanın:

  • ASPNET hesabına işletim sistemi ayrıcalığının bir parçası olarak davran (en az ayrıcalıklı hesap) verin.

    Not

    Sorunu geçici olarak çözmek için bu yöntemi kullanabilirsiniz ancak Microsoft bu yöntemi önermez.

  • Aspnet_wp.exe işleminin altında çalıştığı hesabı, Machine.config dosyasının <processModel> yapılandırma bölümündeki Sistem hesabı olarak değiştirin.

Kodda kimlik doğrulayıcı kullanıcının kimliğine bürünme

Kimlik doğrulama kullanıcısının kimliğine bürünmek için (User.Identity) yalnızca kodun belirli bir bölümünü çalıştırdığınızda, izlemek için kodu kullanabilirsiniz. Bu yöntem, kimlik doğrulama kullanıcı kimliğinin türünde WindowsIdentityolmasını gerektirir.

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

Kodda belirli bir kullanıcının kimliğine bürünme

Belirli bir kullanıcının kimliğine bürünmek için yalnızca kodun belirli bir bölümünü çalıştırdığınızda aşağıdaki kodu kullanın:

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 işlemi Windows 2000 tabanlı bir bilgisayarda çalışıyorsa, bir iş parçacığında belirli bir kullanıcının kimliğine bürünen işlemin kimliği, işletim sistemi ayrıcalığının bir parçası olarak davran'a sahip olmalıdır. Aspnet_wp.exe işlemi Windows XP tabanlı bir bilgisayarda veya Windows Server 2003 tabanlı bir bilgisayarda çalışıyorsa İşletim sistemi ayrıcalığının bir parçası olarak davran gerekli değildir. Varsayılan olarak, Aspnet_wp.exe işlemi ASPNET adlı bir bilgisayar hesabı altında çalışır. Ancak bu hesabın belirli bir kullanıcının kimliğine bürünmek için gerekli ayrıcalıkları yoktur. Belirli bir kullanıcının kimliğine bürünmeye çalışırsanız bir hata iletisi alırsınız.

Bu sorunu geçici olarak çözmek için aşağıdaki yöntemlerden birini kullanın:

  • ASPNET hesabına işletim sistemi ayrıcalığının bir parçası olarak Davran'ı verin.

    Not

    Bu yöntemin sorunu geçici olarak çözmesini önermiyoruz.

  • Aspnet_wp.exe işleminin altında çalıştığı hesabı, Machine.config dosyasının <processModel> yapılandırma bölümündeki Sistem hesabı olarak değiştirin.

Başvurular

ASP.NET güvenliğe genel bakış