# sensepost/impersonate architecture

> Architecture diagram of the GitHub repository sensepost/impersonate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sensepost/impersonate
- Repository: https://github.com/sensepost/impersonate

## Overview

Impersonate is a Windows token-manipulation toolkit. Its main workflow scans system handles for available tokens, displays them for selection, then uses a selected token to launch a command or perform the documented add-user privilege escalation. The repository also provides a CrackMapExec Python module with an embedded binary, a corresponding CME binary, and a separate token-listing example. The C++ excerpts support the scan and execution relationships; Python-module behavior is described only at a high level in the README.

Main entry points: [`Impersonate/Impersonate/Impersonate.cpp`](https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp) (Standalone tool), [`impersonate.py`](https://github.com/sensepost/impersonate/blob/main/impersonate.py) (CME Python module), [`CME_module/Impersonate/Impersonate.cpp`](https://github.com/sensepost/impersonate/blob/main/CME_module/Impersonate/Impersonate.cpp) (CME binary), [`list_tokens.c`](https://github.com/sensepost/impersonate/blob/main/list_tokens.c) (Token-list example)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Tool interfaces"]
  node_standalone["Standalone tool<br/>[Impersonate.cpp]"]
  node_cme_python["CME Python module<br/>[impersonate.py]"]
  node_cme_binary["CME binary<br/>[Impersonate.cpp]"]
  node_cme_runtime["Embedded executable<br/>[impersonate.py]"]
end

subgraph group_token_workflow["Token workflow"]
  node_token_scan["Token discovery<br/>[Impersonate.cpp]"]
  node_token_metadata["Token metadata<br/>[Impersonate.cpp]"]
  node_token_list["Token listing<br/>[Impersonate.cpp]"]
  node_token_select["Token selection<br/>[Impersonate.cpp]"]
  node_cme_scan["CME token tool<br/>[Impersonate.cpp]"]
end

subgraph group_actions["Token actions"]
  node_launch["Command execution<br/>[Impersonate.cpp]"]
  node_add_user["Domain add-user<br/>[Impersonate.cpp]"]
end

subgraph group_examples["Related code"]
  node_list_example["Token-list example<br/>[list_tokens.c]"]
end

node_operator(("Operator"))
node_windows["Windows host"]
node_domain_controller["Domain controller"]

node_operator -->|"runs"| node_standalone
node_standalone -->|"scans handles"| node_token_scan
node_token_scan -->|"reads metadata"| node_token_metadata
node_standalone -->|"lists tokens"| node_token_list
node_standalone -->|"selects token"| node_token_select
node_token_select -->|"executes command"| node_launch
node_token_select -->|"adds account"| node_add_user
node_launch -->|"starts process"| node_windows
node_add_user -->|"adds domain user"| node_domain_controller
node_operator -->|"uses module"| node_cme_python
node_cme_python -->|"embeds binary"| node_cme_runtime
node_operator -->|"runs"| node_cme_binary
node_cme_binary -->|"scans tokens"| node_cme_scan
node_operator -->|"runs example"| node_list_example
node_list_example -->|"queries handles"| node_windows

click node_standalone "https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp"
click node_cme_python "https://github.com/sensepost/impersonate/blob/main/impersonate.py"
click node_cme_binary "https://github.com/sensepost/impersonate/blob/main/CME_module/Impersonate/Impersonate.cpp"
click node_token_scan "https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp"
click node_token_metadata "https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp"
click node_token_list "https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp"
click node_token_select "https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp"
click node_launch "https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp"
click node_add_user "https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp"
click node_cme_runtime "https://github.com/sensepost/impersonate/blob/main/impersonate.py"
click node_cme_scan "https://github.com/sensepost/impersonate/blob/main/CME_module/Impersonate/Impersonate.cpp"
click node_list_example "https://github.com/sensepost/impersonate/blob/main/list_tokens.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_standalone,node_cme_python,node_cme_binary,node_cme_runtime toneBlue
class node_token_scan,node_token_metadata,node_token_list,node_token_select,node_cme_scan toneAmber
class node_launch,node_add_user toneMint
class node_list_example toneRose
class node_operator,node_windows,node_domain_controller toneIndigo
```

## Components

### Tool interfaces

- [Standalone tool](https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp): `Impersonate/Impersonate/Impersonate.cpp`
- [CME Python module](https://github.com/sensepost/impersonate/blob/main/impersonate.py): `impersonate.py`
- [CME binary](https://github.com/sensepost/impersonate/blob/main/CME_module/Impersonate/Impersonate.cpp): `CME_module/Impersonate/Impersonate.cpp`
- [Embedded executable](https://github.com/sensepost/impersonate/blob/main/impersonate.py): `impersonate.py`

### Token workflow

- [Token discovery](https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp): `Impersonate/Impersonate/Impersonate.cpp`
- [Token metadata](https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp): `Impersonate/Impersonate/Impersonate.cpp`
- [Token listing](https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp): `Impersonate/Impersonate/Impersonate.cpp`
- [Token selection](https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp): `Impersonate/Impersonate/Impersonate.cpp`
- [CME token tool](https://github.com/sensepost/impersonate/blob/main/CME_module/Impersonate/Impersonate.cpp): `CME_module/Impersonate/Impersonate.cpp`

### Token actions

- [Command execution](https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp): `Impersonate/Impersonate/Impersonate.cpp`
- [Domain add-user](https://github.com/sensepost/impersonate/blob/main/Impersonate/Impersonate/Impersonate.cpp): `Impersonate/Impersonate/Impersonate.cpp`

### Related code

- [Token-list example](https://github.com/sensepost/impersonate/blob/main/list_tokens.c): `list_tokens.c`

### Other components

- **Operator**
- **Windows host**
- **Domain controller**

## Connections

- Operator → Standalone tool: runs (evidence: `README.md`)
- Standalone tool → Token discovery: scans handles (evidence: `Impersonate/Impersonate/Impersonate.cpp`)
- Token discovery → Token metadata: reads metadata (evidence: `Impersonate/Impersonate/Impersonate.cpp`)
- Standalone tool → Token listing: lists tokens (evidence: `Impersonate/Impersonate/Impersonate.cpp`)
- Standalone tool → Token selection: selects token (evidence: `Impersonate/Impersonate/Impersonate.cpp`)
- Token selection → Command execution: executes command (evidence: `Impersonate/Impersonate/Impersonate.cpp`)
- Token selection → Domain add-user: adds account (evidence: `README.md`)
- Command execution → Windows host: starts process (evidence: `Impersonate/Impersonate/Impersonate.cpp`)
- Domain add-user → Domain controller: adds domain user
- Operator → CME Python module: uses module (evidence: `README.md`)
- CME Python module → Embedded executable: embeds binary (evidence: `README.md`)
- Operator → CME binary: runs (evidence: `README.md`)
- CME binary → CME token tool: scans tokens (evidence: `CME_module/Impersonate/Impersonate.cpp`)
- Operator → Token-list example: runs example (evidence: `README.md`)
- Token-list example → Windows host: queries handles (evidence: `list_tokens.c`)
