ShareHound: Mapeo de derechos de recursos compartidos de red mediante BloodHound OpenGraph

Una herramienta para mapear los derechos de acceso de los recursos compartidos de red en OpenGraphs de BloodHound.

Lee el artículo de blog asociado: https://specterops.io/blog/2025/10/30/sharehound-an-opengraph-collector-for-network-shares/

Dos implementaciones

Este repositorio contiene dos implementaciones de ShareHound. Ambas comparten el mismo objetivo — generar JSON de OpenGraph de BloodHound a partir de los permisos de recursos compartidos SMB — pero difieren en lenguaje, tiempo de ejecución y conjunto de funciones. Elige la que mejor se adapte a tu flujo de trabajo.

Implementación	Ruta	Autor	Ideal para
Python	`Python/`	Remi Gascou (@podalirius_) @ SpecterOps	La implementación de referencia; fácil de ampliar y automatizar
Go	`Go/`	Javier Azofra @ Siemens Healthineers	Escaneos a gran escala (60,000+ hosts), puntos de control, binarios estáticos

Cada subdirectorio tiene su propio README con todos los detalles de instalación, uso y configuración:

Características (comunes a ambos)

Mapea los recursos compartidos de red de un dominio y sus derechos en formato OpenGraph de BloodHound
Coincidencia de reglas altamente personalizable mediante el lenguaje ShareQL
Descubrimiento de recursos compartidos con múltiples hilos (búsqueda en anchura)
Autenticación NTLM, Kerberos y pass-the-hash
Soporte para rangos CIDR y archivos de objetivos

Características adicionales en la implementación Go

Salida en streaming comprimida en ZIP (maneja millones de aristas)
Escaneos reanudables mediante archivos de checkpoint
Modo --effective-access-only para reducir drásticamente el tamaño del grafo en entornos grandes
Compilaciones estáticas multiplataforma (Linux, Windows, macOS)

Consultas Cypher de inicio rápido

Una vez que hayas importado el OpenGraph en BloodHound, estas consultas cubren las necesidades más comunes. Para más, consulta los README de cada implementación.

Buscar principales con acceso de Control total a un recurso compartido

MATCH (p)-[r]->(s:NetworkShareSMB)
WHERE (p)-[:CanDelete]->(s)
  AND (p)-[:CanDsControlAccess]->(s)
  AND (p)-[:CanDsCreateChild]->(s)
  AND (p)-[:CanDsDeleteChild]->(s)
  AND (p)-[:CanDsDeleteTree]->(s)
  AND (p)-[:CanDsListContents]->(s)
  AND (p)-[:CanDsListObject]->(s)
  AND (p)-[:CanDsReadProperty]->(s)
  AND (p)-[:CanDsWriteExtendedProperties]->(s)
  AND (p)-[:CanDsWriteProperty]->(s)
  AND (p)-[:CanReadControl]->(s)
  AND (p)-[:CanWriteDacl]->(s)
  AND (p)-[:CanWriteOwner]->(s)
RETURN p,r,s

Buscar principales con acceso de Escritura a un recurso compartido

MATCH x=(p)-[r:CanWriteDacl|CanWriteOwner|CanDsWriteProperty|CanDsWriteExtendedProperties]->(s:NetworkShareSMB)
RETURN x

Buscar archivos por nombre (sin distinguir entre mayúsculas y minúsculas)

MATCH p=(h:NetworkShareHost)-[:HasNetworkShare]->(s:NetworkShareSMB)-[:Contains*0..]->(f:File)
WHERE toLower(f.name) = toLower("flag.txt")
RETURN p

Buscar archivos por extensión (sin distinguir entre mayúsculas y minúsculas)

MATCH p=(h:NetworkShareHost)-[:HasNetworkShare]->(s:NetworkShareSMB)-[:Contains*0..]->(f:File)
WHERE toLower(f.extension) = toLower(".vmdk")
RETURN p

Buscar archivos que un principal puede leer de forma efectiva (solo Go)

Las aristas CanEffectiveRead / CanEffectiveWrite / CanEffectiveExecute son emitidas por la implementación Go cuando el mismo SID tiene derechos coincidentes tanto a nivel de recurso compartido como de NTFS, es decir, el acceso real otorgado a través de SMB.

MATCH p=(principal)-[:CanEffectiveRead]->(f:File)
RETURN p

Créditos

Proyecto original: Remi Gascou (@podalirius_) @ SpecterOps — p0dalirius/ShareHound
Implementación Go: Javier Azofra @ Siemens Healthineers
Artículo de blog asociado: ShareHound: An OpenGraph Collector for Network Shares

Contribuciones

Las pull requests son bienvenidas para cualquiera de las dos implementaciones. Abre un issue si quieres discutir primero una nueva funcionalidad.

ShareHound

Más Populares