Buscador de subdominios de Censys

Nota importante: A finales de 2024, Censys ya no proporciona acceso API a cuentas gratuitas.

Esta es una herramienta para enumerar subdominios utilizando los registros de transparencia de certificados almacenados en Censys Search. Debería devolver cualquier subdominio al que se le haya emitido un certificado SSL por parte de una CA pública.

Véalo en acción:

$ python censys-subdomain-finder.py github.com

[*] Searching Censys for subdomains of github.com
[*] Found 42 unique subdomains of github.com in ~1.7 seconds

  - hq.github.com
  - talks.github.com
  - cla.github.com
  - github.com
  - cloud.github.com
  - enterprise.github.com
  - help.github.com
  - collector-cdn.github.com
  - central.github.com
  - smtp.github.com
  - cas.octodemo.github.com
  - schrauger.github.com
  - jobs.github.com
  - classroom.github.com
  - dodgeball.github.com
  - visualstudio.github.com
  - branch.github.com
  - www.github.com
  - edu.github.com
  - education.github.com
  - import.github.com
  - styleguide.github.com
  - community.github.com
  - server.github.com
  - mac-installer.github.com
  - registry.github.com
  - f.cloud.github.com
  - offer.github.com
  - helpnext.github.com
  - foo.github.com
  - porter.github.com
  - id.github.com
  - atom-installer.github.com
  - review-lab.github.com
  - vpn-ca.iad.github.com
  - maintainers.github.com
  - raw.github.com
  - status.github.com
  - camo.github.com
  - support.enterprise.github.com
  - stg.github.com
  - rs.github.com

Configuración

1. Regístrese (gratis) en https://search.censys.io/register

2. Vaya a https://search.censys.io/account y configure dos variables de entorno con su ID de API y secreto de API:

   export CENSYS_API_ID=...
   export CENSYS_API_SECRET=...
   

   Alternativamente, puede usar un archivo .env para almacenar estos valores para persistencia entre usos:

   cp .env.template .env
   

   Luego edite el archivo .env y establezca los valores para CENSYS_API_ID y CENSYS_API_SECRET.

3. Clone el repositorio:

   git clone https://github.com/christophetd/censys-subdomain-finder.git
   

4. Instale las dependencias en un virtualenv:

   cd censys-subdomain-finder
   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   

Uso

Ejemplo de uso:

python censys-subdomain-finder.py example.com

Genere la lista de subdominios en un archivo de texto:

python censys-subdomain-finder.py example.com -o subdomains.txt

usage: censys-subdomain-finder.py [-h] [-o OUTPUT_FILE]
                                  [--censys-api-id CENSYS_API_ID]
                                  [--censys-api-secret CENSYS_API_SECRET]
                                  domain

positional arguments:
  domain                The domain to scan

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUT_FILE, --output OUTPUT_FILE
                        A file to output the list of subdomains to (default:
                        None)
  --censys-api-id CENSYS_API_ID
                        Censys API ID. Can also be defined using the
                        CENSYS_API_ID environment variable (default: None)
  --censys-api-secret CENSYS_API_SECRET
                        Censys API secret. Can also be defined using the
                        CENSYS_API_SECRET environment variable (default: None)

Compatibilidad

Debería funcionar en Python 3.7+.

Notas

La API de Censys tiene un límite de tasa de 120 consultas por ventana de 5 minutos. Cada invocación de esta herramienta realiza exactamente una llamada API a Censys.

No dude en abrir un issue o tuitear a @christophetd para sugerencias o comentarios.