Découvrez rapidement les hôtes exposés sur Internet en utilisant plusieurs moteurs de recherche.

Fonctionnalités • Installation • Utilisation • Configuration • Exécuter Uncover • Rejoindre Discord

---

uncover est un wrapper Go qui utilise les API de moteurs de recherche connus pour découvrir rapidement les hôtes exposés sur Internet. Il est conçu pour l'automatisation, vous pouvez donc l'interroger et utiliser les résultats avec vos outils de pipeline actuels.

Fonctionnalités

• Interroger plusieurs moteurs de recherche à la fois
• Moteurs de recherche disponibles
  • Shodan
  • Censys
  • FOFA
  • Hunter
  • Quake
  • ZoomEye
  • Netlas
  • CriminalIP
  • PublicWWW
  • HunterHow
  • Google
  • Onyphe
  • Driftnet
  • DayDayMap
  • NerdyData
• Prise en charge de saisie de plusieurs clés API
• Randomisation automatique des clés API
• Prise en charge de stdin / stdout pour l'entrée

Instructions d'installation

uncover nécessite go1.21 pour être installé correctement. Exécutez la commande suivante pour récupérer le dépôt -

go install -v github.com/projectdiscovery/uncover/cmd/uncover@latest

Utilisation

uncover -h

Ceci affichera l'aide de l'outil. Voici tous les indicateurs qu'il prend en charge :

Usage:
  ./uncover [flags]

Flags:
INPUT:
   -q, -query string[]   search query, supports: stdin,file,config input (example: -q 'example query', -q 'query.txt')
   -e, -engine string[]  search engine to query (shodan,shodan-idb,fofa,censys,quake,hunter,zoomeye,netlas,criminalip,publicwww,hunterhow,google,driftnet,daydaymap) (default shodan)
   -asq, -awesome-search-queries string[]  use awesome search queries to discover exposed assets on the internet (example: -asq 'jira')

SEARCH-ENGINE:
   -s, -shodan string[]       search query for shodan (example: -shodan 'query.txt')
   -sd, -shodan-idb string[]  search query for shodan-idb (example: -shodan-idb 'query.txt')
   -ff, -fofa string[]        search query for fofa (example: -fofa 'query.txt')
   -cs, -censys string[]      search query for censys (example: -censys 'query.txt')
   -qk, -quake string[]       search query for quake (example: -quake 'query.txt')
   -ht, -hunter string[]      search query for hunter (example: -hunter 'query.txt')
   -ze, -zoomeye string[]     search query for zoomeye (example: -zoomeye 'query.txt')
   -ne, -netlas string[]      search query for netlas (example: -netlas 'query.txt')
   -cl, -criminalip string[]  search query for criminalip (example: -criminalip 'query.txt')
   -pw, -publicwww string[]   search query for publicwww (example: -publicwww 'query.txt')
   -hh, -hunterhow string[]   search query for hunterhow (example: -hunterhow 'query.txt')
   -gg, -google string[]       search query for google (example: -google 'query.txt')
   -on, -onyphe string[]      search query for onyphe (example: -onyphe 'query.txt')
   -df, -driftnet string[]    search query for driftnet (example: -driftnet 'query.txt')
   -ddm, -daydaymap string[]  search query for daydaymap (example: -daydaymap 'query.txt')

CONFIG:
   -pc, -provider string         provider configuration file (default "$CONFIG/uncover/provider-config.yaml")
   -config string                flag configuration file (default "$CONFIG/uncover/config.yaml")
   -timeout int                  timeout in seconds (default 30)
   -rl, -rate-limit int          maximum number of http requests to send per second
   -rlm, -rate-limit-minute int  maximum number of requests to send per minute
   -retry int                    number of times to retry a failed request (default 2)
   -proxy string                 http proxy to use with uncover

OUTPUT:
   -o, -output string  output file to write found results
   -f, -field string   field to display in output (ip,port,host) (default "ip:port")
   -j, -json           write output in JSONL(ines) format
   -r, -raw            write raw output as received by the remote api
   -l, -limit int      limit the number of results to return (default 100)
   -nc, -no-color      disable colors in output

DEBUG:
   -silent   show only results in output
   -version  show version of the project
   -v        show verbose output

Utiliser uncover comme bibliothèque

Un exemple d'utilisation d'uncover comme bibliothèque est fourni dans le répertoire examples.

Configuration du fournisseur

Le fichier de configuration par défaut du fournisseur doit se trouver à l'emplacement $CONFIG/uncover/provider-config.yaml et contient le contenu suivant à titre d'exemple.

Remarque : Les clés API sont requises et doivent être configurées avant d'exécuter uncover.

shodan:
  - SHODAN_API_KEY_1
  - SHODAN_API_KEY_2
censys:
  - CENSYS_API_TOKEN_1:CENSYS_ORGANIZATION_ID_1
  - CENSYS_API_TOKEN_2:CENSYS_ORGANIZATION_ID_2
fofa:
  - FOFA_EMAIL_1:FOFA_KEY_1
  - FOFA_EMAIL_2:FOFA_KEY_2
quake:
  - QUAKE_TOKEN_1
  - QUAKE_TOKEN_2
hunter:
  - HUNTER_API_KEY_1
  - HUNTER_API_KEY_2
zoomeye:
  - ZOOMEYE_API_KEY_1
  - ZOOMEYE_API_KEY_2
netlas:
  - NETLAS_API_KEY_1
  - NETLAS_API_KEY_2
criminalip:
  - CRIMINALIP_API_KEY_1
  - CRIMINALIP_API_KEY_2
publicwww:
  - PUBLICWWW_API_KEY_1
  - PUBLICWWW_API_KEY_2
hunterhow:
  - HUNTERHOW_API_KEY_1 
  - HUNTERHOW_API_KEY_2
google:
  - GOOGLE_API_KEY_1:Google_API_CX_1
  - GOOGLE_API_KEY_2:Google_API_CX_2
onyphe:
  - ONYPHE_API_KEY_1 
  - ONYPHE_API_KEY_2
driftnet:
  - DRIFTNET_API_KEY_1
  - DRIFTNET_API_KEY_2
daydaymap:
  - DAYDAYMAP_API_KEY_1
  - DAYDAYMAP_API_KEY_2
nerdydata:
  - NERDYDATA_API_KEY_1
  - NERDYDATA_API_KEY_2

Lorsque plusieurs clés/identifiants sont spécifiés pour le même fournisseur dans le fichier de configuration, une clé aléatoire sera utilisée pour chaque exécution.

alternativement, vous pouvez également définir la clé API comme variable d'environnement dans votre profil bash.