DNSStager is an open-source project based on Python used to hide and transfer your payload using DNS.
DNSStager will create a malicious DNS server that handles DNS requests to your domain and return your payload as a response to specific record requests such as AAAA
or TXT
records after splitting it into chunks and encoding the payload using different algorithms.
DNSStager can generate a custom agent written in C
or GoLang
that will resolve a sequence of domains, retrieve the payload, decode it and finally inject it into the memory based on any technique you want.
You can edit the code of DNSStager agent as you wish, and build it using your own custom execution techniques.
The main goal of using DNSStager is to help red teamers/pentesters to deliver their payloads in stealthy channel using DNS.
How does it work?
Based on your DNS resolution option, DNSStager will split your payload into chunks and save each chunk of the payload as a response for a subdomain.
For example, if you choose IPV6
as your option to retrieve the payload, the DNS response will be something like:
cloud-srv-1.test.mydnsserver.live. 300 IN AAAA 5648:31d2:6548:8b52:6048:8b52:1848:8b52
Where 5648:31d2:6548:8b52:6048:8b52:1848:8b52
is a part of your payload.
So, the agent will resolve some domains to retrieve the payload and then decode it and finally inject it into memory.
Currently, DNSStager only supports two records, AAAA
and TXT
. You can encode your payload using XOR for the AAAA
record and by default it will be encoded as base64 if you choose TXT
record.
DNSStager key features:
DNSStager has some key features such as:
- Hide and Resolve your payload in
IPV6
records. - Hide and Resolve your payload in
TXT
records. - XOR encoder to encode your payload.
- Base64 encoder to encode your payload (only for TXT records).
- Pure agent written in
C
with the ability to customise it. - Pure agent written in
GoLang
with the ability to customise it. - The ability to use sleep between each DNS request.
- AND MUCH MORE TO COME!
Requirements
You can install DNSStager python requirements via:
pip3 install -r requirements.txt
You need to install GoLang
version 1.16.3
and to make sure to install the following GoLang
packages:
- golang.org/x/sys
- github.com/miekg/dns
Also, make sure to install ming-w64
via:
apt install mingw-w64
The script setup.sh
should do that for you, but double check the requirements before you use it!
Installation
To get the latest version of DNSStager, make sure to clone it from this repo using the following command:
git clone https://github.com/mhaskar/DNSStager
Then you need to install the requirements using the following command:
pip3 install -r requirements.txt
And make sure to install all the previously mentioned requirements too.
After doing all that, you are ready to execute DNSStager as root to get the following:
┌─[[email protected]]─[/opt/redteaming/DNSStager]
└──╼ $sudo ./dnsstager.py██████╗░███╗░░██╗░██████╗░██████╗████████╗░█████╗░░██████╗░███████╗██████╗░
██╔══██╗████╗░██║██╔════╝██╔════╝╚══██╔══╝██╔══██╗██╔════╝░██╔════╝██╔══██╗
██║░░██║██╔██╗██║╚█████╗░╚█████╗░░░░██║░░░███████║██║░░██╗░█████╗░░██████╔╝
██║░░██║██║╚████║░╚═══██╗░╚═══██╗░░░░█║░░░██╔══██║██║░░╚██╗██╔══╝░░██╔══██╗
██████╔╝██║░╚███║██████╔╝██████╔╝░░░██║░░░██║░░██║╚██████╔╝███████╗██║░░██║
╚═════╝░╚═╝░░╚══╝╚═════╝░╚═════╝░░░░╚═╝░░░╚═╝░░╚═╝░╚═════╝░╚══════╝╚═╝░░╚═╝
Beta Version Hide your payload in DNS
[-] Please specify a domain name using --domain
Usage
To start using DNSStager, make sure to setup your DNS settings first, you need to make your domain points to the DNSStager instance as NS record
in order to handle all the DNS requests to your domain.
You can read this full article about how to setup and use DNSStager.
And you can check the options using -h
switch like the following:
<div class="snippet-clipboard-content position-relative" data-snippet-clipboard-copy-content="┌─[askar@hackbook]─[/opt/redteaming/DNSStager] └──╼ $sudo ./dnsstager.py -h usage: dnsstager.py [-h] [–domain DOMAIN] [–payloads] [–prefix PREFIX] [–payload PAYLOAD] [–output OUTPUT] [–shellcode_path SHELLCODE_PATH] [–xorkey XORKEY] [–sleep SLEEP] DNSStager main parser optional arguments: -h, –help show this help message and exit –domain DOMAIN The domain you want to use as staging host –payloads show all payloads –prefix PREFIX Prefix to use as part of your subdomain schema –payload PAYLOAD Payload to use, see –payloads for more details –output OUTPUT Agent output path –shellcode_path SHELLCODE_PATH Shellcode file path –xorkey XORKEY XOR key to encode your payload with –sleep SLEEP sleep for N seconds between each DNS request “>
┌─[[email protected]]─[/opt/redteaming/DNSStager]
└──╼ $sudo ./dnsstager.py -h
usage: dnsstager.py [-h] [--domain DOMAIN] [--payloads] [--prefix PREFIX]
[--payload PAYLOAD] [--output OUTPUT]
[--shellcode_path SHELLCODE_PATH] [--xorkey XORKEY]
[--sleep SLEEP]DNSStager main parser
optional arguments:
-h, --help show this help message and exit
--domain DOMAIN The domain you want to use as staging host
--payloads show all payloads
--prefix PREFIX Prefix to use as part of your subdomain schema
--payload PAYLOAD Payload to use, see --payloads for more details
--output OUTPUT Agent output path
--shellcode_path SHELLCODE_PATH
Shellcode file path
--xorkey XORKEY XOR key to encode your payload with
--sleep SLEEP sleep for N seconds between each DNS request