Impersonating a user

You can impersonate users and perform actions on their behalf, for troubleshooting, unblocking, and other legitimate reasons.

Enterprise owners can impersonate users within their enterprise.

About user impersonation

If you need to temporarily take over a user account, for example when troubleshooting a user problem, or when the user is unavailable and urgent action is required, you can start an impersonation session to act on their behalf.

For each impersonation session, you need to provide a reason for the impersonation. A session is limited to one hour, and you will have the same access as the user being impersonated.

Actions you perform during an impersonation session are recorded as events in the enterprise audit log, as well as the impersonated user's security log. The person being impersonated is sent an email notification when the impersonation session starts. For more information, see "Audited actions" and "Reviewing your security log."

Impersonating a user

  1. From an administrative account on GitHub Enterprise Server, click in the upper-right corner of any page. Rocketship icon for accessing site admin settings

  2. In the search field, type the name of the user and click Search. Site admin settings search field

  3. In the search results, click the name of the user. Site admin settings search options

  4. In the top left of the page, click User info.

    User info

  5. Under "Danger Zone", click Sign in to GitHub as @username

    Impersonate user

  6. Select a reason from the dropdown list. If you select Other you will need to provide additional context in the Notes section. Click Begin impersonation to begin the session.

    Impersonation reason

  7. When you are ready to end the impersonation session, click the Return to your mundane life as username banner at the top of the page.

    End impersonation

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.