Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jpenalbae/dns-axfr
Extends node.js dns module with axfr query type
https://github.com/jpenalbae/dns-axfr
Last synced: about 1 month ago
JSON representation
Extends node.js dns module with axfr query type
- Host: GitHub
- URL: https://github.com/jpenalbae/dns-axfr
- Owner: jpenalbae
- License: lgpl-3.0
- Created: 2015-02-07T05:59:32.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2021-02-16T17:01:34.000Z (almost 4 years ago)
- Last Synced: 2024-11-27T13:37:36.345Z (about 2 months ago)
- Language: JavaScript
- Size: 20.5 KB
- Stars: 6
- Watchers: 3
- Forks: 7
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dns-axfr
dns-axfr is a node.js module which extends dns core module to add support for AXFR type queries. It can be useful for pentesting tasks, automating recursive zone transfers, etc...
The following type of records are supported:
* A
* CNAME
* SOA
* MX
* NS
* TXT
* AAAA
* SPF
* SRV
## Usage
In otder to perform an AXFR query use `resolveAxfr()`
### resolveAxfr(server, zone, callback)
```javascript
var dns = require('dns-axfr');
var util = require('util');
dns.resolveAxfr('dns01.acme.com', 'acme.com', function(err, addr) {
if (err) {
console.error('Error ocurred: ' + addr + ' (' + err + ')');
return;
}
console.log(util.inspect(addr));
});
```
If you need to setup a timeout for the request use `resolveAxfrTimeout()` and set the desired timeout in milliseconds.
### resolveAxfrTimeout(timeout)
```javascript
var dns = require('dns-axfr');
var util = require('util');
dns.resolveAxfrTimeout(1000);
dns.resolveAxfr('dns01.acme.com', 'acme.com', function(err, addr) {
if (err) {
console.error('Error ocurred: ' + addr + ' (' + err + ')');
return;
}
console.log(util.inspect(addr));
});
```
As this module extends the core dns module, you can access the original module without "requiring" it again:
```javascript
var dns = require('dns-axfr');
var util = require('util');
/* Extended function */
dns.resolveAxfr('dns01.acme.com', 'acme.com', function(err, addr) {
if (err) throw err;
console.log(util.inspect(addr));
});
/* Original dns module function */
dns.resolve4('www.google.com', function (err, addresses) {
if (err) throw err;
console.log(util.inspect(addresses));
});
```
## Sample results
```javascript
{
questions: [
{
name: 'acme.es.',
type: 'AXFR'
}
],
answers: [
{
name: 'acme.es.',
type: 'SOA',
ttl: 21600,
dns: 'ns1.acme.es.',
mail: 'root.ns1.acme.es.',
serial: 2015012401,
refresInterval: 14400,
retryInterval: 7200,
expireLimit: 2592000,
minTTL: 28800
},
{
name: 'acme.es.',
type: 'A',
ttl: 21600,
a: '127.0.2.22'
},
{
name: 'acme.es.',
type: 'NS',
ttl: 21600,
ns: 'ns1.acme.es.'
},
{
name: 'acme.es.',
type: 'NS',
ttl: 21600,
ns: 'ns2.acme.es.'
},
{
name: 'subdomain.acme.es.',
type: 'NS',
ttl: 21600,
ns: 'ns1.acme.es.'
},
{
name: 'subdomain.acme.es.',
type: 'NS',
ttl: 21600,
ns: 'ns2.acme.es.'
},
{
name: 'ns1.acme.es.',
type: 'A',
ttl: 21600,
a: '127.0.2.69'
},
{
name: 'ns2.acme.es.',
type: 'A',
ttl: 21600,
a: '127.0.2.70'
},
{
name: 'test.acme.es.',
type: 'CNAME',
ttl: 21600,
cname: 'www.acme.com.'
},
{
name: 'www.acme.es.',
type: 'A',
ttl: 21600,
a: '127.0.2.22'
}
]
}
```