Implementar representação em um aplicativo ASP.NET
Este artigo descreve diferentes maneiras de implementar a representação em um aplicativo ASP.NET.
Versão original do produto: ASP.NET
Número de KB original: 306158
Resumo
Este artigo apresenta como implementar a representação modificando o arquivo Web.config e executando uma determinada seção de código.
Ele se refere aos seguintes namespaces da Biblioteca de Classes do Microsoft .NET Framework:
System.Web.Security
System.Security.Principal
System.Runtime.InteropServices
Você pode usar o código a seguir para determinar qual usuário o thread está executando como:
System.Security.Principal.WindowsIdentity.GetCurrent().Name
Representar a conta autenticada do IIS ou o usuário
Para representar o usuário do IIS (Serviços de Informações da Internet) em cada solicitação para cada página em um aplicativo ASP.NET, você deve incluir uma <identity>
marca no arquivo Web.config desse aplicativo e definir o atributo de representação como true. Por exemplo:
<identity impersonate="true" />
Representar um usuário específico para todas as solicitações de um aplicativo ASP.NET
Para representar um usuário específico para todas as solicitações em todas as páginas de um aplicativo ASP.NET, você pode especificar os userName
atributos e password
na <identity>
marca do arquivo Web.config para esse aplicativo. Por exemplo:
<identity impersonate="true" userName="accountname" password="password" />
Observação
A identidade do processo que representa um usuário específico em um thread deve ter o Act como parte do privilégio do sistema operacional . Por padrão, o processo Aspnet_wp.exe é executado em uma conta de computador chamada ASPNET. No entanto, essa conta não tem os privilégios necessários para representar um usuário específico. Você receberá uma mensagem de erro se tentar representar um usuário específico. Essas informações se aplicam apenas ao .NET Framework 1.0. Esse privilégio não é necessário para o .NET Framework 1.1.
Para contornar esse problema, use um dos seguintes métodos:
Conceda o Act como parte do privilégio do sistema operacional à conta ASPNET (a conta menos privilegiada).
Observação
Embora você possa usar esse método para resolver o problema, a Microsoft não recomenda esse método.
Altere a conta em que o processo Aspnet_wp.exe é executado na conta do Sistema na
<processModel>
seção de configuração do arquivo Machine.config.
Representar o usuário de autenticação no código
Para representar o usuário de autenticação (User.Identity
) somente quando você executar uma determinada seção de código, você pode usar o código a seguir. Esse método exige que a identidade do usuário de autenticação seja do 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();
Representar um usuário específico no código
Para representar um usuário específico somente quando você executar uma determinada seção de código, use o seguinte código:
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>
A identidade do processo que representa um usuário específico em um thread deve ter o Act como parte do privilégio do sistema operacional se o processo Aspnet_wp.exe estiver em execução em um computador baseado no Windows 2000. O Act como parte do privilégio do sistema operacional não é necessário se o processo Aspnet_wp.exe estiver em execução em um computador baseado em Windows XP ou em um computador baseado no Windows Server 2003. Por padrão, o processo Aspnet_wp.exe é executado em uma conta de computador chamada ASPNET. No entanto, essa conta não tem os privilégios necessários para representar um usuário específico. Você receberá uma mensagem de erro se tentar representar um usuário específico.
Para contornar esse problema, use um dos seguintes métodos:
Conceda o Act como parte do privilégio do sistema operacional à conta ASPNET.
Observação
Não recomendamos que esse método resolva o problema.
Altere a conta em que o processo Aspnet_wp.exe é executado na conta do Sistema na
<processModel>
seção de configuração do arquivo Machine.config.
Referências
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários