subdns-recon
Enumeração passiva de subdomínios (DNS) de seu próprio domínio.
3 testes · 3 passou · 0 falhou · 0 skip
- test_resolve_valid0.00s
- test_resolve_invalid0.01s
- test_check_returns_list0.01s
Entrypoints (CLI)
subdomain-mapper
Módulos e funções principais
src/subdns_recon/__init__.py
- —
src/subdns_recon/cli.py
main()
src/subdns_recon/core.py
resolve()check()main()
Estrutura de arquivos
- LICENSE
- README.md
- pyproject.toml
- src/subdns_recon/__init__.py
- src/subdns_recon/cli.py
- src/subdns_recon/core.py
- tests/test_core.py
README
# subdns-recon
Enumeração passiva de subdomínios (DNS) de seu próprio domínio.
## O que faz
Esta ferramenta de **defensiva** contra alvos que voce possui ou tem autorizacao. Enumeração passiva de subdomínios (DNS) de seu próprio domínio. O codigo e
testavel localmente (sem dependencias de rede para os testes unitarios).
> **Aviso etico:** uso exclusivo para fins educacionais e testes em ambientes
> que voce **possui** ou tem **autorizacao expressa** para auditar. Nunca a
> utilize contra sistemas de terceiros. O autor nao se responsabiliza por uso
> indevido.
## Instalacao
```bash
git clone https://github.com/Diogo-Damasceno/subdns-recon.git
cd subdns-recon
python3 -m venv .venv && . .venv/bin/activate
pip install -e .
```
## Uso
Conheça sua superfície de ataque antes de um pentest autorizado.
## Exemplos reais
```bash
$ subdomain-mapper exemplo.com www,api,dev
# www.exemplo.com -> 1.2.3.4
```
## Como funciona (resumo)
O modulo principal implementa a logica em funcoes puras e testaveis; a CLI e
apenas a casca de argumentos. Os testes em `tests/` (Python) ou `CoreTest.java`
(Java) cobrem os casos principais e rodam offline.
## O que NAO faz
- Nao executa ataques contra terceiros.
- Nao exfiltra dados.
- Nao substitui uma solucao comercial de seguranca.
## Licenca
MIT — ver `LICENSE`.
Como rodar na prática (entrada → saída):
$ subdns-recon exemplo.com wordlist.txt
api.exemplo.com -> 192.0.2.40\nblog.exemplo.com -> 198.51.100.9\n6 subdominios descobertos