dnsx est un kit d'outils DNS rapide et polyvalent permettant d'exécuter plusieurs requêtes DNS de votre choix avec une liste de résolveurs fournis par l'utilisateur.
<h1 align="center">
<img src="https://assets.kitploit.com/production/public/readmes/3923/abdf7c5ef50e7d740b96aad5a151b9ac75700de029a681a6b3dc6b51efe45b7d.png" alt="dnsx" width="200px">
<br>
</h1>
<h4 align="center">Une boîte à outils DNS rapide et polyvalente conçue pour exécuter des requêtes DNS</h4>
<p align="center">
<a href="https://goreportcard.com/report/github.com/projectdiscovery/dnsx"><img src="https://goreportcard.com/badge/github.com/projectdiscovery/dnsx"></a>
<a href="https://github.com/projectdiscovery/dnsx/issues"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat"></a>
<a href="https://github.com/projectdiscovery/dnsx/releases"><img src="https://img.shields.io/github/release/projectdiscovery/dnsx"></a>
<a href="https://twitter.com/pdiscoveryio"><img src="https://img.shields.io/twitter/follow/pdiscoveryio.svg?logo=twitter"></a>
<a href="https://discord.gg/projectdiscovery"><img src="https://img.shields.io/discord/695645237418131507.svg?logo=discord"></a>
</p>
<p align="center">
<a href="#features">Fonctionnalités</a> •
<a href="#installation-instructions">Installation</a> •
<a href="#usage">Utilisation</a> •
<a href="#running-dnsx">Exécuter `dnsx`</a> •
<a href="#wildcard-filtering">Wildcard</a> •
<a href="#-notes">Notes</a> •
<a href="https://discord.gg/projectdiscovery">Rejoindre Discord</a>
</p>
---
`dnsx` est une boîte à outils DNS rapide et polyvalente conçue pour exécuter diverses sondes via la bibliothèque [retryabledns](https://github.com/projectdiscovery/retryabledns). Elle prend en charge plusieurs requêtes DNS, les résolveurs fournis par l'utilisateur, le filtrage des wildcards DNS à la manière de [shuffledns](https://github.com/projectdiscovery/shuffledns), etc.
# Fonctionnalités
<h1 align="left">
<img src="https://assets.kitploit.com/production/public/readmes/3923/e0be49be16e94055f8ca00845ffa701135d23cba6aca284260e6208fa8c20026.png" alt="dnsx" width="700px"></a>
<br>
</h1>
- Utilitaire simple et pratique pour interroger les enregistrements DNS.
- Prise en charge des requêtes **A, AAAA, CNAME, PTR, NS, MX, TXT, SRV, SOA**
- Prise en charge de la **résolution** / du **brute-force** DNS
- Prise en charge de la saisie de **résolveurs** personnalisés
- Prise en charge de plusieurs formats de résolveurs **(TCP/UDP/DOH/DOT)**
- Prise en charge de **stdin** et **stdout**
- Prise en charge de la gestion automatique des **wildcards**
# Instructions d'installation
`dnsx` nécessite **go1.26.10** pour s'installer correctement. Exécutez la commande suivante pour installer la dernière version :
```sh
go install -v github.com/projectdiscovery/dnsx/cmd/dnsx@latest
```
# Utilisation
```sh
dnsx -h
```
Cela affichera l'aide de l'outil. Voici tous les commutateurs qu'il prend en charge.
```console
INPUT:
-l, -list string list of sub(domains)/hosts to resolve (file or stdin)
-d, -domain string list of domain to bruteforce (file or comma separated or stdin)
-w, -wordlist string list of words to bruteforce (file or comma separated or stdin)
QUERY:
-a query A record (default)
-aaaa query AAAA record
-cname query CNAME record
-ns query NS record
-txt query TXT record
-srv query SRV record
-ptr query PTR record
-mx query MX record
-soa query SOA record
-any query ANY record
-axfr query AXFR
-caa query CAA record
-recon query all the dns records (a,aaaa,cname,ns,txt,srv,ptr,mx,soa,axfr,caa)
-e, -exclude-type value dns query type to exclude (a,aaaa,cname,ns,txt,srv,ptr,mx,soa,axfr,caa) (default none)
FILTER:
-re, -resp display dns response
-ro, -resp-only display dns response only
-rc, -rcode string filter result by dns status code (eg. -rcode noerror,servfail,refused)
PROBE:
-cdn display cdn name
-asn display host asn information
RATE-LIMIT:
-t, -threads int number of concurrent threads to use (default 100)
-rl, -rate-limit int number of dns request/second to make (disabled as default) (default -1)
UPDATE:
-up, -update update dnsx to latest version
-duc, -disable-update-check disable automatic dnsx update check
OUTPUT:
-o, -output string file to write output
-j, -json write output in JSONL(ines) format
-omit-raw, -or omit raw dns response from jsonl output
-ot, -output-template string custom output template (e.g. -ot '{{host}} {{a}}')
DEBUG:
-hc, -health-check run diagnostic check up
-silent display only results in the output
-v, -verbose display verbose output
-raw, -debug display raw dns response
-stats display stats of the running scan
-version display version of dnsx
-nc, -no-color disable color in output
OPTIMIZATION:
-retry int number of dns attempts to make (must be at least 1) (default 2)
-hf, -hostsfile use system host file
-trace perform dns tracing
-trace-max-recursion int Max recursion for dns trace (default 32767)
-resume resume existing scan
-stream stream mode (wordlist, wildcard, stats and stop/resume will be disabled)
-timeout value maximum time to wait for a DNS query to complete (default 3s)
CONFIGURATIONS:
-auth configure projectdiscovery cloud (pdcp) api key (default true)
-r, -resolver string list of resolvers to use (file or comma separated)
-wt, -wildcard-threshold int wildcard filter threshold (default 5)
-aw, -auto-wildcard automatically detect wildcard domains for filtering
-wd, -wildcard-domain string domain name for manual wildcard filtering (mutually exclusive with -auto-wildcard; other flags will be ignored - json output recommended)
```
## Exécution de dnsx
### Résolution DNS
Filtrer les noms d'hôtes actifs à partir de la liste des sous-domaines passifs, obtenus depuis diverses sources :
```console
subfinder -silent -d hackerone.com | dnsx -silent
a.ns.hackerone.com
www.hackerone.com
api.hackerone.com
docs.hackerone.com
mta-sts.managed.hackerone.com
mta-sts.hackerone.com
resources.hackerone.com
b.ns.hackerone.com
mta-sts.forwarding.hackerone.com
events.hackerone.com
support.hackerone.com
```
Affiche les enregistrements **A** pour la liste de sous-domaines donnée :
```console
subfinder -silent -d hackerone.com | dnsx -silent -a -resp
www.hackerone.com [104.16.100.52]
www.hackerone.com [104.16.99.52]
hackerone.com [104.16.99.52]
hackerone.com [104.16.100.52]
api.hackerone.com [104.16.99.52]
api.hackerone.com [104.16.100.52]
mta-sts.forwarding.hackerone.com [185.199.108.153]
mta-sts.forwarding.hackerone.com [185.199.109.153]
mta-sts.forwarding.hackerone.com [185.199.110.153]
mta-sts.forwarding.hackerone.com [185.199.111.153]
a.ns.hackerone.com [162.159.0.31]
resources.hackerone.com [52.60.160.16]
resources.hackerone.com [3.98.63.202]
resources.hackerone.com [52.60.165.183]
resources.hackerone.com [read.uberflip.com]
mta-sts.hackerone.com [185.199.110.153]
mta-sts.hackerone.com [185.199.111.153]
mta-sts.hackerone.com [185.199.109.153]
mta-sts.hackerone.com [185.199.108.153]
gslink.hackerone.com [13.35.210.17]
gslink.hackerone.com [13.35.210.38]
gslink.hackerone.com [13.35.210.83]
gslink.hackerone.com [13.35.210.19]
b.ns.hackerone.com [162.159.1.31]
docs.hackerone.com [185.199.109.153]
docs.hackerone.com [185.199.110.153]
docs.hackerone.com [185.199.111.153]
docs.hackerone.com [185.199.108.153]
support.hackerone.com [104.16.51.111]
support.hackerone.com [104.16.53.111]
mta-sts.managed.hackerone.com [185.199.108.153]
mta-sts.managed.hackerone.com [185.199.109.153]
mta-sts.managed.hackerone.com [185.199.110.153]
mta-sts.managed.hackerone.com [185.199.111.153]
```
Extrayez les enregistrements **A** pour la liste de sous-domaines donnée :
```console
subfinder -silent -d hackerone.com | dnsx -silent -a -resp-only
104.16.99.52
104.16.100.52
162.159.1.31
104.16.99.52
104.16.100.52
185.199.110.153
185.199.111.153
185.199.108.153
185.199.109.153
104.16.99.52
104.16.100.52
104.16.51.111
104.16.53.111
185.199.108.153
185.199.111.153
185.199.110.153
185.199.111.153
```
Extrayez les enregistrements **CNAME** pour la liste de sous-domaines donnée :
```console
subfinder -silent -d hackerone.com | dnsx -silent -cname -resp
support.hackerone.com [hackerone.zendesk.com]
resources.hackerone.com [read.uberflip.com]
mta-sts.hackerone.com [hacker0x01.github.io]
mta-sts.forwarding.hackerone.com [hacker0x01.github.io]
events.hackerone.com [whitelabel.bigmarker.com]
```
Extraire les enregistrements **ASN** pour la liste de sous-domaines donnée :
```console
subfinder -silent -d hackerone.com | dnsx -silent -asn
b.ns.hackerone.com [AS13335, CLOUDFLARENET, US]
a.ns.hackerone.com [AS13335, CLOUDFLARENET, US]
hackerone.com [AS13335, CLOUDFLARENET, US]
www.hackerone.com [AS13335, CLOUDFLARENET, US]
api.hackerone.com [AS13335, CLOUDFLARENET, US]
support.hackerone.com [AS13335, CLOUDFLARENET, US]
```
Sonder à l'aide du [code de statut DNS](https://github.com/projectdiscovery/dnsx/wiki/RCODE-ID-VALUE-Mapping) sur la liste donnée de (sous-)domaines :
```console
subfinder -silent -d hackerone.com | dnsx -silent -rcode noerror,servfail,refused
ns.hackerone.com [NOERROR]
a.ns.hackerone.com [NOERROR]
b.ns.hackerone.com [NOERROR]
support.hackerone.com [NOERROR]
resources.hackerone.com [NOERROR]
mta-sts.hackerone.com [NOERROR]
www.hackerone.com [NOERROR]
mta-sts.forwarding.hackerone.com [NOERROR]
docs.hackerone.com [NOERROR]
```
Extraire les sous-domaines d'une plage réseau donnée à l'aide d'une requête `PTR` :
```console
echo 173.0.84.0/24 | dnsx -silent -resp-only -ptr
cors.api.paypal.com
trinityadminauth.paypal.com
cld-edge-origin-api.paypal.com
appmanagement.paypal.com
svcs.paypal.com
trinitypie-serv.paypal.com
ppn.paypal.com
pointofsale-new.paypal.com
pointofsale.paypal.com
slc-a-origin-pointofsale.paypal.com
fpdbs.paypal.com
```
Extraire les sous-domaines de l'ASN donné à l'aide de la requête `PTR` :
```console
echo AS17012 | dnsx -silent -resp-only -ptr
apiagw-a.paypal.com
notify.paypal.com
adnormserv-slc-a.paypal.com
a.sandbox.paypal.com
apps2.paypal-labs.com
pilot-payflowpro.paypal.com
www.paypallabs.com
paypal-portal.com
micropayments.paypal-labs.com
minicart.paypal-labs.com
```
### Format de sortie personnalisé
L'option `-output-template` (`-ot`) vous permet de personnaliser le format de sortie à l'aide d'un modèle, au lieu de la disposition entre crochets par défaut (par exemple `example.com [A] [104.20.23.154]`). Vous spécifiez le modèle directement sur la ligne de commande pour contrôler la manière dont les données résolues sont présentées.
Les variables de modèle correspondent aux mêmes noms de champs utilisés dans la sortie JSONL (`-json`), de sorte que n'importe lequel des éléments suivants peut être référencé sous la forme `{{field}}` :
`host`, `a`, `aaaa`, `cname`, `ns`, `txt`, `mx`, `srv`, `ptr`, `soa`, `caa`, `ttl`, `resolver`, `status_code`, `cdn-name`, `cdn-type`, `asn`, `query-time`. Un alias pratique `{{ip}}` contient les enregistrements combinés `A` et `AAAA`.
Les enregistrements comportant plusieurs valeurs (par exemple plusieurs enregistrements `A`) sont joints par des virgules au sein d'un même champ.
```console
echo example.com | dnsx -silent -a -ot '{{host}} {{a}}'
example.com 104.20.23.154,172.66.147.243
```
```console
echo example.com | dnsx -silent -a -ot '{{ip}} - {{host}}'
104.20.23.154,172.66.147.243 - example.com
```
> [!NOTE]
> Si un champ spécifié n'existe pas ou ne contient pas de valeur, il est simplement omis de la sortie. `-output-template` ne peut pas être combiné avec `-json` ou `-raw`.
---------
### Force brute DNS
Réalisez une force brute de sous-domaines pour un domaine donné ou une liste de domaines à l'aide des options `d` et `w` :
```console
dnsx -silent -d facebook.com -w dns_worldlist.txt
blog.facebook.com
booking.facebook.com
api.facebook.com
analytics.facebook.com
beta.facebook.com
apollo.facebook.com
ads.facebook.com
box.facebook.com
alpha.facebook.com
apps.facebook.com
connect.facebook.com
c.facebook.com
careers.facebook.com
code.facebook.com
```
Bruteforce ciblé de sous-domaines à l'aide d'une entrée à mot-clé unique ou multiple, les flags `d` ou `w` prenant en charge des entrées sous forme de fichier ou de mots-clés séparés par des virgules :
```console
dnsx -silent -d domains.txt -w jira,grafana,jenkins
grafana.1688.com
grafana.8x8.vc
grafana.airmap.com
grafana.aerius.nl
jenkins.1688.com
jenkins.airbnb.app
jenkins.airmap.com
jenkins.ahn.nl
jenkins.achmea.nl
jira.amocrm.com
jira.amexgbt.com
jira.amitree.com
jira.arrival.com
jira.atlassian.net
jira.atlassian.com
```
Les valeurs sont acceptées depuis **stdin** pour tous les types d'entrée (`-list`, `-domain`, `-wordlist`). L'option `-list` est définie par défaut sur `stdin`, mais la même chose peut être obtenue pour les autres types d'entrée en ajoutant un `-` (tiret) comme paramètre :
```console
cat domains.txt | dnsx -silent -w jira,grafana,jenkins -d -
grafana.1688.com
grafana.8x8.vc
grafana.airmap.com
grafana.aerius.nl
jenkins.1688.com
jenkins.airbnb.app
jenkins.airmap.com
jenkins.ahn.nl
jenkins.achmea.nl
jira.amocrm.com
jira.amexgbt.com
jira.amitree.com
jira.arrival.com
jira.atlassian.net
jira.atlassian.com
```
#### Force brute DNS avec une wordlist basée sur des placeholders
```bash
$ cat tld.txt
com
by
de
be
al
bi
cg
dj
bs
```
```console
dnsx -d google.FUZZ -w tld.txt -resp
_ __ __
__| | _ __ ___ \ \/ /
/ _' || '_ \ / __| \ /
| (_| || | | |\__ \ / \
\__,_||_| |_||___//_/\_\ v1.1.2
projectdiscovery.io
google.de [142.250.194.99]
google.com [142.250.76.206]
google.be [172.217.27.163]
google.bs [142.251.42.35]
google.bi [216.58.196.67]
google.al [216.58.196.68]
google.by [142.250.195.4]
google.cg [142.250.183.131]
google.dj [142.250.192.3]
```
### Filtrage des wildcards
Une fonctionnalité spéciale de `dnsx` est sa capacité à gérer les **wildcards DNS à plusieurs niveaux**, et à le faire avec un nombre très réduit de requêtes DNS. Parfois, tous les sous-domaines se résolvent, ce qui génère beaucoup de déchets dans la sortie. La façon dont `dnsx` gère cela est de suivre le nombre de sous-domaines pointant vers une IP et, si le nombre de sous-domaines dépasse un certain seuil, il vérifie les wildcards à tous les niveaux des hôtes pour cette IP de manière itérative.
```console
dnsx -l subdomain_list.txt -wd airbnb.com -o output.txt
```
Pour détecter et filtrer automatiquement les DNS wildcard sur plusieurs domaines en une seule exécution tout en préservant le mode de sortie sélectionné :
```console
dnsx -l subdomain_list.txt -auto-wildcard -o output.txt
```
`-auto-wildcard` et `-wd` / `-wildcard-domain` sont mutuellement exclusifs. Utilisez `-wd` lorsque vous souhaitez le flux de filtrage wildcard manuel existant sur un seul domaine ; utilisez `-auto-wildcard` lorsque vous souhaitez que dnsx détecte automatiquement les racines wildcard sur une entrée multi-domaines.
---
### Dnsx en tant que bibliothèque
Il est possible d'utiliser la bibliothèque directement dans vos programmes golang. Les extraits de code suivants sont un exemple d'utilisation dans des programmes golang. Veuillez vous référer à [ici](https://pkg.go.dev/github.com/projectdiscovery/[email protected]/libs/dnsx) pour la configuration détaillée du package et son utilisation.
```go
package main
import (
"fmt"
"github.com/projectdiscovery/dnsx/libs/dnsx"
)
func main() {
// Create DNS Resolver with default options
dnsClient, err := dnsx.New(dnsx.DefaultOptions)
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
// DNS A question and returns corresponding IPs
result, err := dnsClient.Lookup("hackerone.com")
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
for idx, msg := range result {
fmt.Printf("%d: %s\n", idx+1, msg)
}
// Query
rawResp, err := dnsClient.QueryOne("hackerone.com")
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
fmt.Printf("rawResp: %v\n", rawResp)
jsonStr, err := rawResp.JSON()
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
fmt.Println(jsonStr)
return
}
```
# 📋 Notes
- Par défaut, `dnsx` vérifie l'enregistrement **A**.
- Par défaut, `dnsx` utilise les [résolveurs](https://github.com/projectdiscovery/dnsx/blob/43af78839e237ea8cbafe571df1ab0d6cbe7f445/libs/dnsx/dnsx.go#L31) Google, Cloudflare, Quad9.
- Une liste de résolveurs personnalisés peut être chargée à l'aide du flag `r`.
- `-auto-wildcard` détecte automatiquement les domaines wildcard sur plusieurs racines enregistrables en une seule exécution.
- Le nom de domaine (`-wd`) est requis uniquement pour le filtrage manuel des wildcards et ne peut pas être utilisé conjointement avec `-auto-wildcard`.
- Lors de l'utilisation du filtrage manuel des wildcards avec `-wd`, les autres flags d'enregistrement DNS sont ignorés et la sortie JSON est recommandée.
- La résolution DNS (`l`) et le brute-forcing DNS (`w`) ne peuvent pas être utilisés ensemble.
- Les opérateurs VPN ont tendance à filtrer le trafic DNS/UDP élevé, l'outil peut donc subir des pertes de paquets (par ex. [Mullvad VPN](https://github.com/projectdiscovery/dnsx/issues/221)). Consultez [cette solution potentielle](https://github.com/projectdiscovery/dnsx/blob/dev/MULLVAD.md).
`dnsx` est fait avec 🖤 par l'équipe [projectdiscovery](https://projectdiscovery.io).