LocalGroups-rs enumerates Windows local group membership over MS-SAMR and turns it into BloodHound-shaped LocalGroups data: the AdminTo, CanRDP, ExecuteDCOM and CanPSRemote edges. It opens the BUILTIN aliases on each target (SamrOpenAlias / SamrGetMembersInAlias) and reports their members as SIDs, filtering out the accounts that live only in the target's own SAM.
It was built to prototype the Computer:LocalGroups line of the RustHound-CE roadmap, tracked as RustHound-CE#69, the last live-collection field SharpHound fills and RustHound-CE does not. It is pure Rust on icedracon's DCE/RPC stack (dcerpc + smb2-client), the same one behind HasSession-rs, and its src/transport/ folder is copied unchanged from RustHound-CE so the eventual port is a move rather than a rewrite.
- HELP.md - How to compile it? How to use it? All options with examples.
- CHANGELOG.md - A record of all significant version changes
- ROADMAP.md - Implemented collection and planned evolutions.
Upstream tracking issue: RustHound-CE#69 [Feature Request] LocalGroups
Quick usage
Compilation
# Build a release binary
# Binary: ./target/release/localgroups-rs
Installation
# Install and/or update localgroups-rs from cargo command
Usage
# Every alias, one host, password bind
# Local admins only, wide sweep, pass-the-hash
# Kerberos pass-the-ticket from a ccache
# Who is admin where?
|
Three authentication paths are supported, exactly as in RustHound-CE: NTLMv2 bind (-p), pass-the-hash (-H), and Kerberos pass-the-ticket (-k, TGT read from KRB5CCNAME). More examples and the full option list are on the help page.
Demo
Collection
| RID | BUILTIN group | BloodHound edge | Typical privilege needed |
|---|---|---|---|
| 544 | Administrators | AdminTo |
local admin on a member host; any domain user on a DC |
| 555 | Remote Desktop Users | CanRDP |
same |
| 562 | Distributed COM Users | ExecuteDCOM |
same |
| 580 | Remote Management Users | CanPSRemote |
same; absent on some older or Core builds |
Select a subset with -c AdminOnly / RdpOnly / DcomOnly / PSRemoteOnly. All is the default.
Everything is read-only: SamrOpenAlias is requested with ALIAS_LIST_MEMBERS and nothing else, and no write opnum is compiled in.
Output
computers[].LOCALGroups[] is serialized in exactly the shape RustHound-CE's objects::common::LocalGroup expects, so the port is a straight field map:
edges[] and by_principal are the operator-facing views: what HasSession-rs does for sessions, this does for local group membership.
Credits
Built on icedracon's pure-Rust stack: dcerpc, smb2-client, ms-ndr and windows-sddl. The SMB2/SAMR pipeline follows adhammer's enum samr; the alias branch (opnums 27 and 33) is added here. The Kerberos and GSS helpers in src/transport/ are RustHound-CE's, themselves ported from adhammer. The alias-to-edge mapping and the local-member filtering rule come from SharpHound's LocalGroupProcessor.cs.