A quick and simple RESTful API to BIND, written in Ruby / Sinatra. Provides the ability to add/remove entries with an existing BIND DNS architecture.
I wrote this as a solution to enable our internal Cloud to add/remove machines to DNS by integrating with the DNS architecture that we have today.
# download bind tar ball
$ run install.sh
$ run start.sh
$ curl -X POST -H 'Content-Type: application/json' -H 'X-Api-Key: secret' -d '{ "hostname": "host12.apple.com", "ip": "1.1.1.12" }' http://localhost:4567/dns
$ curl -X DELETE -H 'Content-Type: application/json' -H 'X-Api-Key: secret' -d '{ "hostname": "host12.apple.com", "ip": "1.1.1.12" }' http://localhost:4567/dns
The API supports POST and DELETE methods to add and remove entries, respectively. On a successful POST a 201 is returned. On a successful DELETE a 200 is returned. Duplicate records are never created.
The API can reside on a local or remote DNS server.
On a POST request, the API adds both the forward zone and reverse in-addr.arpa zone entry as a convenience.
On a DELETE request, the API removes both the forward zone and reverse in-addr.arpa zone entry as a connivence.
The TTL and other DNS params are hard-coded inside of dns.rb
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.
Example named configuration files are included to help get started with integrating dns.rb with BIND.