Implementación de la suplantación en una aplicación ASP.NET

En este artículo se describen diferentes formas de implementar la suplantación en una aplicación ASP.NET.

              Versión original del producto: ASP.NET
Número de KB original: 306158

Resumen

En este artículo se presenta cómo implementar la suplantación modificando el archivo Web.config y ejecutando una sección determinada del código.

Hace referencia a los siguientes espacios de nombres de la biblioteca de clases de Microsoft .NET Framework:

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

Puede usar el código siguiente para determinar qué usuario está ejecutando el subproceso como:

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

Suplantar una cuenta o un usuario autenticados de IIS

Para suplantar al usuario de autenticación de Internet Information Services (IIS) en cada solicitud de cada página de una aplicación ASP.NET, debe incluir una <identity> etiqueta en el archivo Web.config de esta aplicación y establecer el atributo impersonate en true. Por ejemplo:

<identity impersonate="true" />

Suplantar a un usuario específico para todas las solicitudes de una aplicación ASP.NET

Para suplantar a un usuario específico para todas las solicitudes de todas las páginas de una aplicación ASP.NET, puede especificar los userName atributos y password en la <identity> etiqueta del archivo Web.config para esa aplicación. Por ejemplo:

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

Para solucionar este problema, use uno de los métodos siguientes:

• Conceda el privilegio Act como parte del sistema operativo a la cuenta ASPNET (la cuenta con privilegios mínimos).

  Nota:

  Aunque puede usar este método para solucionar el problema, Microsoft no recomienda este método.

• Cambie la cuenta en la que se ejecuta el proceso de Aspnet_wp.exe a la cuenta del sistema en la <processModel> sección de configuración del archivo Machine.config.

Suplantar al usuario autenticado en el código

Para suplantar al usuario autenticador (User.Identity) solo cuando se ejecuta una sección determinada de código, puede usar el código para seguir. Este método requiere que la identidad de usuario de autenticación sea del tipo 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();
  

Suplantar a un usuario específico en el código

Para suplantar a un usuario específico solo cuando ejecute una sección determinada de código, use el código siguiente:

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>

La identidad del proceso que suplanta a un usuario específico en un subproceso debe tener el privilegio Act como parte del sistema operativo si el proceso de Aspnet_wp.exe se ejecuta en un equipo basado en Windows 2000. La acción como parte del privilegio del sistema operativo no es necesaria si el proceso de Aspnet_wp.exe se ejecuta en un equipo basado en Windows XP o en un equipo basado en Windows Server 2003. De forma predeterminada, el proceso de Aspnet_wp.exe se ejecuta en una cuenta de equipo denominada ASPNET. Sin embargo, esta cuenta no tiene los privilegios necesarios para suplantar a un usuario específico. Recibirá un mensaje de error si intenta suplantar a un usuario específico.

Para solucionar este problema, use uno de los métodos siguientes:

• Conceda el privilegio Act como parte del sistema operativo a la cuenta ASPNET.

  Nota:

  No se recomienda este método para solucionar el problema.

• Cambie la cuenta en la que se ejecuta el proceso de Aspnet_wp.exe a la cuenta del sistema en la <processModel> sección de configuración del archivo Machine.config.

Referencias

introducción a la seguridad de ASP.NET