A quick and simple RESTful API to BIND, written in Python/Tornado. Provides the ability to add/remove entries with an existing BIND DNS architecture.
Based on the work of https://github.com/ajclark/bind-restapi Rewritten with Python and Tornado. To daemonize, daemon.py is used: http://www.jejik.com/articles/2007/02/a_simple_unix_linux_daemon_in_python
Customize defines inside /etc/bind-restapi.conf:
port = 9999
sig_key = '{"Sprint":"jfsdi489JInj39vJIOjf93==", "other":"jfi843jIb39dfjopqD93kC=="}'
address = '0.0.0.0'
nameserver = '192.168.1.2, 192.168.1.3'
ttl = 86400
secret = '123456'
nsupdate_command = 'nsupdate'
Start daemon:
$ python bind-restapi.py start
$ curl -X POST -H 'Content-Type: application/json' -H 'X-Api-Key: secret' -d '{ "hostname": "host.example.com", "view": "none", "method": "a", "ip": "1.1.1.10", "ttl": 86400}' http://localhost:9999/dns
$ curl -X POST -H 'Content-Type: application/json' -H 'X-Api-Key: secret' -d '{ "hostname": "host.example.com", "view": "none", "method": "ptr", "ip": "1.1.1.10", "ttl": 86400}' http://localhost:9999/dns
$ curl -X POST -H 'Content-Type: application/json' -H 'X-Api-Key: secret' -d '{ "hostname": "host.example.com", "view": "none", "method": "cname", "cname": "www.example.com", "ttl": 86400}' http://localhost:9999/dns
$ curl -X DELETE -H 'Content-Type: application/json' -H 'X-Api-Key: secret' -d '{ "hostname": "host.example.com", "view": "none"}' http://localhost:9999/dns
The API supports POST and DELETE methods to add and remove entries, respectively. On a successful POST/DELETE a 200 is returned.
The API can reside on a local or remote DNS server.
The API supports A, PTR, CNAME method in POST.
On a DELETE request, the API removes both the forward zone and reverse in-addr.arpa zone entry as a connivence
The TTL, portand other DNS params are hard-coded inside of dns.rb
TTL can be overriden from the request with {"ttl": "$TTL"}
The API is protected by way of an API-Key using a custom X-Api-Key
HTTP header. The API should also be served over a secure connection.