Как вы делаете олицетворение в.NET?
Есть ли простой способ изобразить пользователя в.NET?
До сих пор я использовал этот класс из проекта кода для всех моих требований к олицетворению.
Есть ли лучший способ сделать это с помощью.NET Framework?
У меня есть набор учетных данных пользователя (имя пользователя, пароль, доменное имя), который представляет собой личность, необходимую для олицетворения.
7 ответов
Вот хороший обзор концепций олицетворения.NET.
- Михель ван Отегем: WindowsImpersonationContext стало проще
- Метод WindowsIdentity.Impersonate (ознакомьтесь с примерами кода)
По сути, вы будете использовать эти классы, входящие в комплект.NET Framework:
Код часто может быть длинным, и поэтому вы видите много примеров, таких как тот, на который вы ссылаетесь, которые пытаются упростить процесс.
"Олицетворение" в пространстве.NET обычно означает запуск кода под определенной учетной записью пользователя. Это несколько отдельная концепция, чем получение доступа к этой учетной записи пользователя с помощью имени пользователя и пароля, хотя эти две идеи часто объединяются. Я опишу их обоих, а затем объясню, как использовать мою библиотеку https://github.com/mj1856/SimpleImpersonation, которая использует их внутренне.
олицетворение
API для олицетворения предоставляются в.NET через System.Security.Principal
Пространство имен:
Более новый код (.NET 4.6+, .NET Core и т. Д.) Обычно следует использовать
WindowsIdentity.RunImpersonated
, который принимает дескриптор токена учетной записи пользователя, а затем либоAction
или жеFunc<T>
для кода для выполнения.WindowsIdentity.RunImpersonated(tokenHandle, () => { // do whatever you want as this user. });
или же
var result = WindowsIdentity.RunImpersonated(tokenHandle, () => { // do whatever you want as this user. return result; });
Старый код использовал
WindowsIdentity.Impersonate
метод для полученияWindowsImpersonationContext
объект. Этот объект реализуетIDisposable
так что вообще следует вызывать сusing
блок.using (WindowsImpersonationContext context = WindowsIdentity.Impersonate(tokenHandle)) { // do whatever you want as this user. }
Хотя этот API все еще существует в.NET Framework, его, как правило, следует избегать, и он недоступен в.NET Core или.NET Standard.
Доступ к учетной записи пользователя
API для использования имени пользователя и пароля для получения доступа к учетной записи пользователя в Windows LogonUser
- который является родным API Win32. В настоящее время нет встроенного.NET API для его вызова, поэтому следует прибегнуть к 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);
Это базовое определение вызова, однако есть еще много вещей, которые нужно учитывать, чтобы фактически использовать его в производстве:
- Получение ручки с "безопасным" шаблоном доступа.
- Закрытие родных ручек соответственно
- Уровни доверия безопасности доступа к коду (CAS) (только в.NET Framework)
- Переходя
SecureString
когда вы можете безопасно собрать один с помощью пользовательских клавиш.
Объем кода, который нужно написать для иллюстрации всего этого, выходит за рамки того, что должно быть в ответе Stackru, ИМХО.
Комбинированный и более простой подход
Вместо того, чтобы писать все это самостоятельно, рассмотрите возможность использования моей библиотеки https://github.com/mj1856/SimpleImpersonation, которая объединяет олицетворение и пользовательский доступ в одном API. Он хорошо работает как в современных, так и в старых базах кода с тем же простым API:
var credentials = new UserCredentials(domain, username, password);
Impersonation.RunAsUser(credentials, logonType, () =>
{
// do whatever you want as this user.
});
или же
var credentials = new UserCredentials(domain, username, password);
var result = Impersonation.RunAsUser(credentials, logonType, () =>
{
// do whatever you want as this user.
return something;
});
Обратите внимание, что это очень похоже на WindowsIdentity.RunImpersonated
API, но не требует, чтобы вы ничего не знали о маркерах токенов.
Это API версии 3.0.0. Смотрите readme проекта для более подробной информации. Также обратите внимание, что в предыдущей версии библиотеки использовался API с IDisposable
шаблон, похожий на WindowsIdentity.Impersonate
, Более новая версия намного безопаснее, и обе они до сих пор используются внутри компании.
Это, вероятно, то, что вы хотите:
using System.Security.Principal;
using(WindowsIdentity.GetCurrent().Impersonate())
{
//your code goes here
}
Но мне действительно нужно больше деталей, чтобы помочь вам. Вы можете выполнить олицетворение с помощью файла конфигурации (если вы пытаетесь сделать это на веб-сайте) или с помощью декораторов методов (атрибутов), если это служба WCF, или с помощью... у вас есть идея.
Кроме того, если мы говорим о олицетворении клиента, который вызвал определенную службу (или веб-приложение), вам необходимо правильно настроить клиент так, чтобы он передавал соответствующие токены.
Наконец, если вы действительно хотите делегировать, вам также нужно правильно настроить AD, чтобы пользователям и компьютерам доверяли делегирование.
Редактировать:
Посмотрите здесь, чтобы узнать, как выдать себя за другого пользователя, и для получения дополнительной документации.
Вот мой vb.net порт ответа Мэтта Джонсона. Я добавил перечисление для типов входа. LOGON32_LOGON_INTERACTIVE
был первым значением перечисления, которое работало для сервера sql. Моя строка подключения была просто доверенной. Нет имени пользователя / пароля в строке подключения.
<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
Вам нужно использовать с Using
заявление, чтобы содержать некоторый код для запуска олицетворенного.
Посмотреть более подробную информацию из моего предыдущего ответа Я создал пакет Nuget Nuget
Код на Github
образец: вы можете использовать:
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 полный код:
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
}
Я знаю, что опаздываю на вечеринку, но считаю, что библиотека от Филиппа Аллана-Хардинга- лучшая для этого случая и подобных.
Вам нужен только небольшой фрагмент кода, подобный этому:
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))
{
}
}
И добавьте его класс:
Олицетворение.NET (C#) с сетевыми учетными данными
Мой пример может быть использован, если вы требуете, чтобы олицетворенный вход в систему имел сетевые учетные данные, но у него есть больше параметров.
Вы можете использовать это решение. (Используйте пакет nuget) Исходный код доступен на: Github: https://github.com/michelcedric/UserImpersonation
Более подробно https://michelcedric.wordpress.com/2015/09/03/usurpation-didentite-dun-user-c-user-impersonation/