1 autodns 0.0.8 - A program to aid auto addition of secondary DNS.
2 Copyright 1999-2005 Jonathan McDowell for Project Purple.
3 http://www.earth.li/projectpurple/progs/autodns.html
8 AutoDNS is a simple Perl script designed to allow the easy addition of
9 secondary DNS zones controlled via email.
11 The principle is simple. AutoDNS accepts a GPG clear signed email on
12 stdin, so can simply be added to a .forward file or whatever. You
13 configure it to know about the key IDs of all the people you wish to be
14 able to setup secondaries on your server and add their keys to the GPG
15 keyring for the user it runs under.
17 The config file is autodns.conf; its location is controlled near the top
18 of autodns.pl - it defaults to /etc/bind/autodns.conf. The other bit of
19 config that's needed is a users file.
21 You'll also need a way for the script to be able to do a "ndc reconfig"
22 to load the info about the new secondary domains - I do this using sudo.
24 The format of commands to AutoDNS is very simple. It current accepts 5
28 Indicate the beginning of a block of commands.
30 Indicate the end of a block of commands.
32 Add <domain> to the list of secondaried domains.
34 Delete <domain> from the list of secondaried domains, assuming
35 it's owned by the current user and is being secondaried
38 List secondaried domains.
42 So a typical email would contain:
48 as the body, which would then be signed with gpg --clearsign and sent.
49 AutoDNS will reply with the results of the commands sent to it.
54 The users file is of a very simple format. It contains one user per
57 <userid>:<gpgkeyid>:<priv>:<master server>
59 So an example would be:
61 noodles:5B430367:0:212.135.138.190
63 Lines beginning with a '#' are treated as comments. See autodns.users in
64 the tarball for an example.
67 Contacting the author:
69 I can be reached as noodles@earth.li.
71 All constructive criticism about autodns is welcome.
76 autodns is distributed under the GNU Public License, a copy of which
77 should have been provided with this archive as LICENSE.