Como você faz representação no .NET?


139

Existe uma maneira simples e imediata de se passar por um usuário no .NET?

Até agora, tenho usado essa classe do projeto de código para todos os meus requisitos de representação.

Existe uma maneira melhor de fazer isso usando o .NET Framework?

Eu tenho um conjunto de credenciais de usuário (nome de usuário, senha, nome de domínio) que representa a identidade que eu preciso representar.


1
Você poderia ser mais específico? Existem várias maneiras de se fazer passar pela caixa.
Esteban Araya

Respostas:


60

Aqui está uma boa visão geral dos conceitos de representação do .NET.

Basicamente, você aproveitará essas classes que estão prontas para uso na estrutura .NET:

O código geralmente pode ficar longo e é por isso que você vê muitos exemplos, como o que você faz referência, que tenta simplificar o processo.


4
Apenas uma observação de que a representação não é a bala de prata e algumas APIs simplesmente não foram projetadas para funcionar com a representação.
Lex Li

Esse link do blog do programador holandês foi excelente. Abordagem muito mais intuitiva à representação do que as outras técnicas apresentadas.
precisa saber é o seguinte

296

"Representação" no espaço .NET geralmente significa executar código em uma conta de usuário específica. É um conceito um pouco separado do que obter acesso a essa conta de usuário por meio de um nome de usuário e senha, embora essas duas idéias sejam frequentemente combinadas. Descreverei os dois e depois explicarei como usar minha biblioteca SimpleImpersonation , que os utiliza internamente.

Representação

As APIs para representação são fornecidas no .NET por meio do System.Security.Principalnamespace:

  • O código mais recente (.NET 4.6+, .NET Core etc.) geralmente deve ser usado WindowsIdentity.RunImpersonated, o que aceita um identificador para o token da conta do usuário e, em seguida, um Actionou Func<T>para o código executar.

    WindowsIdentity.RunImpersonated(tokenHandle, () =>
    {
        // do whatever you want as this user.
    });

    ou

    var result = WindowsIdentity.RunImpersonated(tokenHandle, () =>
    {
        // do whatever you want as this user.
        return result;
    });
  • O código mais antigo usava o WindowsIdentity.Impersonatemétodo para recuperar um WindowsImpersonationContextobjeto. Esse objeto é implementado IDisposable, portanto geralmente deve ser chamado de um usingbloco.

    using (WindowsImpersonationContext context = WindowsIdentity.Impersonate(tokenHandle))
    {
        // do whatever you want as this user.
    }

    Embora essa API ainda exista no .NET Framework, ela geralmente deve ser evitada e não está disponível no .NET Core ou no .NET Standard.

Acessando a conta do usuário

A API para usar um nome de usuário e senha para obter acesso a uma conta de usuário no Windows é LogonUser- que é uma API nativa do Win32. No momento, não existe uma API .NET interna para chamá-la, portanto, é necessário recorrer à P / Invoke.

[DllImport("advapi32.dll", SetLastError = true, CharSet = CharSet.Unicode)]
internal static extern bool LogonUser(String lpszUsername, String lpszDomain, String lpszPassword, int dwLogonType, int dwLogonProvider, out IntPtr phToken);

Esta é a definição básica de chamada, no entanto, há muito mais a considerar para usá-la realmente na produção:

  • Obtendo um identificador com o padrão de acesso "seguro".
  • Fechar adequadamente os identificadores nativos
  • Níveis de confiança de segurança de acesso ao código (CAS) (somente no .NET Framework)
  • Passando SecureStringquando você pode coletar um com segurança, pressionando as teclas do usuário.

A quantidade de código a ser escrito para ilustrar tudo isso está além do que deveria estar em uma resposta do StackOverflow, IMHO.

Uma abordagem combinada e mais fácil

Em vez de escrever tudo isso você mesmo, considere usar minha biblioteca SimpleImpersonation , que combina representação e acesso de usuário em uma única API. Funciona bem em bases de código modernas e antigas, com a mesma API simples:

var credentials = new UserCredentials(domain, username, password);
Impersonation.RunAsUser(credentials, logonType, () =>
{
    // do whatever you want as this user.
}); 

ou

var credentials = new UserCredentials(domain, username, password);
var result = Impersonation.RunAsUser(credentials, logonType, () =>
{
    // do whatever you want as this user.
    return something;
});

Observe que é muito semelhante à WindowsIdentity.RunImpersonatedAPI, mas não requer que você saiba nada sobre identificadores de token.

Esta é a API da versão 3.0.0. Consulte o leia-me do projeto para obter mais detalhes. Observe também que uma versão anterior da biblioteca usava uma API com o IDisposablepadrão, semelhante a WindowsIdentity.Impersonate. A versão mais recente é muito mais segura e ambas ainda são usadas internamente.


14
Isso é muito semelhante ao código disponível em msdn.microsoft.com/en-us/library/…, mas é incrivelmente bom ver tudo listado aqui. Simples e fácil de incorporar em minha solução. Muito obrigado por fazer todo o trabalho duro!
21312 McArthey

1
Obrigado por postar isso. No entanto, na instrução using, tentei esta linha de código System.Security.Principal.WindowsIdentity.GetCurrent (). O nome e o resultado foram apenas o nome de usuário com o qual eu entrei e não o que eu passei no contratador de representação.
22413 Chris

3
@ Chris - Você precisaria usar um dos outros tipos de login. O tipo 9 fornece apenas representação nas credenciais da rede de saída. Testei os tipos 2, 3 e 8 em um aplicativo WinForms e eles atualizam corretamente o principal atual. Supõe-se que os tipos 4 e 5 o façam também, para aplicativos de serviço ou em lote. Veja o link que referenciei na postagem.
precisa


4
@Sophit - O código fonte de referência aqui mostra claramente a Undochamada durante o descarte.
Matt Johnson-Pint

20

Provavelmente é isso que você deseja:

using System.Security.Principal;
using(WindowsIdentity.GetCurrent().Impersonate())
{
     //your code goes here
}

Mas eu realmente preciso de mais detalhes para ajudá-lo. Você pode se passar por um arquivo de configuração (se estiver tentando fazer isso em um site), ou por meio de decoradores de métodos (atributos), se for um serviço WCF, ou através de ... você entendeu.

Além disso, se estivermos falando de se passar por um cliente que chamou um serviço específico (ou aplicativo da web), você precisará configurar o cliente corretamente para que ele transmita os tokens apropriados.

Por fim, se o que você realmente deseja fazer é Delegação, você também precisará configurar o AD corretamente para que usuários e máquinas sejam confiáveis ​​para delegação.

Editar:
dê uma olhada aqui para ver como se passar por um usuário diferente e para obter mais documentação.


2
Esse código parece representar apenas a identidade atual do Windows. Existe uma maneira de obter o objeto WindowsIdentity de outro usuário?
ashwnacharya

O link na sua edição ( msdn.microsoft.com/en-us/library/chf6fbt4.aspx - vá para Exemplos lá) é realmente o que eu estava procurando!
Matt

Uau! você me guiou na direção certa, apenas algumas palavras foram necessários para fazer a mágica representação com um arquivo de configuração Obrigado Esteban, saludos desde Peru
AjFmO

6

Aqui está a minha porta vb.net da resposta de Matt Johnson. Eu adicionei uma enumeração para os tipos de logon. LOGON32_LOGON_INTERACTIVEfoi o primeiro valor de enumeração que funcionou para o servidor sql. Minha cadeia de conexão era apenas confiável. Nenhum nome de usuário / senha na cadeia de conexão.

  <PermissionSet(SecurityAction.Demand, Name:="FullTrust")> _
  Public Class Impersonation
    Implements IDisposable

    Public Enum LogonTypes
      ''' <summary>
      ''' This logon type is intended for users who will be interactively using the computer, such as a user being logged on  
      ''' by a terminal server, remote shell, or similar process.
      ''' This logon type has the additional expense of caching logon information for disconnected operations; 
      ''' therefore, it is inappropriate for some client/server applications,
      ''' such as a mail server.
      ''' </summary>
      LOGON32_LOGON_INTERACTIVE = 2

      ''' <summary>
      ''' This logon type is intended for high performance servers to authenticate plaintext passwords.
      ''' The LogonUser function does not cache credentials for this logon type.
      ''' </summary>
      LOGON32_LOGON_NETWORK = 3

      ''' <summary>
      ''' This logon type is intended for batch servers, where processes may be executing on behalf of a user without 
      ''' their direct intervention. This type is also for higher performance servers that process many plaintext
      ''' authentication attempts at a time, such as mail or Web servers. 
      ''' The LogonUser function does not cache credentials for this logon type.
      ''' </summary>
      LOGON32_LOGON_BATCH = 4

      ''' <summary>
      ''' Indicates a service-type logon. The account provided must have the service privilege enabled. 
      ''' </summary>
      LOGON32_LOGON_SERVICE = 5

      ''' <summary>
      ''' This logon type is for GINA DLLs that log on users who will be interactively using the computer. 
      ''' This logon type can generate a unique audit record that shows when the workstation was unlocked. 
      ''' </summary>
      LOGON32_LOGON_UNLOCK = 7

      ''' <summary>
      ''' This logon type preserves the name and password in the authentication package, which allows the server to make 
      ''' connections to other network servers while impersonating the client. A server can accept plaintext credentials 
      ''' from a client, call LogonUser, verify that the user can access the system across the network, and still 
      ''' communicate with other servers.
      ''' NOTE: Windows NT:  This value is not supported. 
      ''' </summary>
      LOGON32_LOGON_NETWORK_CLEARTEXT = 8

      ''' <summary>
      ''' This logon type allows the caller to clone its current token and specify new credentials for outbound connections.
      ''' The new logon session has the same local identifier but uses different credentials for other network connections. 
      ''' NOTE: This logon type is supported only by the LOGON32_PROVIDER_WINNT50 logon provider.
      ''' NOTE: Windows NT:  This value is not supported. 
      ''' </summary>
      LOGON32_LOGON_NEW_CREDENTIALS = 9
    End Enum

    <DllImport("advapi32.dll", SetLastError:=True, CharSet:=CharSet.Unicode)> _
    Private Shared Function LogonUser(lpszUsername As [String], lpszDomain As [String], lpszPassword As [String], dwLogonType As Integer, dwLogonProvider As Integer, ByRef phToken As SafeTokenHandle) As Boolean
    End Function

    Public Sub New(Domain As String, UserName As String, Password As String, Optional LogonType As LogonTypes = LogonTypes.LOGON32_LOGON_INTERACTIVE)
      Dim ok = LogonUser(UserName, Domain, Password, LogonType, 0, _SafeTokenHandle)
      If Not ok Then
        Dim errorCode = Marshal.GetLastWin32Error()
        Throw New ApplicationException(String.Format("Could not impersonate the elevated user.  LogonUser returned error code {0}.", errorCode))
      End If

      WindowsImpersonationContext = WindowsIdentity.Impersonate(_SafeTokenHandle.DangerousGetHandle())
    End Sub

    Private ReadOnly _SafeTokenHandle As New SafeTokenHandle
    Private ReadOnly WindowsImpersonationContext As WindowsImpersonationContext

    Public Sub Dispose() Implements System.IDisposable.Dispose
      Me.WindowsImpersonationContext.Dispose()
      Me._SafeTokenHandle.Dispose()
    End Sub

    Public NotInheritable Class SafeTokenHandle
      Inherits SafeHandleZeroOrMinusOneIsInvalid

      <DllImport("kernel32.dll")> _
      <ReliabilityContract(Consistency.WillNotCorruptState, Cer.Success)> _
      <SuppressUnmanagedCodeSecurity()> _
      Private Shared Function CloseHandle(handle As IntPtr) As <MarshalAs(UnmanagedType.Bool)> Boolean
      End Function

      Public Sub New()
        MyBase.New(True)
      End Sub

      Protected Overrides Function ReleaseHandle() As Boolean
        Return CloseHandle(handle)
      End Function
    End Class

  End Class

Você precisa usar com uma Usinginstrução para conter algum código para executar a representação.


3

Veja mais detalhes da minha resposta anterior Criei um pacote de nuget Nuget

Código no Github

amostra: você pode usar:

           string login = "";
           string domain = "";
           string password = "";

           using (UserImpersonation user = new UserImpersonation(login, domain, password))
           {
               if (user.ImpersonateValidUser())
               {
                   File.WriteAllText("test.txt", "your text");
                   Console.WriteLine("File writed");
               }
               else
               {
                   Console.WriteLine("User not connected");
               }
           }

Vieuw o código completo:

using System;
using System.Runtime.InteropServices;
using System.Security.Principal;


/// <summary>
/// Object to change the user authticated
/// </summary>
public class UserImpersonation : IDisposable
{
    /// <summary>
    /// Logon method (check athetification) from advapi32.dll
    /// </summary>
    /// <param name="lpszUserName"></param>
    /// <param name="lpszDomain"></param>
    /// <param name="lpszPassword"></param>
    /// <param name="dwLogonType"></param>
    /// <param name="dwLogonProvider"></param>
    /// <param name="phToken"></param>
    /// <returns></returns>
    [DllImport("advapi32.dll")]
    private static extern bool LogonUser(String lpszUserName,
        String lpszDomain,
        String lpszPassword,
        int dwLogonType,
        int dwLogonProvider,
        ref IntPtr phToken);

    /// <summary>
    /// Close
    /// </summary>
    /// <param name="handle"></param>
    /// <returns></returns>
    [DllImport("kernel32.dll", CharSet = CharSet.Auto)]
    public static extern bool CloseHandle(IntPtr handle);

    private WindowsImpersonationContext _windowsImpersonationContext;
    private IntPtr _tokenHandle;
    private string _userName;
    private string _domain;
    private string _passWord;

    const int LOGON32_PROVIDER_DEFAULT = 0;
    const int LOGON32_LOGON_INTERACTIVE = 2;

    /// <summary>
    /// Initialize a UserImpersonation
    /// </summary>
    /// <param name="userName"></param>
    /// <param name="domain"></param>
    /// <param name="passWord"></param>
    public UserImpersonation(string userName, string domain, string passWord)
    {
        _userName = userName;
        _domain = domain;
        _passWord = passWord;
    }

    /// <summary>
    /// Valiate the user inforamtion
    /// </summary>
    /// <returns></returns>
    public bool ImpersonateValidUser()
    {
        bool returnValue = LogonUser(_userName, _domain, _passWord,
                LOGON32_LOGON_INTERACTIVE, LOGON32_PROVIDER_DEFAULT,
                ref _tokenHandle);

        if (false == returnValue)
        {
            return false;
        }

        WindowsIdentity newId = new WindowsIdentity(_tokenHandle);
        _windowsImpersonationContext = newId.Impersonate();
        return true;
    }

    #region IDisposable Members

    /// <summary>
    /// Dispose the UserImpersonation connection
    /// </summary>
    public void Dispose()
    {
        if (_windowsImpersonationContext != null)
            _windowsImpersonationContext.Undo();
        if (_tokenHandle != IntPtr.Zero)
            CloseHandle(_tokenHandle);
    }

    #endregion
}

2

Estou ciente de que estou atrasado para a festa, mas considero que a biblioteca de Phillip Allan-Harding é a melhor para este caso e similares.

Você só precisa de um pequeno pedaço de código como este:

private const string LOGIN = "mamy";
private const string DOMAIN = "mongo";
private const string PASSWORD = "HelloMongo2017";

private void DBConnection()
{
    using (Impersonator user = new Impersonator(LOGIN, DOMAIN, PASSWORD, LogonType.LOGON32_LOGON_NEW_CREDENTIALS, LogonProvider.LOGON32_PROVIDER_WINNT50))
    {
    }
}

E adicione a classe dele:

Representação do .NET (C #) com credenciais de rede

Meu exemplo pode ser usado se você precisar que o logon representado tenha credenciais de rede, mas ele tem mais opções.


1
Sua abordagem parece mais genérico ao ser mais específico sobre os parâmetros +1
Kerry Perret

Ao utilizar nosso site, você reconhece que leu e compreendeu nossa Política de Cookies e nossa Política de Privacidade.
Licensed under cc by-sa 3.0 with attribution required.