Um shell de linha de comando interativo para a API do BloodHound.
Um shell de linha de comando interativo para o BloodHound. Consulte objetos do Active Directory, procure por vulnerabilidades e encontre caminhos de ataque a partir do terminal, sem abrir a interface web.
Requer Python 3.11+ e um servidor BloodHound CE v9 (testado na v9.7.1).
pipx install bhshell # recommended
# or
pip install bhshell
$ bhshell --url http://127.0.0.1:8080
[bh: shell] > login -u admin
[+] Logged in as admin on 127.0.0.1:8080
[bh: shell] > hunt
Severity Check Count Example Description
critical dcsync 4 [email protected] Non-Tier-Zero principals with replication rights
critical adcs 95 [email protected] AD CS escalation paths (ESC*, GoldenCert)
high kerberoastable 2 [email protected] Kerberoastable users
...
[*] Details: 'hunt CHECK' (e.g. 'hunt dcsync'), or 'hunt --all'.
[bh: shell] > user PHANTOM\svc_kerb_del --all -o svc_kerb_del.csv
[bh: shell] > ou phantom.corp -t
[bh: shell] > computer DF-MS-SHS -G
[bh: shell] > gpo 'ENABLE [email protected]' -c
[bh: shell] > path --owned -g
Os mesmos comandos são executados de forma não interativa para scripts: bhshell -c "hunt --json" > hunt.json.
| Comando | Mostra |
|---|---|
user, computer, group, lookup | Kerberoastable / AS-REP roastable, delegação, idade da senha, flags Tier Zero e owned, além de aninhamento de grupos, controle de ACL de entrada/saída, sessões e direitos de administrador local |
ou | OUs, contêineres e domínios inteiros: a árvore de OUs com contagens de objetos, Tier Zero e owned, todos os objetos abaixo de uma OU, as GPOs que se aplicam (links impostos, herança bloqueada) e quem fora do Tier Zero pode editá-las, e quem controla a OU; user/computer -G mostra as GPOs aplicadas a um objeto. OUs com o mesmo nome são selecionadas pelo distinguished name |
gpo | Onde uma GPO está vinculada, os usuários e computadores aos quais ela se aplica (considerando herança bloqueada e links impostos) e quem fora do Tier Zero pode editá-la |
ca, template | CAs corporativas e modelos de certificado: as condições ESC que um modelo atende (incluindo ESC2 e ESC15, para as quais o BloodHound não tem aresta), o host e as configurações da CA (ESC6, ESC8), e quem pode se inscrever, gerenciar (ESC7) ou reescrevê-los (ESC4) |
search | Objetos que correspondem a filtros de propriedade (search -t user hasspn enabled), com datas, idades (90d) e curingas |
path | Caminhos mais curtos até um alvo ou até o Tier Zero, a partir de tudo que é owned, ou através de etapas --via; impressos como cadeias de saltos, um grafo de terminal, ou SVG/PNG para relatórios |
hunt | Verificações em todo o domínio por severidade: DCSync, controle do Tier Zero, AD CS (ESC*), Kerberoasting, sessões privilegiadas, leitores de LAPS/gMSA, senhas em atributos ou ainda no padrão (computadores pré-Windows 2000, contas não utilizadas, contas de administrador com uma gêmea padrão), primitivas de takeover (Shadow Credentials, RBCD), controle de GPO, relay NTLM, relações de confiança, possíveis honeytokens...; hunt --owned limita-as ao que seus objetos owned podem fazer |
cypher, query | Cypher bruto, e uma biblioteca de consultas salvas: incluídas, seus próprios arquivos .cyp (~/.bhshell/queries/ ou qualquer pasta definida com config query_dirs) e aquelas salvas no servidor |
owned, hvt | Marcar ou desmarcar objetos owned e Tier Zero, por nome ou a partir de um arquivo de nomes |
domains, trusts | Contagens por domínio, e o mapa de relações de confiança com o status de filtragem de SID |
Para adicionar sua própria consulta, salve-a como um arquivo .cyp em ~/.bhshell/queries/ e execute-a pelo nome:
$ cat ~/.bhshell/queries/stale-admins.cyp
// description: Enabled adminCount users who have not logged on for a year
MATCH (u:User) WHERE u.admincount = true AND u.enabled = true
AND u.lastlogontimestamp < (datetime().epochseconds - 31536000) RETURN u
[bh: shell] > query run stale-admins -o stale-admins.csv
Consulte a biblioteca de consultas para o formato e para manter consultas em outras pastas (um repositório de equipe, uma pasta por engajamento).
A maioria dos comandos aceita --json e -o FILE (JSON ou CSV), e os que listam objetos também aceitam
--names-only ou -o FILE.txt para uma lista simples de nomes a serem passados a outras ferramentas. O login funciona com uma senha (mais MFA) ou
com um token de API; os segredos são solicitados ou lidos do ambiente, nunca passados como argumentos.
O guia de uso completo (cada comando, flag de visualização, filtro de busca, opção de caminho, verificação de hunt e
configuração) está em docs/USAGE.md.
Dentro do shell, execute help ou help <command>.
Relatos de bugs e pull requests são bem-vindos em github.com/kr0no/bloodhound-shell/issues.
git clone https://github.com/kr0no/bloodhound-shell.git
cd bloodhound-shell
python3 -m venv .venv && . .venv/bin/activate
pip install -e '.[dev]'
pre-commit install
python -m pytest
Sem um servidor, o pytest executa apenas os testes offline. Os restantes são executados contra uma instância do BloodHound CE
carregada com os dados de exemplo:
export BHSHELL_TEST_URL=http://127.0.0.1:8080 BH_USER=admin BH_PASSWORD='...'
python -m pytest -m live
Eles apenas leem do servidor e nunca tocam em ~/.bhshell.
Distribuído sob a Licença MIT. Consulte LICENSE para obter detalhes.
BloodHound é uma marca registrada da SpecterOps. bhshell é um projeto independente e não é afiliado nem endossado pela SpecterOps.
Descubra as ferramentas mais usadas pela nossa comunidade.
Sem dados de popularidade ainda.