Click here to Skip to main content
Click here to Skip to main content
Go to top

Windows Impersonation using C#

, 29 Apr 2003
Rate this:
Please Sign up or sign in to vote.
An article demonstrating how to use Windows impersonation in your C# code

Impersonation

Introduction

I've been a member of the CodeProject for over 3 years now, and still haven't contributed any articles - until now.

While designing a Windows Forms-based application, to administrate containers in our Active Directory, I needed a way to allow binding to the AD using alternate credentials. Windows impersonation was the answer. This sample app demonstrates how to use unmanaged code by calling LogonUser() contained within the advapi32.dll, and pass a token handle back to your .NET application using WindowsImpersonationContext.

One of the downfalls to the LogonUser()function is that the password get passed in clear-text.

Partial Source Code

using System.Runtime.InteropServices; // DllImport
using System.Security.Principal; // WindowsImpersonationContext
using System.Security.Permissions; // PermissionSetAttribute
...

public WindowsImpersonationContext 
    ImpersonateUser(string sUsername, string sDomain, string sPassword)
{
    // initialize tokens
    IntPtr pExistingTokenHandle = new IntPtr(0);
    IntPtr pDuplicateTokenHandle = new IntPtr(0);
    pExistingTokenHandle = IntPtr.Zero;
    pDuplicateTokenHandle = IntPtr.Zero;
    
    // if domain name was blank, assume local machine
    if (sDomain == "")
        sDomain = System.Environment.MachineName;

    try
    {
        string sResult = null;

        const int LOGON32_PROVIDER_DEFAULT = 0;

        // create token
        const int LOGON32_LOGON_INTERACTIVE = 2;
        //const int SecurityImpersonation = 2;

        // get handle to token
        bool bImpersonated = LogonUser(sUsername, sDomain, sPassword, 
            LOGON32_LOGON_INTERACTIVE, LOGON32_PROVIDER_DEFAULT, 
                ref pExistingTokenHandle);

        // did impersonation fail?
        if (false == bImpersonated)
        {
            int nErrorCode = Marshal.GetLastWin32Error();
            sResult = "LogonUser() failed with error code: " + 
                nErrorCode + "\r\n";

            // show the reason why LogonUser failed
            MessageBox.Show(this, sResult, "Error", 
                MessageBoxButtons.OK, MessageBoxIcon.Error);
        }

        // Get identity before impersonation
        sResult += "Before impersonation: " + 
            WindowsIdentity.GetCurrent().Name + "\r\n";

        bool bRetVal = DuplicateToken(pExistingTokenHandle, 
            (int)SECURITY_IMPERSONATION_LEVEL.SecurityImpersonation, 
                ref pDuplicateTokenHandle);

        // did DuplicateToken fail?
        if (false == bRetVal)
        {
            int nErrorCode = Marshal.GetLastWin32Error();
            // close existing handle
            CloseHandle(pExistingTokenHandle); 
            sResult += "DuplicateToken() failed with error code: " 
                + nErrorCode + "\r\n";

            // show the reason why DuplicateToken failed
            MessageBox.Show(this, sResult, "Error", 
                MessageBoxButtons.OK, MessageBoxIcon.Error);
            return null;
        }
        else
        {
            // create new identity using new primary token
            WindowsIdentity newId = new WindowsIdentity
                                        (pDuplicateTokenHandle);
            WindowsImpersonationContext impersonatedUser = 
                                        newId.Impersonate();

            // check the identity after impersonation
            sResult += "After impersonation: " + 
                WindowsIdentity.GetCurrent().Name + "\r\n";
            
            MessageBox.Show(this, sResult, "Success", 
                MessageBoxButtons.OK, MessageBoxIcon.Information);
            return impersonatedUser;
        }
    }
    catch (Exception ex)
    {
        throw ex;
    }
    finally
    {
        // close handle(s)
        if (pExistingTokenHandle != IntPtr.Zero)
            CloseHandle(pExistingTokenHandle);
        if (pDuplicateTokenHandle != IntPtr.Zero) 
            CloseHandle(pDuplicateTokenHandle);
    }
}

Points of Interest

This code won't work on Windows 98 or ME because they do not utilize user tokens. Code was built and run using Visual Studio.NET 2002 on Windows XP Service Pack 1.

One of the other uses for this code I've found is, for instantiating COM components that must run in an alternate security context to that of the logged-on user.

If anyone has a more secure method of achieving the same thing, please let me know.

History

  • Version 1.0 - 04.25.03 - First release version

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Marc Merritt
Architect
United States United States
I live in southeastern Pennsylvania, USA with my lovely wife and two beautiful daughters. Life is good. My hobbies are motorcycles, motorcycles, and motorcycles.
 
I run a riders group called Twisties Motorcycle Club. If you're are a rider in the tri-state area, look us up! http://twistiesmc.com/
Follow on   Twitter

Comments and Discussions

 
GeneralMy vote of 5 Pinmembersrilekhamenon1-Sep-14 2:25 
QuestionThanks a lot, you saved 2 hrs. PinmemberMember 103845676-Nov-13 8:23 
AnswerRe: Thanks a lot, you saved 2 hrs. PinmemberMarc Merritt12-Nov-13 8:34 
GeneralRe: Thanks a lot, you saved 2 hrs. PinmemberOded Arbel20-Mar-14 3:04 
GeneralRe: Thanks a lot, you saved 2 hrs. PinmemberMarc Merritt20-Mar-14 3:10 
GeneralRe: Thanks a lot, you saved 2 hrs. PinmemberGuss7720-Mar-14 9:47 
Questionsource code help PinmemberPyakaa17-Dec-12 1:43 
GeneralMy vote of 5 Pinmemberkerkenez20004-Apr-12 23:35 
QuestionCall LogonUser PinmemberMember 822764117-Sep-11 13:40 
QuestionPlease I need a Help Pinmemberkaiserssosse11-Aug-11 1:41 
AnswerRe: Please I need a Help Pinmemberdiialer21-Aug-11 7:36 
GeneralRe: Please I need a Help Pinmemberkaiserssosse21-Aug-11 21:03 
GeneralIs Windows Impersionation Thread or Process Level ? PinmemberThomas Haller27-May-11 2:42 
GeneralThanks Pinmemberolivier gg14-Feb-11 8:43 
GeneralWIndows 7 Pinmembermoralam13-Jul-10 7:58 
GeneralRe: WIndows 7 PinmemberMarc Merritt28-Jan-13 5:25 
QuestionCross domain impersonation Pinmemberatulsureka18-Apr-10 2:25 
AnswerRe: Cross domain impersonation Pinmemberdeadwood8827-Sep-10 2:00 
GeneralRe: Cross domain impersonation PinmemberCstruter26-Oct-10 21:38 
GeneralRe: Cross domain impersonation Pinmembersabh2125-Jan-13 1:32 
GeneralCreate a folder on a remote computer PinmemberShlomo6-Jan-10 1:52 
GeneralWindows 2008 server Pinmembersmithafebinkal3-Dec-08 18:45 
GeneralThis process not working with a WPF application!!! PinmemberArshad Kunnath31-Jul-08 1:36 
GeneralRe: This process not working with a WPF application!!! PinmemberMarc Merritt31-Jul-08 2:59 
GeneralRe: This process not working with a WPF application!!! PinmemberMatei Focseneanu12-May-10 5:15 
GeneralRe: This process not working with a WPF application!!! PinmemberJason Jakob20-Jun-13 5:09 
QuestionIt may be.... PinmemberWillian.BR15-May-08 8:55 
Hi,
It's a nice work. Congratulations!
 
But,
 
I would like to run a small windows service application.
It will make some tasks and than the service may run another
process but with other local credentials.
The main service will run under SYSTEM account.
 
Can you help me?
 
Thanks!
 
Willian S. Rodrigues
willian_cpp_br@hotmail.com

GeneralWindows CE .net Pinmemberquestions_c1-Oct-07 2:28 
GeneralRe: Windows CE .net PinmemberMarc Merritt1-Oct-07 15:18 
GeneralRe: Windows CE .net PinmemberPram_Singh4120-Jul-09 4:22 
GeneralError Code 1326 [modified] Pinmembercollapo21-Aug-07 0:56 
GeneralRe: Error Code 1326 Pinmembermirh10-Oct-07 1:59 
GeneralRe: Error Code 1326 Pinmembermustiy9-Feb-10 23:17 
GeneralError 1314 Pinmemberm.aldegheri3-Aug-06 6:28 
GeneralRe: Error 1314 Pinmemberm.aldegheri3-Aug-06 22:23 
GeneralRe: Error 1314 PinmemberMunkieFish11-Apr-07 7:49 
AnswerRe: Error 1314 Pinmemberuppals12-Apr-07 13:06 
GeneralHelp needed Windows 2000 SP4 still getting 1314! -- Re: Error 1314 Pinmemberdevvvy21-Feb-08 20:41 
GeneralRe: Help needed Windows 2000 SP4 still getting 1314! -- Re: Error 1314 PinmemberMarc Merritt26-Feb-08 3:02 
Questionhow to use this in case of a local account? Pinmemberyossof elnaggar27-Jun-06 20:29 
AnswerRe: how to use this in case of a local account? Pinmemberhk1112-Jul-07 19:04 
GeneralRe: how to use this in case of a local account? Pinmemberappalanaidu Aug20118-Feb-12 20:54 
GeneralFirst call takes too long Pinmemberschweeneh4-Apr-06 6:04 
GeneralRe: First call takes too long PinmemberMarc Merritt12-Jun-06 2:24 
GeneralA similar article [modified] PinsitebuilderUwe Keim23-Apr-05 23:59 
GeneralRe: A similar article Pinmembercraigg753-Nov-06 5:57 
GeneralRe: A similar article PinsitebuilderUwe Keim3-Nov-06 6:14 
GeneralImpersonation Pinmemberchriskoiak16-Mar-04 5:13 
QuestionRe: Impersonation Pinmembertee_jay10-Apr-06 22:08 
AnswerRe: Impersonation Pinmemberhk1112-Jul-07 19:01 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web01 | 2.8.140926.1 | Last Updated 30 Apr 2003
Article Copyright 2003 by Marc Merritt
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid