L'impersonation est un mécanisme permettant d'effectuer une action en tant qu'un autre utilisateur. Par exemple pour exécuter une action précise il faut être administrateur, on utilise l'impersonation pour exécuter l'action avec un compte administrateur.
Voyons un exemple (Ne pas l'utiliser en l'état) :
const string domainName = "meziantou";
const string userName = "administrator";
const string password = "password";
const int LOGON32_PROVIDER_DEFAULT = 0;
//This parameter causes LogonUser to create a primary token.
const int LOGON32_LOGON_INTERACTIVE = 2;
// Call LogonUser to obtain a handle to an access token.
SafeTokenHandle safeTokenHandle;
bool returnValue = LogonUser(userName, domainName, password,
LOGON32_LOGON_INTERACTIVE, LOGON32_PROVIDER_DEFAULT,
out safeTokenHandle);
if (false == returnValue)
{
int ret = Marshal.GetLastWin32Error();
Console.WriteLine("LogonUser failed with error code : {0}", ret);
throw new System.ComponentModel.Win32Exception(ret);
}
using (safeTokenHandle)
{
WindowsIdentity newId = new WindowsIdentity(safeTokenHandle.DangerousGetHandle());
WindowsImpersonationContext impersonatedUser = null;
impersonatedUser = newId.Impersonate();
// Les actions sont effectuées avec le compte administrator
File.WriteAllText("c:\\test.txt", WindowsIdentity.GetCurrent().Name); // Ecrit Meziantou\Administrator
impersonatedUser.Dispose(); // Fin du code ayant besoin des droits administrateur
}
Pour le moment ce code fait ce qu'on lui demande, mais qu'en est-il de la sécurité ? En fait le seul risque d'un tel code est qu'une méthode appelant ce code puisse exécuter du code en tant qu'administrateur. Vous me direz que ce n'est pas possible car on appelle la méthode Dispose pour finir le context d'impersonation. Certes mais que ce passe-t-il si le code exécuter dans le context d'impersonation lève une exception (par exemple si le disque dur est plein) ? La méthode dispose n'est plus appelée et le code appelant continue son exécution avec les droits administrateurs !!!
public static void Main()
{
try { Impersonate(); }
catch { /* Administrateur */ }
}
public static void Impersonate()
{
...
impersonatedUser = newId.Impersonate();
throw new Exception("Fail");
impersonatedUser.Dispose(); // N'est pas appelé
}
Il faut donc gérer ce problème de sécurité. Pour cela il existe 2 façons de faire:
- En gérant l'exception avec un try finally
impersonatedUser = newId.Impersonate();
try
{
File.WriteAllText("c:\\test.txt", WindowsIdentity.GetCurrent().Name); // Affiche Meziantou\Administrator
}
finally
{
impersonatedUser.Dispose();
}
- en utilisant le mot clé “using”
using(impersonatedUser = newId.Impersonate())
{
File.WriteAllText("c:\\test.txt", WindowsIdentity.GetCurrent().Name); // Affiche Meziantou\Administrator
}
Le compilateur C# remplacera ce code par un code équivalent à la première méthode (je vous laisse décompiler pour vérifier).
En utilisant une de ces 2 méthodes, la méthode Dispose sera appelée avant que l'exception ne remonte à la méthode appelante. Il n'y a donc plus de problème de sécurité.
Voici donc le code correct complet:
const string domainName = "meziantou";
const string userName = "administrator";
const string password = "password";
const int LOGON32_PROVIDER_DEFAULT = 0;
//This parameter causes LogonUser to create a primary token.
const int LOGON32_LOGON_INTERACTIVE = 2;
// Call LogonUser to obtain a handle to an access token.
SafeTokenHandle safeTokenHandle;
bool returnValue = LogonUser(userName, domainName, password,
LOGON32_LOGON_INTERACTIVE, LOGON32_PROVIDER_DEFAULT,
out safeTokenHandle);
if (false == returnValue)
{
int ret = Marshal.GetLastWin32Error();
Console.WriteLine("LogonUser failed with error code : {0}", ret);
throw new System.ComponentModel.Win32Exception(ret);
}
using (safeTokenHandle)
{
WindowsIdentity newId = new WindowsIdentity(safeTokenHandle.DangerousGetHandle());
using(WindowsImpersonationContext impersonatedUser = newId.Impersonate())
{
// Les actions sont effectuées avec le compte administrator
File.WriteAllText("c:\\test.txt", WindowsIdentity.GetCurrent().Name); // Ecrit Meziantou\Administrator
} // Fin du code ayant besoin des droits administrateur
}