# dns/trunk/DNSDB.pm # Abstraction functions for DNS administration ## # $Id: DNSDB.pm 316 2012-04-25 21:07:22Z kdeugau $ # Copyright 2008-2011 Kris Deugau # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see . ## package DNSDB; use strict; use warnings; use Exporter; use DBI; use Net::DNS; use Crypt::PasswdMD5; use Net::SMTP; use NetAddr::IP qw(:lower); use POSIX; use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS); $VERSION = 0.1; ##VERSION## @ISA = qw(Exporter); @EXPORT_OK = qw( &initGlobals &login &initActionLog &initPermissions &getPermissions &changePermissions &comparePermissions &changeGroup &loadConfig &connectDB &finish &addDomain &delZone &domainName &revName &domainID &revID &addRDNS &getZoneCount &getZoneList &addGroup &delGroup &getChildren &groupName &getGroupCount &getGroupList &addUser &updateUser &delUser &userFullName &userStatus &getUserData &getSOA &updateSOA &getRecLine &getDomRecs &getRecCount &addRec &updateRec &delRec &getTypelist &parentID &isParent &zoneStatus &importAXFR &export &mailNotify %typemap %reverse_typemap %config %permissions @permtypes $permlist ); @EXPORT = (); # Export nothing by default. %EXPORT_TAGS = ( ALL => [qw( &initGlobals &login &initActionLog &initPermissions &getPermissions &changePermissions &comparePermissions &changeGroup &loadConfig &connectDB &finish &addDomain &delZone &domainName &revName &domainID &revID &addRDNS &getZoneCount &getZoneList &addGroup &delGroup &getChildren &groupName &getGroupCount &getGroupList &addUser &updateUser &delUser &userFullName &userStatus &getUserData &getSOA &updateSOA &getRecLine &getDomRecs &getRecCount &addRec &updateRec &delRec &getTypelist &parentID &isParent &zoneStatus &importAXFR &export &mailNotify %typemap %reverse_typemap %config %permissions @permtypes $permlist )] ); our $group = 1; our $errstr = ''; our $resultstr = ''; # Halfway sane defaults for SOA, TTL, etc. # serial defaults to 0 for convenience. # value will be either YYYYMMDDNN for BIND/etc, or auto-internal for tinydns our %def = qw ( contact hostmaster.DOMAIN prins ns1.myserver.com serial 0 soattl 86400 refresh 10800 retry 3600 expire 604800 minttl 10800 ttl 10800 ); # Arguably defined wholly in the db, but little reason to change without supporting code changes our @permtypes = qw ( group_edit group_create group_delete user_edit user_create user_delete domain_edit domain_create domain_delete record_edit record_create record_delete self_edit admin ); our $permlist = join(',',@permtypes); # DNS record type map and reverse map. # loaded from the database, from http://www.iana.org/assignments/dns-parameters our %typemap; our %reverse_typemap; our %permissions; # Prepopulate a basic config. Note some of these *will* cause errors if left unset. # note: add appropriate stanzas in loadConfig to parse these our %config = ( # Database connection info dbname => 'dnsdb', dbuser => 'dnsdb', dbpass => 'secret', dbhost => '', # Email notice settings mailhost => 'smtp.example.com', mailnotify => 'dnsdb@example.com', # to mailsender => 'dnsdb@example.com', # from mailname => 'DNS Administration', orgname => 'Example Corp', domain => 'example.com', # Template directory templatedir => 'templates/', # fmeh. this is a real web path, not a logical internal one. hm.. # cssdir => 'templates/', sessiondir => 'session/', # Session params timeout => '3600', # 1 hour default # Other miscellanea log_failures => 1, # log all evarthing by default perpage => 15, ); ## (Semi)private variables # Hash of functions for validating record types. Filled in initGlobals() since # it relies on visibility flags from the rectypes table in the DB my %validators; # Username, full name, ID - mainly for logging my %userdata; # Entity-relationship reference hashes. my %par_tbl = ( group => 'groups', user => 'users', defrec => 'default_records', defrevrec => 'default_rev_records', domain => 'domains', revzone => 'revzones', record => 'records' ); my %id_col = ( group => 'group_id', user => 'user_id', defrec => 'record_id', defrevrec => 'record_id', domain => 'domain_id', revzone => 'rdns_id', record => 'record_id' ); my %par_col = ( group => 'parent_group_id', user => 'group_id', defrec => 'group_id', defrevrec => 'group_id', domain => 'group_id', revzone => 'group_id', record => 'domain_id' ); my %par_type = ( group => 'group', user => 'group', defrec => 'group', defrevrec => 'group', domain => 'group', revzone => 'group', record => 'domain' ); ## ## utility functions ## ## DNSDB::_rectable() # Takes default+rdns flags, returns appropriate table name sub _rectable { my $def = shift; my $rev = shift; return 'records' if $def ne 'y'; return 'default_records' if $rev ne 'y'; return 'default_rev_records'; } # end _rectable() ## DNSDB::_recparent() # Takes default+rdns flags, returns appropriate parent-id column name sub _recparent { my $def = shift; my $rev = shift; return 'group_id' if $def eq 'y'; return 'rdns_id' if $rev eq 'y'; return 'domain_id'; } # end _recparent() ## DNSDB::_ipparent() # Check an IP to be added in a reverse zone to see if it's really in the requested parent. # Takes a database handle, default and reverse flags, IP (fragment) to check, parent zone ID, # and a reference to a NetAddr::IP object (also used to pass back a fully-reconstructed IP for # database insertion) sub _ipparent { my $dbh = shift; my $defrec = shift; my $revrec = shift; my $val = shift; my $id = shift; my $addr = shift; return if $revrec ne 'y'; # this sub not useful in forward zones $$addr = NetAddr::IP->new($$val); #necessary? # subsub to split, reverse, and overlay an IP fragment on a netblock sub __rev_overlay { my $splitme = shift; # ':' or '.', m'lud? my $parnet = shift; my $val = shift; my $addr = shift; my $joinme = $splitme; $splitme = '\.' if $splitme eq '.'; my @working = reverse(split($splitme, $parnet->addr)); my @parts = reverse(split($splitme, $$val)); for (my $i = 0; $i <= $#parts; $i++) { $working[$i] = $parts[$i]; } my $checkme = NetAddr::IP->new(join($joinme, reverse(@working))) or return 0; return 0 unless $checkme->within($parnet); $$addr = $checkme; # force "correct" IP to be recorded. return 1; } my ($parstr) = $dbh->selectrow_array("SELECT revnet FROM revzones WHERE rdns_id = ?", undef, ($id)); my $parnet = NetAddr::IP->new($parstr); # Fail early on v6-in-v4 or v4-in-v6. We're not accepting these ATM. return 0 if $parnet->addr =~ /\./ && $$val =~ /:/; return 0 if $parnet->addr =~ /:/ && $$val =~ /\./; if ($$addr && $$val =~ /^[\da-fA-F][\da-fA-F:]+[\da-fA-F]$/) { # the only case where NetAddr::IP's acceptance of legitimate IPs is "correct" is for a proper IPv6 address. # the rest we have to restructure before fiddling. *sigh* return 1 if $$addr->within($parnet); } else { # We don't have a complete IP in $$val (yet) if ($parnet->addr =~ /:/) { $$val =~ s/^:+//; # gotta strip'em all... return __rev_overlay(':', $parnet, $val, $addr); } if ($parnet->addr =~ /\./) { $$val =~ s/^\.+//; return __rev_overlay('.', $parnet, $val, $addr); } # should be impossible to get here... } # ... and here. # can't do nuttin' in forward zones } # end _ipparent() ## DNSDB::_hostparent() # A little different than _ipparent above; this tries to *find* the parent zone of a hostname # Takes a database handle and hostname. # Returns the domain ID of the parent domain if one was found. sub _hostparent { my $dbh = shift; my $hname = shift; my @hostbits = split /\./, $hname; my $sth = $dbh->prepare("SELECT count(*),domain_id FROM domains WHERE domain = ? GROUP BY domain_id"); foreach (@hostbits) { $sth->execute($hname); my ($found, $parid) = $sth->fetchrow_array; if ($found) { return $parid; } $hname =~ s/^$_\.//; } } # end _hostparent() ## DNSDB::_log() # Log an action # Takes a database handle and log entry hash containing at least: # group_id, log entry # and optionally one or more of: # domain_id, rdns_id # The %userdata hash provides the user ID, username, and fullname sub _log { my $dbh = shift; my %args = @_; $args{rdns_id} = 0 if !$args{rdns_id}; $args{domain_id} = 0 if !$args{domain_id}; ##fixme: farm out the actual logging to different subs for file, syslog, internal, etc based on config # if ($config{log_channel} eq 'sql') { $dbh->do("INSERT INTO log (domain_id,rdns_id,group_id,entry,user_id,email,name) VALUES (?,?,?,?,?,?,?)", undef, ($args{domain_id}, $args{rdns_id}, $args{group_id}, $args{entry}, $userdata{userid}, $userdata{username}, $userdata{fullname}) ); # } elsif ($config{log_channel} eq 'file') { # } elsif ($config{log_channel} eq 'syslog') { # } } # end _log ## ## Record validation subs. ## ## All of these subs take substantially the same arguments: # a database handle # a hash containing at least the following keys: # - defrec (default/live flag) # - revrec (forward/reverse flag) # - id (parent entity ID) # - host (hostname) # - rectype # - val (IP, hostname [CNAME/MX/SRV] or text) # - addr (NetAddr::IP object from val. May be undef.) # MX and SRV record validation also expect distance, and SRV records expect weight and port as well. # host, rectype, and addr should be references as these may be modified in validation # A record sub _validate_1 { my $dbh = shift; my %args = @_; return ('FAIL', 'Reverse zones cannot contain A records') if $args{revrec} eq 'y'; # Coerce all hostnames to end in ".DOMAIN" for group/default records, # or the intended parent domain for live records. my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id})); ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/; # Check IP is well-formed, and that it's a v4 address # Fail on "compact" IPv4 variants, because they are not consistent and predictable. return ('FAIL',"$typemap{${$args{rectype}}} record must be a valid IPv4 address") unless ${$args{val}} =~ /^\d+\.\d+\.\d+\.\d+$/; return ('FAIL',"$typemap{${$args{rectype}}} record must be a valid IPv4 address") unless $args{addr} && !$args{addr}->{isv6}; # coerce IP/value to normalized form for storage ${$args{val}} = $args{addr}->addr; return ('OK','OK'); } # done A record # NS record sub _validate_2 { my $dbh = shift; my %args = @_; # Coerce the hostname to "DOMAIN" for forward default records, "ZONE" for reverse default records, # or the intended parent zone for live records. ##fixme: allow for delegating .DOMAIN? if ($args{revrec} eq 'y') { my $pname = ($args{defrec} eq 'y' ? 'ZONE' : revName($dbh,$args{id})); ${$args{host}} = $pname if ${$args{host}} ne $pname; } else { my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id})); ${$args{host}} = $pname if ${$args{host}} ne $pname; } # Let this lie for now. Needs more magic. # # Check IP is well-formed, and that it's a v4 address # return ('FAIL',"A record must be a valid IPv4 address") # unless $addr && !$addr->{isv6}; # # coerce IP/value to normalized form for storage # $$val = $addr->addr; return ('OK','OK'); } # done NS record # CNAME record sub _validate_5 { my $dbh = shift; my %args = @_; # Not really true, but these are only useful for delegating smaller-than-/24 IP blocks. # This is fundamentally a messy operation and should really just be taken care of by the # export process, not manual maintenance of the necessary records. return ('FAIL', 'Reverse zones cannot contain CNAME records') if $args{revrec} eq 'y'; # Coerce all hostnames to end in ".DOMAIN" for group/default records, # or the intended parent domain for live records. my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id})); ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/; return ('OK','OK'); } # done CNAME record # SOA record sub _validate_6 { # Smart monkeys won't stick their fingers in here; we have # separate dedicated routines to deal with SOA records. return ('OK','OK'); } # done SOA record # PTR record sub _validate_12 { my $dbh = shift; my %args = @_; if ($args{revrec} eq 'y') { if ($args{defrec} eq 'n') { return ('FAIL', "IP or IP fragment ${$args{val}} is not within ".revName($dbh, $args{id})) unless _ipparent($dbh, $args{defrec}, $args{revrec}, $args{val}, $args{id}, \$args{addr}); ${$args{val}} = $args{addr}->addr; } else { if (${$args{val}} =~ /\./) { # looks like a v4 or fragment if (${$args{val}} =~ /^\d+\.\d+\.\d+\.\d+$/) { # woo! a complete IP! validate it and normalize, or fail. $args{addr} = NetAddr::IP->new(${$args{val}}) or return ('FAIL', "IP/value looks like IPv4 but isn't valid"); ${$args{val}} = $args{addr}->addr; } else { ${$args{val}} =~ s/^\.*/ZONE./ unless ${$args{val}} =~ /^ZONE/; } } elsif (${$args{val}} =~ /[a-f:]/) { # looks like a v6 or fragment ${$args{val}} =~ s/^:*/ZONE::/ if !$args{addr} && ${$args{val}} !~ /^ZONE/; if ($args{addr}) { if ($args{addr}->addr =~ /^0/) { ${$args{val}} =~ s/^:*/ZONE::/ unless ${$args{val}} =~ /^ZONE/; } else { ${$args{val}} = $args{addr}->addr; } } } else { # bare number (probably). These could be v4 or v6, so we'll # expand on these on creation of a reverse zone. ${$args{val}} = "ZONE,${$args{val}}" unless ${$args{val}} =~ /^ZONE/; } ${$args{host}} =~ s/\.*$/\.$config{domain}/ if ${$args{host}} !~ /(?:$config{domain}|ADMINDOMAIN)$/; } # Multiple PTR records do NOT generally do what most people believe they do, # and tend to fail in the most awkward way possible. Check and warn. # We use $val instead of $addr->addr since we may be in a defrec, and may have eg "ZONE::42" or "ZONE.12" my @checkvals = (${$args{val}}); if (${$args{val}} =~ /,/) { # push . and :: variants into checkvals if val has , my $tmp; ($tmp = ${$args{val}}) =~ s/,/./; push @checkvals, $tmp; ($tmp = ${$args{val}}) =~ s/,/::/; push @checkvals, $tmp; } my $pcsth = $dbh->prepare("SELECT count(*) FROM "._rectable($args{defrec},$args{revrec})." WHERE val = ?"); foreach my $checkme (@checkvals) { if ($args{update}) { # Record update. There should usually be an existing PTR (the record being updated) my @ptrs = @{ $dbh->selectcol_arrayref("SELECT record_id FROM "._rectable($args{defrec},$args{revrec}). " WHERE val = ?", undef, ($checkme)) }; return ('WARN', "PTR record for $checkme already exists; adding another will probably not do what you want") if @ptrs && (!grep /^$args{update}$/, @ptrs); } else { # New record. Always warn if a PTR exists my ($ptrcount) = $dbh->selectrow_array("SELECT count(*) FROM "._rectable($args{defrec},$args{revrec}). " WHERE val = ?", undef, ($checkme)); return ('WARN', "PTR record for $checkme already exists; adding another will probably not do what you want") if $ptrcount; } } } else { # Not absolutely true but only useful if you hack things up for sub-/24 v4 reverse delegations # Simpler to just create the reverse zone and grant access for the customer to edit it, and create direct # PTR records on export return ('FAIL',"Forward zones cannot contain PTR records"); } return ('OK','OK'); } # done PTR record # MX record sub _validate_15 { my $dbh = shift; my %args = @_; # Not absolutely true but WTF use is an MX record for a reverse zone? return ('FAIL', 'Reverse zones cannot contain MX records') if $args{revrec} eq 'y'; return ('FAIL', "Distance is required for MX records") unless defined(${$args{dist}}); ${$args{dist}} =~ s/\s*//g; return ('FAIL',"Distance is required, and must be numeric") unless ${$args{dist}} =~ /^\d+$/; ${$args{fields}} = "distance,"; push @{$args{vallist}}, ${$args{dist}}; # Coerce all hostnames to end in ".DOMAIN" for group/default records, # or the intended parent domain for live records. my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id})); ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/; # hmm.. this might work. except possibly for something pointing to "deadbeef.ca". # if ($type == $reverse_typemap{NS} || $type == $reverse_typemap{MX} || $type == $reverse_typemap{SRV}) { # if ($val =~ /^\s*[\da-f:.]+\s*$/) { # return ('FAIL',"$val is not a valid IP address") if !$addr; # } # } return ('OK','OK'); } # done MX record # TXT record sub _validate_16 { # Could arguably put a WARN return here on very long (>512) records return ('OK','OK'); } # done TXT record # RP record sub _validate_17 { # Probably have to validate these some day return ('OK','OK'); } # done RP record # AAAA record sub _validate_28 { my $dbh = shift; my %args = @_; return ('FAIL', 'Reverse zones cannot contain AAAA records') if $args{revrec} eq 'y'; # Coerce all hostnames to end in ".DOMAIN" for group/default records, # or the intended parent domain for live records. my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id})); ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/; # Check IP is well-formed, and that it's a v6 address return ('FAIL',"$typemap{${$args{rectype}}} record must be a valid IPv6 address") unless $args{addr} && $args{addr}->{isv6}; # coerce IP/value to normalized form for storage ${$args{val}} = $args{addr}->addr; return ('OK','OK'); } # done AAAA record # SRV record sub _validate_33 { my $dbh = shift; my %args = @_; # Not absolutely true but WTF use is an SRV record for a reverse zone? return ('FAIL', 'Reverse zones cannot contain SRV records') if $args{revrec} eq 'y'; return ('FAIL', "Distance is required for SRV records") unless defined(${$args{dist}}); ${$args{dist}} =~ s/\s*//g; return ('FAIL',"Distance is required, and must be numeric") unless ${$args{dist}} =~ /^\d+$/; return ('FAIL',"SRV records must begin with _service._protocol [${$args{host}}]") unless ${$args{host}} =~ /^_[A-Za-z]+\._[A-Za-z]+\.[a-zA-Z0-9-]+/; return ('FAIL',"Port and weight are required for SRV records") unless defined(${$args{weight}}) && defined(${$args{port}}); ${$args{weight}} =~ s/\s*//g; ${$args{port}} =~ s/\s*//g; return ('FAIL',"Port and weight are required, and must be numeric") unless ${$args{weight}} =~ /^\d+$/ && ${$args{port}} =~ /^\d+$/; ${$args{fields}} = "distance,weight,port,"; push @{$args{vallist}}, (${$args{dist}}, ${$args{weight}}, ${$args{port}}); # Coerce all hostnames to end in ".DOMAIN" for group/default records, # or the intended parent domain for live records. my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id})); ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/; return ('OK','OK'); } # done SRV record # Now the custom types # A+PTR record. With a very little bit of magic we can also use this sub to validate AAAA+PTR. Whee! sub _validate_65280 { my $dbh = shift; my %args = @_; my $code = 'OK'; my $msg = 'OK'; if ($args{defrec} eq 'n') { # live record; revrec determines whether we validate the PTR or A component first. if ($args{revrec} eq 'y') { ($code,$msg) = _validate_12($dbh, %args); return ($code,$msg) if $code eq 'FAIL'; # Check if the reqested domain exists. If not, coerce the type down to PTR and warn. if (!(${$args{domid}} = _hostparent($dbh, ${$args{host}}))) { my $addmsg = "Record ".($args{update} ? 'updated' : 'added'). " as PTR instead of $typemap{${$args{rectype}}}; domain not found for ${$args{host}}"; $msg .= "\n$addmsg" if $code eq 'WARN'; $msg = $addmsg if $code eq 'OK'; ${$args{rectype}} = $reverse_typemap{PTR}; return ('WARN', $msg); } # Add domain ID to field list and values ${$args{fields}} .= "domain_id,"; push @{$args{vallist}}, ${$args{domid}}; } else { ($code,$msg) = _validate_1($dbh, %args) if ${$args{rectype}} == 65280; ($code,$msg) = _validate_28($dbh, %args) if ${$args{rectype}} == 65281; return ($code,$msg) if $code eq 'FAIL'; # Check if the requested reverse zone exists - note, an IP fragment won't # work here since we don't *know* which parent to put it in. # ${$args{val}} has been validated as a valid IP by now, in one of the above calls. my ($revid) = $dbh->selectrow_array("SELECT rdns_id FROM revzones WHERE revnet >> ?". " ORDER BY masklen(revnet) DESC", undef, (${$args{val}})); if (!$revid) { $msg = "Record ".($args{update} ? 'updated' : 'added')." as ".(${$args{rectype}} == 65280 ? 'A' : 'AAAA'). " instead of $typemap{${$args{rectype}}}; reverse zone not found for ${$args{val}}"; ${$args{rectype}} = (${$args{rectype}} == 65280 ? $reverse_typemap{A} : $reverse_typemap{AAAA}); return ('WARN', $msg); } # Check for duplicate PTRs. Note we don't have to play games with $code and $msg, because # by definition there can't be duplicate PTRs if the reverse zone isn't managed here. if ($args{update}) { # Record update. There should usually be an existing PTR (the record being updated) my @ptrs = @{ $dbh->selectcol_arrayref("SELECT record_id FROM "._rectable($args{defrec},$args{revrec}). " WHERE val = ?", undef, (${$args{val}})) }; if (@ptrs && (!grep /^$args{update}$/, @ptrs)) { $msg = "PTR record for ${$args{val}} already exists; adding another will probably not do what you want"; $code = 'WARN'; } } else { # New record. Always warn if a PTR exists my ($ptrcount) = $dbh->selectrow_array("SELECT count(*) FROM "._rectable($args{defrec},$args{revrec}). " WHERE val = ?", undef, (${$args{val}})); $msg = "PTR record for ${$args{val}} already exists; adding another will probably not do what you want" if $ptrcount; $code = 'WARN' if $ptrcount; } # my ($ptrcount) = $dbh->selectrow_array("SELECT count(*) FROM "._rectable($args{defrec},$args{revrec}). # " WHERE val = ?", undef, ${$args{val}}); # if ($ptrcount) { # my $curid = $dbh->selectrow_array("SELECT record_id FROM "._rectable($args{defrec},$args{revrec}). # " WHERE val = ? # $msg = "PTR record for ${$args{val}} already exists; adding another will probably not do what you want"; # $code = 'WARN'; # } ${$args{fields}} .= "rdns_id,"; push @{$args{vallist}}, $revid; } } else { # defrec eq 'y' if ($args{revrec} eq 'y') { ($code,$msg) = _validate_12($dbh, %args); return ($code,$msg) if $code eq 'FAIL'; if (${$args{rectype}} == 65280) { return ('FAIL',"A+PTR record must be a valid IPv4 address or fragment") if ${$args{val}} =~ /:/; ${$args{val}} =~ s/^ZONE,/ZONE./; # Clean up after uncertain IP-fragment-type from _validate_12 } elsif (${$args{rectype}} == 65281) { return ('FAIL',"AAAA+PTR record must be a valid IPv6 address or fragment") if ${$args{val}} =~ /\./; ${$args{val}} =~ s/^ZONE,/ZONE::/; # Clean up after uncertain IP-fragment-type from _validate_12 } } else { # This is easy. I also can't see a real use-case for A/AAAA+PTR in *all* forward # domains, since you wouldn't be able to substitute both domain and reverse zone # sanely, and you'd end up with guaranteed over-replicated PTR records that would # confuse the hell out of pretty much anything that uses them. ##fixme: make this a config flag? return ('FAIL', "$typemap{${$args{rectype}}} records not allowed in default domains"); } } return ($code, $msg); } # done A+PTR record # AAAA+PTR record # A+PTR above has been magicked to handle AAAA+PTR as well. sub _validate_65281 { return _validate_65280(@_); } # done AAAA+PTR record # PTR template record sub _validate_65282 { return ('OK','OK'); } # done PTR template record # A+PTR template record sub _validate_65283 { return ('OK','OK'); } # done AAAA+PTR template record # AAAA+PTR template record sub _validate_65284 { return ('OK','OK'); } # done AAAA+PTR template record ## ## Record data substitution subs ## # Replace ZONE in hostname, or create (most of) the actual proper zone name sub _ZONE { my $zone = shift; my $string = shift; my $fr = shift || 'f'; # flag for forward/reverse order? nb: ignored for IP my $sep = shift || '-'; # Separator character - unlikely we'll ever need more than . or - my $prefix; $string =~ s/,/./ if !$zone->{isv6}; $string =~ s/,/::/ if $zone->{isv6}; # Subbing ZONE in the host. We need to properly ID the netblock range # The subbed text should have "network IP with trailing zeros stripped" for # blocks lined up on octet (for v4) or hex-quad (for v6) boundaries # For blocks that do NOT line up on these boundaries, we take the most # significant octet or 16-bit chunk of the "broadcast" IP and append it # after a double-dash # ie: # 8.0.0.0/6 -> 8.0.0.0 -> 11.255.255.255; sub should be 8--11 # 10.0.0.0/12 -> 10.0.0.0 -> 10.0.0.0 -> 10.15.255.255; sub should be 10-0--15 # 192.168.4.0/22 -> 192.168.4.0 -> 192.168.7.255; sub should be 192-168-4--7 # 192.168.0.8/29 -> 192.168.0.8 -> 192.168.0.15; sub should be 192-168-0-8--15 # Similar for v6 if (!$zone->{isv6}) { # IPv4 $prefix = $zone->network->addr; # Just In Case someone managed to slip in # a funky subnet that had host bits set. my $bc = $zone->broadcast->addr; if ($zone->masklen > 24) { $bc =~ s/^\d+\.\d+\.\d+\.//; } elsif ($zone->masklen > 16) { $prefix =~ s/\.0$//; $bc =~ s/^\d+\.\d+\.//; } elsif ($zone->masklen > 8) { $bc =~ s/^\d+\.//; $prefix =~ s/\.0\.0$//; } else { $prefix =~ s/\.0\.0\.0$//; } if ($zone->masklen % 8) { $bc =~ s/(\.255)+$//; $prefix .= "--$bc"; #"--".zone->masklen; # use range or mask length? } if ($fr eq 'f') { $prefix =~ s/\.+/$sep/g; } else { $prefix = join($sep, reverse(split(/\./, $prefix))); } } else { # IPv6 if ($fr eq 'f') { $prefix = $zone->network->addr; # Just In Case someone managed to slip in # a funky subnet that had host bits set. my $bc = $zone->broadcast->addr; if (($zone->masklen % 16) != 0) { # Strip trailing :0 off $prefix, and :ffff off the broadcast IP for (my $i=0; $i<(7-int($zone->masklen / 16)); $i++) { $prefix =~ s/:0$//; $bc =~ s/:ffff$//; } # Strip the leading 16-bit chunks off the front of the broadcast IP $bc =~ s/^([a-f0-9]+:)+//; # Append the remaining 16-bit chunk to the prefix after "--" $prefix .= "--$bc"; } else { # Strip off :0 from the end until we reach the netblock length. for (my $i=0; $i<(8-$zone->masklen / 16); $i++) { $prefix =~ s/:0$//; } } # Actually deal with the separator $prefix =~ s/:/$sep/g; } else { # $fr eq 'f' $prefix = $zone->network->full; # Just In Case someone managed to slip in # a funky subnet that had host bits set. my $bc = $zone->broadcast->full; $prefix =~ s/://g; # clean these out since they're not spaced right for this case $bc =~ s/://g; # Strip trailing 0 off $prefix, and f off the broadcast IP, to match the mask length for (my $i=0; $i<(31-int($zone->masklen / 4)); $i++) { $prefix =~ s/0$//; $bc =~ s/f$//; } # Split and reverse the order of the nibbles in the network/broadcast IPs $prefix =~ s/0$// if $zone->masklen % 4 == 0; # trim another 0 for nibble-aligned blocks first my @nbits = reverse split //, $prefix; my @bbits = reverse split //, $bc; # Handle the sub-nibble case. Eww. I feel dirty supporting this... $nbits[0] = "$nbits[0]-$bbits[0]" if ($zone->masklen % 4) != 0; # Glue it back together $prefix = join($sep, @nbits); } # $fr ne 'f' } # $zone->{isv6} # Do the substitution, finally $string =~ s/ZONE/$prefix/; $string =~ s/--/-/ if $sep ne '-'; # - as separator needs extra help for sub-octet v4 netblocks return $string; } # done _ZONE() # Not quite a substitution sub, but placed here as it's basically the inverse of above; # given the .arpa zone name, return the CIDR netblock the zone is for. # Supports v4 non-octet/non-classful netblocks as per the method outlined in the Grasshopper Book (2nd Ed p217-218) # Does NOT support non-quad v6 netblocks via the same scheme; it shouldn't ever be necessary. # Takes a nominal .arpa zone name, returns a success code and NetAddr::IP, or a fail code and message sub _zone2cidr { my $zone = shift; my $cidr; my $tmpcidr; my $warnmsg = ''; if ($zone =~ /\.in-addr\.arpa\.?$/) { # v4 revzone, formal zone name type my $tmpzone = $zone; $tmpzone =~ s/\.in-addr\.arpa\.?//; return ('FAIL', "Non-numerics in apparent IPv4 reverse zone name") if $tmpzone !~ /^(?:\d+-)?[\d\.]+$/; # Snag the octet pieces my @octs = split /\./, $tmpzone; # Map result of a range manipulation to a mask length change. Cheaper than finding the 2-root of $octets[0]+1. # Note we will not support /31 blocks, mostly due to issues telling "24-31" -> .24/29 apart from # "24-31" -> .24/31", with a litte bit of "/31 is icky". my %maskmap = ( 3 => 2, 7 => 3, 15 => 4, 31 => 5, 63 => 6, 127 => 7, 30 => 2, 29 => 3, 28 => 4, 27 => 5, 26 => 6, 25 => 7 ); # Handle "range" blocks, eg, 80-83.168.192.in-addr.arpa (192.168.80.0/22) # Need to take the size of the range to offset the basic octet-based mask length, # and make sure the first number in the range gets used as the network address for the block # Alternate form: The second number is actually the real netmask, not the end of the range. my $masklen = 0; if ($octs[0] =~ /^((\d+)-(\d+))$/) { # take the range... if (24 < $3 && $3 < 31) { # we have a real netmask $masklen = -$maskmap{$3}; } else { # we have a range. NB: only real CIDR ranges are supported $masklen -= $maskmap{-(eval $1)}; # find the mask base... } $octs[0] = $2; # set the base octet of the range... } @octs = reverse @octs; # We can reverse the octet pieces now that we've extracted and munged any ranges # arguably we should only allow sub-octet range/mask in-addr.arpa # specifications in the least significant octet, but the code is # simpler if we deal with sub-octet delegations at any level. # Now we find the "true" mask with the aid of the "base" calculated above if ($#octs == 0) { $masklen += 8; $tmpcidr = "$octs[0].0.0.0/$masklen"; # really hope we don't see one of these very often. } elsif ($#octs == 1) { $masklen += 16; $tmpcidr = "$octs[0].$octs[1].0.0/$masklen"; } elsif ($#octs == 2) { $masklen += 24; $tmpcidr = "$octs[0].$octs[1].$octs[2].0/$masklen"; } else { $masklen += 32; $tmpcidr = "$octs[0].$octs[1].$octs[2].$octs[3]/$masklen"; } } elsif ($zone =~ /\.ip6\.arpa$/) { # v6 revzone, formal zone name type my $tmpzone = $zone; $tmpzone =~ s/\.ip6\.arpa\.?//; ##fixme: if-n-when we decide we can support sub-nibble v6 zone names, we'll need to change this segment return ('FAIL', "Non-hexadecimals in apparent IPv6 reverse zone name") if $tmpzone !~ /^[a-fA-F\d\.]+$/; my @quads = reverse(split(/\./, $tmpzone)); $warnmsg .= "Apparent sub-/64 IPv6 reverse zone\n" if $#quads > 15; my $nc; foreach (@quads) { $tmpcidr .= $_; $tmpcidr .= ":" if ++$nc % 4 == 0; } my $nq = 1 if $nc % 4 != 0; my $mask = $nc * 4; # need to do this here because we probably increment it below while ($nc++ % 4 != 0) { $tmpcidr .= "0"; } $tmpcidr .= ($nq ? '::' : ':')."/$mask"; } # Just to be sure, use NetAddr::IP to validate. Saves a lot of nasty regex watching for valid octet values. return ('FAIL', "Invalid zone $zone (apparent netblock $tmpcidr)") unless $cidr = NetAddr::IP->new($tmpcidr); if ($warnmsg) { $errstr = $warnmsg; return ('WARN', $cidr); } return ('OK', $cidr); } # done _zone2cidr() ## ## Initialization and cleanup subs ## ## DNSDB::loadConfig() # Load the minimum required initial state (DB connect info) from a config file # Load misc other bits while we're at it. # Takes an optional basename and config path to look for # Populates the %config and %def hashes sub loadConfig { my $basename = shift || ''; # this will work OK ##fixme $basename isn't doing what I think I thought I was trying to do. my $deferr = ''; # place to put error from default config file in case we can't find either one my $configroot = "/etc/dnsdb"; ##CFG_LEAF## $configroot = '' if $basename =~ m|^/|; $basename .= ".conf" if $basename !~ /\.conf$/; my $defconfig = "$configroot/dnsdb.conf"; my $siteconfig = "$configroot/$basename"; # System defaults __cfgload("$defconfig") or $deferr = $errstr; # Per-site-ish settings. if ($basename ne '.conf') { unless (__cfgload("$siteconfig")) { $errstr = ($deferr ? "Error opening default config file $defconfig: $deferr\n" : ''). "Error opening site config file $siteconfig"; return; } } # Munge log_failures. if ($config{log_failures} ne '1' && $config{log_failures} ne '0') { # true/false, on/off, yes/no all valid. if ($config{log_failures} =~ /^(?:true|false|on|off|yes|no)$/) { if ($config{log_failures} =~ /(?:true|on|yes)/) { $config{log_failures} = 1; } else { $config{log_failures} = 0; } } else { $errstr = "Bad log_failures setting $config{log_failures}"; $config{log_failures} = 1; # Bad setting shouldn't be fatal. # return 2; } } # All good, clear the error and go home. $errstr = ''; return 1; } # end loadConfig() ## DNSDB::__cfgload() # Private sub to parse a config file and load it into %config # Takes a file handle on an open config file sub __cfgload { $errstr = ''; my $cfgfile = shift; if (open CFG, "<$cfgfile") { while () { chomp; s/^\s*//; next if /^#/; next if /^$/; # hmm. more complex bits in this file might require [heading] headers, maybe? # $mode = $1 if /^\[(a-z)+]/; # DB connect info $config{dbname} = $1 if /^dbname\s*=\s*([a-z0-9_.-]+)/i; $config{dbuser} = $1 if /^dbuser\s*=\s*([a-z0-9_.-]+)/i; $config{dbpass} = $1 if /^dbpass\s*=\s*([a-z0-9_.-]+)/i; $config{dbhost} = $1 if /^dbhost\s*=\s*([a-z0-9_.-]+)/i; # SOA defaults $def{contact} = $1 if /^contact\s*=\s*([a-z0-9_.-]+)/i; $def{prins} = $1 if /^prins\s*=\s*([a-z0-9_.-]+)/i; $def{soattl} = $1 if /^soattl\s*=\s*(\d+)/i; $def{refresh} = $1 if /^refresh\s*=\s*(\d+)/i; $def{retry} = $1 if /^retry\s*=\s*(\d+)/i; $def{expire} = $1 if /^expire\s*=\s*(\d+)/i; $def{minttl} = $1 if /^minttl\s*=\s*(\d+)/i; $def{ttl} = $1 if /^ttl\s*=\s*(\d+)/i; # Mail settings $config{mailhost} = $1 if /^mailhost\s*=\s*([a-z0-9_.-]+)/i; $config{mailnotify} = $1 if /^mailnotify\s*=\s*([a-z0-9_.\@-]+)/i; $config{mailsender} = $1 if /^mailsender\s*=\s*([a-z0-9_.\@-]+)/i; $config{mailname} = $1 if /^mailname\s*=\s*([a-z0-9\s_.-]+)/i; $config{orgname} = $1 if /^orgname\s*=\s*([a-z0-9\s_.,'-]+)/i; $config{domain} = $1 if /^domain\s*=\s*([a-z0-9_.-]+)/i; # session - note this is fed directly to CGI::Session $config{timeout} = $1 if /^[tT][iI][mM][eE][oO][uU][tT]\s*=\s*(\d+[smhdwMy]?)/; $config{sessiondir} = $1 if m{^sessiondir\s*=\s*([a-z0-9/_.-]+)}i; # misc $config{log_failures} = $1 if /^log_failures\s*=\s*([a-z01]+)/i; $config{perpage} = $1 if /^perpage\s*=\s*(\d+)/i; } close CFG; } else { $errstr = $!; return; } return 1; } # end __cfgload() ## DNSDB::connectDB() # Creates connection to DNS database. # Requires the database name, username, and password. # Returns a handle to the db. # Set up for a PostgreSQL db; could be any transactional DBMS with the # right changes. sub connectDB { $errstr = ''; my $dbname = shift; my $user = shift; my $pass = shift; my $dbh; my $DSN = "DBI:Pg:dbname=$dbname"; my $host = shift; $DSN .= ";host=$host" if $host; # Note that we want to autocommit by default, and we will turn it off locally as necessary. # We may not want to print gobbledygook errors; YMMV. Have to ponder that further. $dbh = DBI->connect($DSN, $user, $pass, { AutoCommit => 1, PrintError => 0 }) or return (undef, $DBI::errstr) if(!$dbh); ##fixme: initialize the DB if we can't find the table (since, by definition, there's # nothing there if we can't select from it...) my $tblsth = $dbh->prepare("SELECT count(*) FROM pg_catalog.pg_class WHERE relkind='r' AND relname=?"); my ($tblcount) = $dbh->selectrow_array($tblsth, undef, ('misc')); return (undef,$DBI::errstr) if $dbh->err; #if ($tblcount == 0) { # # create tables one at a time, checking for each. # return (undef, "check table misc missing"); #} # Return here if we can't select. # This should retrieve the dbversion key. my $sth = $dbh->prepare("SELECT key,value FROM misc WHERE misc_id=1"); $sth->execute(); return (undef,$DBI::errstr) if ($sth->err); ##fixme: do stuff to the DB on version mismatch # x.y series should upgrade on $DNSDB::VERSION > misc(key=>version) # DB should be downward-compatible; column defaults should give sane (if possibly # useless-and-needs-help) values in columns an older software stack doesn't know about. # See if the select returned anything (or null data). This should # succeed if the select executed, but... $sth->fetchrow(); return (undef,$DBI::errstr) if ($sth->err); $sth->finish; # If we get here, we should be OK. return ($dbh,"DB connection OK"); } # end connectDB ## DNSDB::finish() # Cleans up after database handles and so on. # Requires a database handle sub finish { my $dbh = $_[0]; $dbh->disconnect; } # end finish ## DNSDB::initGlobals() # Initialize global variables # NB: this does NOT include web-specific session variables! # Requires a database handle sub initGlobals { my $dbh = shift; # load record types from database my $sth = $dbh->prepare("SELECT val,name,stdflag FROM rectypes"); $sth->execute; while (my ($recval,$recname,$stdflag) = $sth->fetchrow_array()) { $typemap{$recval} = $recname; $reverse_typemap{$recname} = $recval; # now we fill the record validation function hash if ($stdflag < 5) { my $fn = "_validate_$recval"; $validators{$recval} = \&$fn; } else { my $fn = "sub { return ('FAIL','Type $recval ($recname) not supported'); }"; $validators{$recval} = eval $fn; } } } # end initGlobals ## DNSDB::login() # Takes a database handle, username and password # Returns a userdata hash (UID, GID, username, fullname parts) if username exists, # password matches the one on file, and account is not disabled # Returns undef otherwise sub login { my $dbh = shift; my $user = shift; my $pass = shift; my $userinfo = $dbh->selectrow_hashref("SELECT user_id,group_id,password,firstname,lastname,status". " FROM users WHERE username=?", undef, ($user) ); return if !$userinfo; return if !$userinfo->{status}; if ($userinfo->{password} =~ m|^\$1\$([A-Za-z0-9/.]+)\$|) { # native passwords (crypt-md5) return if $userinfo->{password} ne unix_md5_crypt($pass,$1); } elsif ($userinfo->{password} =~ /^[0-9a-f]{32}$/) { # VegaDNS import (hex-coded MD5) return if $userinfo->{password} ne md5_hex($pass); } else { # plaintext (convenient now and then) return if $userinfo->{password} ne $pass; } return $userinfo; } # end login() ## DNSDB::initActionLog() # Set up action logging. Takes a database handle and user ID # Sets some internal globals and Does The Right Thing to set up a logging channel. # This sets up _log() to spew out log entries to the defined channel without worrying # about having to open a file or a syslog channel ##fixme Need to call _initActionLog_blah() for various logging channels, configured # via dnsdb.conf, in $config{log_channel} or something # See https://secure.deepnet.cx/trac/dnsadmin/ticket/21 sub initActionLog { my $dbh = shift; my $uid = shift; return if !$uid; # snag user info for logging. there's got to be a way to not have to pass this back # and forth from a caller, but web usage means no persistence we can rely on from # the server side. my ($username,$fullname) = $dbh->selectrow_array("SELECT username, firstname || ' ' || lastname". " FROM users WHERE user_id=?", undef, ($uid)); ##fixme: errors are unpossible! $userdata{username} = $username; $userdata{userid} = $uid; $userdata{fullname} = $fullname; # convert to real check once we have other logging channels # if ($config{log_channel} eq 'sql') { # Open Log, Sez Me! # } } # end initActionLog ## DNSDB::initPermissions() # Set up permissions global # Takes database handle and UID sub initPermissions { my $dbh = shift; my $uid = shift; # %permissions = $(getPermissions($dbh,'user',$uid)); getPermissions($dbh, 'user', $uid, \%permissions); } # end initPermissions() ## DNSDB::getPermissions() # Get permissions from DB # Requires DB handle, group or user flag, ID, and hashref. sub getPermissions { my $dbh = shift; my $type = shift; my $id = shift; my $hash = shift; my $sql = qq( SELECT p.admin,p.self_edit, p.group_create,p.group_edit,p.group_delete, p.user_create,p.user_edit,p.user_delete, p.domain_create,p.domain_edit,p.domain_delete, p.record_create,p.record_edit,p.record_delete FROM permissions p ); if ($type eq 'group') { $sql .= qq( JOIN groups g ON g.permission_id=p.permission_id WHERE g.group_id=? ); } else { $sql .= qq( JOIN users u ON u.permission_id=p.permission_id WHERE u.user_id=? ); } my $sth = $dbh->prepare($sql); $sth->execute($id) or die "argh: ".$sth->errstr; # my $permref = $sth->fetchrow_hashref; # return $permref; # $hash = $permref; # Eww. Need to learn how to forcibly drop a hashref onto an existing hash. ($hash->{admin},$hash->{self_edit}, $hash->{group_create},$hash->{group_edit},$hash->{group_delete}, $hash->{user_create},$hash->{user_edit},$hash->{user_delete}, $hash->{domain_create},$hash->{domain_edit},$hash->{domain_delete}, $hash->{record_create},$hash->{record_edit},$hash->{record_delete}) = $sth->fetchrow_array; } # end getPermissions() ## DNSDB::changePermissions() # Update an ACL entry # Takes a db handle, type, owner-id, and hashref for the changed permissions. sub changePermissions { my $dbh = shift; my $type = shift; my $id = shift; my $newperms = shift; my $inherit = shift || 0; my $resultmsg = ''; # see if we're switching from inherited to custom. for bonus points, # snag the permid and parent permid anyway, since we'll need the permid # to set/alter custom perms, and both if we're switching from custom to # inherited. my $sth = $dbh->prepare("SELECT (u.permission_id=g.permission_id) AS was_inherited,u.permission_id,g.permission_id,". ($type eq 'user' ? 'u.group_id,u.username' : 'u.parent_group_id,u.group_name'). " FROM ".($type eq 'user' ? 'users' : 'groups')." u ". " JOIN groups g ON u.".($type eq 'user' ? '' : 'parent_')."group_id=g.group_id ". " WHERE u.".($type eq 'user' ? 'user' : 'group')."_id=?"); $sth->execute($id); my ($wasinherited,$permid,$parpermid,$parid,$name) = $sth->fetchrow_array; # hack phtoui # group id 1 is "special" in that it's it's own parent (err... possibly.) # may make its parent id 0 which doesn't exist, and as a bonus is Perl-false. $wasinherited = 0 if ($type eq 'group' && $id == 1); local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; # Wrap all the SQL in a transaction eval { if ($inherit) { $dbh->do("UPDATE ".($type eq 'user' ? 'users' : 'groups')." SET inherit_perm='t',permission_id=? ". "WHERE ".($type eq 'user' ? 'user' : 'group')."_id=?", undef, ($parpermid, $id) ); $dbh->do("DELETE FROM permissions WHERE permission_id=?", undef, ($permid) ); } else { if ($wasinherited) { # munge new permission entry in if we're switching from inherited perms ##fixme: need to add semirecursive bit to properly munge inherited permission ID on subgroups and users # ... if'n'when we have groups with fully inherited permissions. # SQL is coo $dbh->do("INSERT INTO permissions ($permlist,".($type eq 'user' ? 'user' : 'group')."_id) ". "SELECT $permlist,? FROM permissions WHERE permission_id=?", undef, ($id,$permid) ); ($permid) = $dbh->selectrow_array("SELECT permission_id FROM permissions ". "WHERE ".($type eq 'user' ? 'user' : 'group')."_id=?", undef, ($id) ); $dbh->do("UPDATE ".($type eq 'user' ? 'users' : 'groups')." SET inherit_perm='f',permission_id=? ". "WHERE ".($type eq 'user' ? 'user' : 'group')."_id=?", undef, ($permid, $id) ); } # and now set the permissions we were passed foreach (@permtypes) { if (defined ($newperms->{$_})) { $dbh->do("UPDATE permissions SET $_=? WHERE permission_id=?", undef, ($newperms->{$_},$permid) ); } } } # (inherited->)? custom if ($type eq 'user') { $resultmsg = "Updated permissions for user $name"; } else { $resultmsg = "Updated default permissions for group $name"; } _log($dbh, (group_id => ($type eq 'user' ? $parid : $id), entry => $resultmsg)); $dbh->commit; }; # end eval if ($@) { my $msg = $@; eval { $dbh->rollback; }; return ('FAIL',"Error changing permissions: $msg"); } return ('OK',$resultmsg); } # end changePermissions() ## DNSDB::comparePermissions() # Compare two permission hashes # Returns '>', '<', '=', '!' sub comparePermissions { my $p1 = shift; my $p2 = shift; my $retval = '='; # assume equality until proven otherwise no warnings "uninitialized"; foreach (@permtypes) { next if $p1->{$_} == $p2->{$_}; # equal is good if ($p1->{$_} && !$p2->{$_}) { if ($retval eq '<') { # if we've already found an unequal pair where $retval = '!'; # $p2 has more access, and we now find a pair last; # where $p1 has more access, the overall access } # is neither greater or lesser, it's unequal. $retval = '>'; } if (!$p1->{$_} && $p2->{$_}) { if ($retval eq '>') { # if we've already found an unequal pair where $retval = '!'; # $p1 has more access, and we now find a pair last; # where $p2 has more access, the overall access } # is neither greater or lesser, it's unequal. $retval = '<'; } } return $retval; } # end comparePermissions() ## DNSDB::changeGroup() # Change group ID of an entity # Takes a database handle, entity type, entity ID, and new group ID sub changeGroup { my $dbh = shift; my $type = shift; my $id = shift; my $newgrp = shift; ##fixme: fail on not enough args #return ('FAIL', "Missing return ('FAIL', "Can't change the group of a $type") unless grep /^$type$/, ('domain','revzone','user','group'); # could be extended for defrecs? # Collect some names for logging and messages my $entname; if ($type eq 'domain') { $entname = domainName($dbh, $id); } elsif ($type eq 'revzone') { $entname = revName($dbh, $id); } elsif ($type eq 'user') { $entname = userFullName($dbh, $id, '%u'); } elsif ($type eq 'group') { $entname = groupName($dbh, $id); } my ($oldgid) = $dbh->selectrow_array("SELECT group_id FROM $par_tbl{$type} WHERE $id_col{$type}=?", undef, ($id)); my $oldgname = groupName($dbh, $oldgid); my $newgname = groupName($dbh, $newgrp); return ('FAIL', "Can't move things into a group that doesn't exist") if !$newgname; return ('WARN', "Nothing to do, new group is the same as the old group") if $oldgid == $newgrp; # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; eval { $dbh->do("UPDATE $par_tbl{$type} SET group_id=? WHERE $id_col{$type}=?", undef, ($newgrp, $id)); # Log the change in both the old and new groups _log($dbh, (group_id => $oldgid, entry => "Moved $type $entname from $oldgname to $newgname")); _log($dbh, (group_id => $newgrp, entry => "Moved $type $entname from $oldgname to $newgname")); $dbh->commit; }; if ($@) { my $msg = $@; eval { $dbh->rollback; }; if ($config{log_failures}) { _log($dbh, (group_id => $oldgid, entry => "Error moving $type $entname to $newgname: $msg")); $dbh->commit; # since we enabled transactions earlier } return ('FAIL',"Error moving $type $entname to $newgname: $msg"); } return ('OK',"Moved $type $entname from $oldgname to $newgname"); } # end changeGroup() ## ## Processing subs ## ## DNSDB::addDomain() # Add a domain # Takes a database handle, domain name, numeric group, boolean(ish) state (active/inactive), # and user info hash (for logging). # Returns a status code and message sub addDomain { $errstr = ''; my $dbh = shift; return ('FAIL',"Need database handle") if !$dbh; my $domain = shift; return ('FAIL',"Domain must not be blank") if !$domain; my $group = shift; return ('FAIL',"Need group") if !defined($group); my $state = shift; return ('FAIL',"Need domain status") if !defined($state); $state = 1 if $state =~ /^active$/; $state = 1 if $state =~ /^on$/; $state = 0 if $state =~ /^inactive$/; $state = 0 if $state =~ /^off$/; return ('FAIL',"Invalid domain status") if $state !~ /^\d+$/; return ('FAIL', "Invalid characters in domain") if $domain !~ /^[a-zA-Z0-9_.-]+$/; my $sth = $dbh->prepare("SELECT domain_id FROM domains WHERE domain=?"); my $dom_id; # quick check to start to see if we've already got one $sth->execute($domain); ($dom_id) = $sth->fetchrow_array; return ('FAIL', "Domain already exists") if $dom_id; # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; # Wrap all the SQL in a transaction eval { # insert the domain... $dbh->do("INSERT INTO domains (domain,group_id,status) VALUES (?,?,?)", undef, ($domain, $group, $state)); # get the ID... ($dom_id) = $dbh->selectrow_array("SELECT domain_id FROM domains WHERE domain=?", undef, ($domain)); _log($dbh, (domain_id => $dom_id, group_id => $group, entry => "Added ".($state ? 'active' : 'inactive')." domain $domain")); # ... and now we construct the standard records from the default set. NB: group should be variable. my $sth = $dbh->prepare("SELECT host,type,val,distance,weight,port,ttl FROM default_records WHERE group_id=?"); my $sth_in = $dbh->prepare("INSERT INTO records (domain_id,host,type,val,distance,weight,port,ttl)". " VALUES ($dom_id,?,?,?,?,?,?,?)"); $sth->execute($group); while (my ($host,$type,$val,$dist,$weight,$port,$ttl) = $sth->fetchrow_array()) { $host =~ s/DOMAIN/$domain/g; $val =~ s/DOMAIN/$domain/g; $sth_in->execute($host,$type,$val,$dist,$weight,$port,$ttl); if ($typemap{$type} eq 'SOA') { my @tmp1 = split /:/, $host; my @tmp2 = split /:/, $val; _log($dbh, (domain_id => $dom_id, group_id => $group, entry => "[new $domain] Added SOA record [contact $tmp1[0]] [master $tmp1[1]] ". "[refresh $tmp2[0]] [retry $tmp2[1]] [expire $tmp2[2]] [minttl $tmp2[3]], TTL $ttl")); } else { my $logentry = "[new $domain] Added record '$host $typemap{$type}"; $logentry .= " [distance $dist]" if $typemap{$type} eq 'MX'; $logentry .= " [priority $dist] [weight $weight] [port $port]" if $typemap{$type} eq 'SRV'; _log($dbh, (domain_id => $dom_id, group_id => $group, entry => $logentry." $val', TTL $ttl")); } } # once we get here, we should have suceeded. $dbh->commit; }; # end eval if ($@) { my $msg = $@; eval { $dbh->rollback; }; _log($dbh, (group_id => $group, entry => "Failed adding domain $domain ($msg)")) if $config{log_failures}; $dbh->commit; # since we enabled transactions earlier return ('FAIL',$msg); } else { return ('OK',$dom_id); } } # end addDomain ## DNSDB::delZone() # Delete a forward or reverse zone. # Takes a database handle, zone ID, and forward/reverse flag. # for now, just delete the records, then the domain. # later we may want to archive it in some way instead (status code 2, for example?) sub delZone { my $dbh = shift; my $zoneid = shift; my $revrec = shift; # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; my $msg = ''; my $failmsg = ''; my $zone = ($revrec eq 'n' ? domainName($dbh, $zoneid) : revName($dbh, $zoneid)); # Set this up here since we may use if if $config{log_failures} is enabled my %loghash; $loghash{domain_id} = $zoneid if $revrec eq 'n'; $loghash{rdns_id} = $zoneid if $revrec eq 'y'; $loghash{group_id} = parentID($dbh, (id => $zoneid, type => ($revrec eq 'n' ? 'domain' : 'revzone'), revrec => $revrec) ); # Wrap all the SQL in a transaction eval { # Disentangle custom record types before removing the # ones that are only in the zone to be deleted if ($revrec eq 'n') { my $sth = $dbh->prepare("UPDATE records SET type=?,domain_id=0 WHERE domain_id=? AND type=?"); $failmsg = "Failure converting multizone types to single-zone"; $sth->execute($reverse_typemap{PTR}, $zoneid, 65280); $sth->execute($reverse_typemap{PTR}, $zoneid, 65281); $sth->execute(65282, $zoneid, 65283); $sth->execute(65282, $zoneid, 65284); $failmsg = "Failure removing domain records"; $dbh->do("DELETE FROM records WHERE domain_id=?", undef, ($zoneid)); $failmsg = "Failure removing domain"; $dbh->do("DELETE FROM domains WHERE domain_id=?", undef, ($zoneid)); } else { my $sth = $dbh->prepare("UPDATE records SET type=?,rdns_id=0 WHERE rdns_id=? AND type=?"); $failmsg = "Failure converting multizone types to single-zone"; $sth->execute($reverse_typemap{A}, $zoneid, 65280); $sth->execute($reverse_typemap{AAAA}, $zoneid, 65281); # We don't have an "A template" or "AAAA template" type, although it might be useful for symmetry. # $sth->execute(65285?, $zoneid, 65283); # $sth->execute(65285?, $zoneid, 65284); $failmsg = "Failure removing reverse records"; $dbh->do("DELETE FROM records WHERE rdns_id=?", undef, ($zoneid)); $failmsg = "Failure removing reverse zone"; $dbh->do("DELETE FROM revzones WHERE rdns_id=?", undef, ($zoneid)); } $msg = "Deleted ".($revrec eq 'n' ? 'domain' : 'reverse zone')." $zone"; $loghash{entry} = $msg; _log($dbh, %loghash); # once we get here, we should have suceeded. $dbh->commit; }; # end eval if ($@) { $msg = $@; eval { $dbh->rollback; }; $loghash{entry} = "Error deleting $zone: $msg ($failmsg)"; if ($config{log_failures}) { _log($dbh, %loghash); $dbh->commit; # since we enabled transactions earlier } return ('FAIL', $loghash{entry}); } else { return ('OK', $msg); } } # end delZone() ## DNSDB::domainName() # Return the domain name based on a domain ID # Takes a database handle and the domain ID # Returns the domain name or undef on failure sub domainName { $errstr = ''; my $dbh = shift; my $domid = shift; my ($domname) = $dbh->selectrow_array("SELECT domain FROM domains WHERE domain_id=?", undef, ($domid) ); $errstr = $DBI::errstr if !$domname; return $domname if $domname; } # end domainName() ## DNSDB::revName() # Return the reverse zone name based on an rDNS ID # Takes a database handle and the rDNS ID # Returns the reverse zone name or undef on failure sub revName { $errstr = ''; my $dbh = shift; my $revid = shift; my ($revname) = $dbh->selectrow_array("SELECT revnet FROM revzones WHERE rdns_id=?", undef, ($revid) ); $errstr = $DBI::errstr if !$revname; return $revname if $revname; } # end revName() ## DNSDB::domainID() # Takes a database handle and domain name # Returns the domain ID number sub domainID { $errstr = ''; my $dbh = shift; my $domain = shift; my ($domid) = $dbh->selectrow_array("SELECT domain_id FROM domains WHERE domain=?", undef, ($domain) ); $errstr = $DBI::errstr if !$domid; return $domid if $domid; } # end domainID() ## DNSDB::revID() # Takes a database handle and reverse zone name # Returns the rDNS ID number sub revID { $errstr = ''; my $dbh = shift; my $revzone = shift; my ($revid) = $dbh->selectrow_array("SELECT rdns_id FROM revzones WHERE revnet=?", undef, ($revzone) ); $errstr = $DBI::errstr if !$revid; return $revid if $revid; } # end revID() ## DNSDB::addRDNS # Adds a reverse DNS zone # Takes a database handle, CIDR block, reverse DNS pattern, numeric group, # and boolean(ish) state (active/inactive) # Returns a status code and message sub addRDNS { my $dbh = shift; my $zone = NetAddr::IP->new(shift); return ('FAIL',"Zone name must be a valid CIDR netblock") unless ($zone && $zone->addr !~ /^0/); my $revpatt = shift; # construct a custom (A/AAAA+)? PTR template record my $group = shift; my $state = shift; $state = 1 if $state =~ /^active$/; $state = 1 if $state =~ /^on$/; $state = 0 if $state =~ /^inactive$/; $state = 0 if $state =~ /^off$/; return ('FAIL',"Invalid zone status") if $state !~ /^\d+$/; # quick check to start to see if we've already got one my ($rdns_id) = $dbh->selectrow_array("SELECT rdns_id FROM revzones WHERE revnet=?", undef, ("$zone")); return ('FAIL', "Zone already exists") if $rdns_id; # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; my $warnstr = ''; my $defttl = 3600; # 1 hour should be reasonable. And unless things have gone horribly # wrong, we should have a value to override this anyway. # Wrap all the SQL in a transaction eval { # insert the domain... $dbh->do("INSERT INTO revzones (revnet,group_id,status) VALUES (?,?,?)", undef, ($zone, $group, $state)); # get the ID... ($rdns_id) = $dbh->selectrow_array("SELECT currval('revzones_rdns_id_seq')"); _log($dbh, (rdns_id => $rdns_id, group_id => $group, entry => "Added ".($state ? 'active' : 'inactive')." reverse zone $zone")); # ... and now we construct the standard records from the default set. NB: group should be variable. my $sth = $dbh->prepare("SELECT host,type,val,ttl FROM default_rev_records WHERE group_id=?"); my $sth_in = $dbh->prepare("INSERT INTO records (rdns_id,domain_id,host,type,val,ttl)". " VALUES ($rdns_id,?,?,?,?,?)"); $sth->execute($group); while (my ($host,$type,$val,$ttl) = $sth->fetchrow_array()) { # Silently skip v4/v6 mismatches. This is not an error, this is expected. if ($zone->{isv6}) { next if ($type == 65280 || $type == 65283); } else { next if ($type == 65281 || $type == 65284); } $host =~ s/ADMINDOMAIN/$config{domain}/g; # Check to make sure the IP stubs will fit in the zone. Under most usage failures here should be rare. # On failure, tack a note on to a warning string and continue without adding this record. # While we're at it, we substitute $zone for ZONE in the value. if ($val eq 'ZONE') { next if $revpatt; # If we've got a pattern, we skip the default record version. ##fixme? do we care if we have multiple whole-zone templates? $val = $zone->network; } elsif ($val =~ /ZONE/) { my $tmpval = $val; $tmpval =~ s/ZONE//; # Bend the rules and allow single-trailing-number PTR or PTR template records to be inserted # as either v4 or v6. May make this an off-by-default config flag # Note that the origin records that may trigger this **SHOULD** already have ZONE,\d if ($type == 12 || $type == 65282) { $tmpval =~ s/[,.]/::/ if ($tmpval =~ /^[,.]\d+$/ && $zone->{isv6}); $tmpval =~ s/[,:]+/./ if ($tmpval =~ /^(?:,|::)\d+$/ && !$zone->{isv6}); } my $addr; if (_ipparent($dbh, 'n', 'y', \$tmpval, $rdns_id, \$addr)) { $val = $addr->addr; } else { $warnstr .= "\nDefault record '$val $typemap{$type} $host' doesn't fit in $zone, skipping"; next; } } # Substitute $zone for ZONE in the hostname. $host = _ZONE($zone, $host); # Fill in the forward domain ID if we can find it, otherwise: # Coerce type down to PTR or PTR template if we can't my $domid = 0; if ($type >= 65280) { if (!($domid = _hostparent($dbh, $host))) { $warnstr .= "\nRecord added as PTR instead of $typemap{$type}; domain not found for $host"; $type = $reverse_typemap{PTR}; $domid = 0; # just to be explicit. } } $sth_in->execute($domid,$host,$type,$val,$ttl); if ($typemap{$type} eq 'SOA') { my @tmp1 = split /:/, $host; my @tmp2 = split /:/, $val; _log($dbh, (rdns_id => $rdns_id, group_id => $group, entry => "[new $zone] Added SOA record [contact $tmp1[0]] [master $tmp1[1]] ". "[refresh $tmp2[0]] [retry $tmp2[1]] [expire $tmp2[2]] [minttl $tmp2[3]], TTL $ttl")); $defttl = $tmp2[3]; } else { my $logentry = "[new $zone] Added record '$host $typemap{$type}"; _log($dbh, (rdns_id => $rdns_id, domain_id => $domid, group_id => $group, entry => $logentry." $val', TTL $ttl")); } } # Generate record based on provided pattern. if ($revpatt) { my $host; my $type = ($zone->{isv6} ? 65284 : 65283); my $val = $zone->network; # Substitute $zone for ZONE in the hostname. $host = _ZONE($zone, $revpatt); my $domid = 0; if (!($domid = _hostparent($dbh, $host))) { $warnstr .= "\nDefault pattern added as PTR template instead of $typemap{$type}; domain not found for $host"; $type = 65282; $domid = 0; # just to be explicit. } $sth_in->execute($domid,$host,$type,$val,$defttl); my $logentry = "[new $zone] Added record '$host $typemap{$type}"; _log($dbh, (rdns_id => $rdns_id, domain_id => $domid, group_id => $group, entry => $logentry." $val', TTL $defttl from pattern")); } # If there are warnings (presumably about default records skipped for cause) log them _log($dbh, (rdns_id => $rdns_id, group_id => $group, entry => "Warning(s) adding $zone:$warnstr")) if $warnstr; # once we get here, we should have suceeded. $dbh->commit; }; # end eval if ($@) { my $msg = $@; eval { $dbh->rollback; }; _log($dbh, (group_id => $group, entry => "Failed adding reverse zone $zone ($msg)")) if $config{log_failures}; $dbh->commit; # since we enabled transactions earlier return ('FAIL',$msg); } else { my $retcode = 'OK'; if ($warnstr) { $resultstr = $warnstr; $retcode = 'WARN'; } return ($retcode, $rdns_id); } } # end addRDNS() ## DNSDB::getZoneCount # Get count of zones in group or groups # Takes a database handle and hash containing: # - the "current" group # - an array of "acceptable" groups # - a flag for forward/reverse zones # - Optionally accept a "starts with" and/or "contains" filter argument # Returns an integer count of the resulting zone list. sub getZoneCount { my $dbh = shift; my %args = @_; my @filterargs; $args{startwith} = undef if $args{startwith} && $args{startwith} !~ /^(?:[a-z]|0-9)$/; push @filterargs, "^$args{startwith}" if $args{startwith}; $args{filter} =~ s/\./\[\.\]/g if $args{filter}; # only match literal dots, usually in reverse zones push @filterargs, $args{filter} if $args{filter}; my $sql; # Not as compact, and fix-me-twice if the common bits get wrong, but much easier to read if ($args{revrec} eq 'n') { $sql = "SELECT count(*) FROM domains". " WHERE group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")". ($args{startwith} ? " AND domain ~* ?" : ''). ($args{filter} ? " AND domain ~* ?" : ''); } else { $sql = "SELECT count(*) FROM revzones". " WHERE group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")". ($args{startwith} ? " AND CAST(revnet AS VARCHAR) ~* ?" : ''). ($args{filter} ? " AND CAST(revnet AS VARCHAR) ~* ?" : ''); } my ($count) = $dbh->selectrow_array($sql, undef, @filterargs); return $count; } # end getZoneCount() ## DNSDB::getZoneList() # Get a list of zones in the specified group(s) # Takes the same arguments as getZoneCount() above # Returns a reference to an array of hashrefs suitable for feeding to HTML::Template sub getZoneList { my $dbh = shift; my %args = @_; my @zonelist; $args{sortorder} = 'ASC' if !grep /^$args{sortorder}$/, ('ASC','DESC'); $args{offset} = 0 if !$args{offset} || $args{offset} !~ /^(?:all|\d+)$/; my @filterargs; $args{startwith} = undef if $args{startwith} && $args{startwith} !~ /^(?:[a-z]|0-9)$/; push @filterargs, "^$args{startwith}" if $args{startwith}; $args{filter} =~ s/\./\[\.\]/g if $args{filter}; # only match literal dots, usually in reverse zones push @filterargs, $args{filter} if $args{filter}; my $sql; # Not as compact, and fix-me-twice if the common bits get wrong, but much easier to read if ($args{revrec} eq 'n') { $args{sortby} = 'domain' if !grep /^$args{sortby}$/, ('domain','group','status'); $sql = "SELECT domain_id,domain,status,groups.group_name AS group FROM domains". " INNER JOIN groups ON domains.group_id=groups.group_id". " WHERE domains.group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")". ($args{startwith} ? " AND domain ~* ?" : ''). ($args{filter} ? " AND domain ~* ?" : ''); } else { ##fixme: arguably startwith here is irrelevant. depends on the UI though. $args{sortby} = 'revnet' if !grep /^$args{sortby}$/, ('revnet','group','status'); $sql = "SELECT rdns_id,revnet,status,groups.group_name AS group FROM revzones". " INNER JOIN groups ON revzones.group_id=groups.group_id". " WHERE revzones.group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")". ($args{startwith} ? " AND CAST(revnet AS VARCHAR) ~* ?" : ''). ($args{filter} ? " AND CAST(revnet AS VARCHAR) ~* ?" : ''); } # A common tail. $sql .= " ORDER BY ".($args{sortby} eq 'group' ? 'groups.group_name' : $args{sortby})." $args{sortorder} ". ($args{offset} eq 'all' ? '' : " LIMIT $config{perpage}". " OFFSET ".$args{offset}*$config{perpage}); my $sth = $dbh->prepare($sql); $sth->execute(@filterargs); my $rownum = 0; while (my @data = $sth->fetchrow_array) { my %row; $row{domainid} = $data[0]; $row{domain} = $data[1]; $row{status} = $data[2]; $row{group} = $data[3]; push @zonelist, \%row; } return \@zonelist; } # end getZoneList() ## DNSDB::addGroup() # Add a group # Takes a database handle, group name, parent group, hashref for permissions, # and optional template-vs-cloneme flag for the default records # Returns a status code and message sub addGroup { $errstr = ''; my $dbh = shift; my $groupname = shift; my $pargroup = shift; my $permissions = shift; # 0 indicates "custom", hardcoded. # Any other value clones that group's default records, if it exists. my $inherit = shift || 0; ##fixme: need a flag to indicate clone records or ? # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; my ($group_id) = $dbh->selectrow_array("SELECT group_id FROM groups WHERE group_name=?", undef, ($groupname)); return ('FAIL', "Group already exists") if $group_id; # Wrap all the SQL in a transaction eval { $dbh->do("INSERT INTO groups (parent_group_id,group_name) VALUES (?,?)", undef, ($pargroup, $groupname) ); my ($groupid) = $dbh->selectrow_array("SELECT currval('groups_group_id_seq')"); # We work through the whole set of permissions instead of specifying them so # that when we add a new permission, we don't have to change the code anywhere # that doesn't explicitly deal with that specific permission. my @permvals; foreach (@permtypes) { if (!defined ($permissions->{$_})) { push @permvals, 0; } else { push @permvals, $permissions->{$_}; } } $dbh->do("INSERT INTO permissions (group_id,$permlist) values (?".',?'x($#permtypes+1).")", undef, ($groupid, @permvals) ); my ($permid) = $dbh->selectrow_array("SELECT currval('permissions_permission_id_seq')"); $dbh->do("UPDATE groups SET permission_id=$permid WHERE group_id=$groupid"); # Default records my $sthf = $dbh->prepare("INSERT INTO default_records (group_id,host,type,val,distance,weight,port,ttl) ". "VALUES ($groupid,?,?,?,?,?,?,?)"); my $sthr = $dbh->prepare("INSERT INTO default_rev_records (group_id,host,type,val,ttl) ". "VALUES ($groupid,?,?,?,?)"); if ($inherit) { # Duplicate records from parent. Actually relying on inherited records feels # very fragile, and it would be problematic to roll over at a later time. my $sth2 = $dbh->prepare("SELECT host,type,val,distance,weight,port,ttl FROM default_records WHERE group_id=?"); $sth2->execute($pargroup); while (my @clonedata = $sth2->fetchrow_array) { $sthf->execute(@clonedata); } # And now the reverse records $sth2 = $dbh->prepare("SELECT host,type,val,ttl FROM default_rev_records WHERE group_id=?"); $sth2->execute($pargroup); while (my @clonedata = $sth2->fetchrow_array) { $sthr->execute(@clonedata); } } else { ##fixme: Hardcoding is Bad, mmmmkaaaay? # reasonable basic defaults for SOA, MX, NS, and minimal hosting # could load from a config file, but somewhere along the line we need hardcoded bits. $sthf->execute('ns1.example.com:hostmaster.example.com', 6, '10800:3600:604800:10800', 0, 0, 0, 86400); $sthf->execute('DOMAIN', 1, '192.168.4.2', 0, 0, 0, 7200); $sthf->execute('DOMAIN', 15, 'mx.example.com', 10, 0, 0, 7200); $sthf->execute('DOMAIN', 2, 'ns1.example.com', 0, 0, 0, 7200); $sthf->execute('DOMAIN', 2, 'ns2.example.com', 0, 0, 0, 7200); $sthf->execute('www.DOMAIN', 5, 'DOMAIN', 0, 0, 0, 7200); # reasonable basic defaults for generic reverse zone. Same as initial SQL tabledef. $sthr->execute('hostmaster.ADMINDOMAIN:ns1.ADMINDOMAIN', 6, '10800:3600:604800:10800', 86400); $sthr->execute('unused-%r.ADMINDOMAIN', 65283, 'ZONE', 3600); } _log($dbh, (group_id => $pargroup, entry => "Added group $groupname") ); # once we get here, we should have suceeded. $dbh->commit; }; # end eval if ($@) { my $msg = $@; eval { $dbh->rollback; }; if ($config{log_failures}) { _log($dbh, (group_id => $pargroup, entry => "Failed to add group $groupname: $msg") ); $dbh->commit; } return ('FAIL',$msg); } return ('OK','OK'); } # end addGroup() ## DNSDB::delGroup() # Delete a group. # Takes a group ID # Returns a status code and message sub delGroup { my $dbh = shift; my $groupid = shift; # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; ##fixme: locate "knowable" error conditions and deal with them before the eval # ... or inside, whatever. # -> domains still exist in group # -> ... my $failmsg = ''; my $resultmsg = ''; # collect some pieces for logging and error messages my $groupname = groupName($dbh,$groupid); my $parid = parentID($dbh, (id => $groupid, type => 'group')); # Wrap all the SQL in a transaction eval { # Check for Things in the group $failmsg = "Can't remove group $groupname"; my ($grpcnt) = $dbh->selectrow_array("SELECT count(*) FROM groups WHERE parent_group_id=?", undef, ($groupid)); die "$grpcnt groups still in group\n" if $grpcnt; my ($domcnt) = $dbh->selectrow_array("SELECT count(*) FROM domains WHERE group_id=?", undef, ($groupid)); die "$domcnt domains still in group\n" if $domcnt; my ($usercnt) = $dbh->selectrow_array("SELECT count(*) FROM users WHERE group_id=?", undef, ($groupid)); die "$usercnt users still in group\n" if $usercnt; $failmsg = "Failed to delete default records for $groupname"; $dbh->do("DELETE from default_records WHERE group_id=?", undef, ($groupid)); $failmsg = "Failed to delete default reverse records for $groupname"; $dbh->do("DELETE from default_rev_records WHERE group_id=?", undef, ($groupid)); $failmsg = "Failed to remove group $groupname"; $dbh->do("DELETE from groups WHERE group_id=?", undef, ($groupid)); _log($dbh, (group_id => $parid, entry => "Deleted group $groupname")); $resultmsg = "Deleted group $groupname"; # once we get here, we should have suceeded. $dbh->commit; }; # end eval if ($@) { my $msg = $@; eval { $dbh->rollback; }; if ($config{log_failures}) { _log($dbh, (group_id => $parid, entry => "$failmsg: $msg")); $dbh->commit; # since we enabled transactions earlier } return ('FAIL',"$failmsg: $msg"); } return ('OK',$resultmsg); } # end delGroup() ## DNSDB::getChildren() # Get a list of all groups whose parent^n is group # Takes a database handle, group ID, reference to an array to put the group IDs in, # and an optional flag to return only immediate children or all children-of-children # default to returning all children # Calls itself sub getChildren { $errstr = ''; my $dbh = shift; my $rootgroup = shift; my $groupdest = shift; my $immed = shift || 'all'; # special break for default group; otherwise we get stuck. if ($rootgroup == 1) { # by definition, group 1 is the Root Of All Groups my $sth = $dbh->prepare("SELECT group_id FROM groups WHERE NOT (group_id=1)". ($immed ne 'all' ? " AND parent_group_id=1" : '')); $sth->execute; while (my @this = $sth->fetchrow_array) { push @$groupdest, @this; } } else { my $sth = $dbh->prepare("SELECT group_id FROM groups WHERE parent_group_id=?"); $sth->execute($rootgroup); return if $sth->rows == 0; my @grouplist; while (my ($group) = $sth->fetchrow_array) { push @$groupdest, $group; getChildren($dbh,$group,$groupdest) if $immed eq 'all'; } } } # end getChildren() ## DNSDB::groupName() # Return the group name based on a group ID # Takes a database handle and the group ID # Returns the group name or undef on failure sub groupName { $errstr = ''; my $dbh = shift; my $groupid = shift; my $sth = $dbh->prepare("SELECT group_name FROM groups WHERE group_id=?"); $sth->execute($groupid); my ($groupname) = $sth->fetchrow_array(); $errstr = $DBI::errstr if !$groupname; return $groupname if $groupname; } # end groupName ## DNSDB::getGroupCount() # Get count of subgroups in group or groups # Takes a database handle and hash containing: # - the "current" group # - an array of "acceptable" groups # - Optionally accept a "starts with" and/or "contains" filter argument # Returns an integer count of the resulting group list. sub getGroupCount { my $dbh = shift; my %args = @_; my @filterargs; $args{startwith} = undef if $args{startwith} && $args{startwith} !~ /^(?:[a-z]|0-9)$/; push @filterargs, "^$args{startwith}" if $args{startwith}; push @filterargs, $args{filter} if $args{filter}; my $sql = "SELECT count(*) FROM groups ". "WHERE parent_group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")". ($args{startwith} ? " AND group_name ~* ?" : ''). ($args{filter} ? " AND group_name ~* ?" : ''); my ($count) = $dbh->selectrow_array($sql, undef, (@filterargs) ); $errstr = $dbh->errstr if !$count; return $count; } # end getGroupCount ## DNSDB::getGroupList() # Get a list of sub^n-groups in the specified group(s) # Takes the same arguments as getGroupCount() above # Returns an arrayref containing hashrefs suitable for feeding straight to HTML::Template sub getGroupList { my $dbh = shift; my %args = @_; my @filterargs; $args{startwith} = undef if $args{startwith} && $args{startwith} !~ /^(?:[a-z]|0-9)$/; push @filterargs, "^$args{startwith}" if $args{startwith}; push @filterargs, $args{filter} if $args{filter}; # protection against bad or missing arguments $args{sortorder} = 'ASC' if !$args{sortorder}; $args{offset} = 0 if !$args{offset}; # munge sortby for columns in database $args{sortby} = 'g.group_name' if $args{sortby} eq 'group'; $args{sortby} = 'g2.group_name' if $args{sortby} eq 'parent'; my $sql = q(SELECT g.group_id AS groupid, g.group_name AS groupname, g2.group_name AS pgroup, count(distinct(u.username)) AS nusers, count(distinct(d.domain)) AS ndomains, count(distinct(r.revnet)) AS nrevzones FROM groups g INNER JOIN groups g2 ON g2.group_id=g.parent_group_id LEFT OUTER JOIN users u ON u.group_id=g.group_id LEFT OUTER JOIN domains d ON d.group_id=g.group_id LEFT OUTER JOIN revzones r ON r.group_id=g.group_id ). "WHERE g.parent_group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")". ($args{startwith} ? " AND g.group_name ~* ?" : ''). ($args{filter} ? " AND g.group_name ~* ?" : ''). " GROUP BY g.group_id, g.group_name, g2.group_name ". " ORDER BY $args{sortby} $args{sortorder} ". ($args{offset} eq 'all' ? '' : " LIMIT $config{perpage} OFFSET ".$args{offset}*$config{perpage}); my $glist = $dbh->selectall_arrayref($sql, { Slice => {} }, (@filterargs) ); $errstr = $dbh->errstr if !$glist; return $glist; } # end getGroupList ## DNSDB::groupID() # Return the group ID based on the group name # Takes a database handle and the group name # Returns the group ID or undef on failure sub groupID { $errstr = ''; my $dbh = shift; my $group = shift; my ($grpid) = $dbh->selectrow_array("SELECT group_id FROM groups WHERE group=?", undef, ($group) ); $errstr = $DBI::errstr if !$grpid; return $grpid if $grpid; } # end groupID() ## DNSDB::addUser() # Add a user. # Takes a DB handle, username, group ID, password, state (active/inactive). # Optionally accepts: # user type (user/admin) - defaults to user # permissions string - defaults to inherit from group # three valid forms: # i - Inherit permissions # c: - Clone permissions from # C: - Set these specific permissions # first name - defaults to username # last name - defaults to blank # phone - defaults to blank (could put other data within column def) # Returns (OK,) on success, (FAIL,) on failure sub addUser { $errstr = ''; my $dbh = shift; my $username = shift; my $group = shift; my $pass = shift; my $state = shift; return ('FAIL', "Missing one or more required entries") if !defined($state); return ('FAIL', "Username must not be blank") if !$username; my $type = shift || 'u'; # create limited users by default - fwiw, not sure yet how this will interact with ACLs my $permstring = shift || 'i'; # default is to inhert permissions from group my $fname = shift || $username; my $lname = shift || ''; my $phone = shift || ''; # not going format-check my $sth = $dbh->prepare("SELECT user_id FROM users WHERE username=?"); my $user_id; # quick check to start to see if we've already got one $sth->execute($username); ($user_id) = $sth->fetchrow_array; return ('FAIL', "User already exists") if $user_id; # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; # Wrap all the SQL in a transaction eval { # insert the user... note we set inherited perms by default since # it's simple and cleans up some other bits of state my $sth = $dbh->prepare("INSERT INTO users ". "(group_id,username,password,firstname,lastname,phone,type,status,permission_id,inherit_perm) ". "VALUES (?,?,?,?,?,?,?,?,(SELECT permission_id FROM permissions WHERE group_id=?),'t')"); $sth->execute($group,$username,unix_md5_crypt($pass),$fname,$lname,$phone,$type,$state,$group); # get the ID... ($user_id) = $dbh->selectrow_array("SELECT currval('users_user_id_seq')"); # Permissions! Gotta set'em all! die "Invalid permission string $permstring" if $permstring !~ /^(?: i # inherit |c:\d+ # clone # custom. no, the leading , is not a typo |C:(?:,(?:group|user|domain|record|self)_(?:edit|create|delete))* )$/x; # bleh. I'd call another function to do my dirty work, but we're in the middle of a transaction already. if ($permstring ne 'i') { # for cloned or custom permissions, we have to create a new permissions entry. my $clonesrc = $group; if ($permstring =~ /^c:(\d+)/) { $clonesrc = $1; } $dbh->do("INSERT INTO permissions ($permlist,user_id) ". "SELECT $permlist,? FROM permissions WHERE permission_id=". "(SELECT permission_id FROM permissions WHERE ".($permstring =~ /^c:/ ? 'user' : 'group')."_id=?)", undef, ($user_id,$clonesrc) ); $dbh->do("UPDATE users SET permission_id=". "(SELECT permission_id FROM permissions WHERE user_id=?) ". "WHERE user_id=?", undef, ($user_id, $user_id) ); } if ($permstring =~ /^C:/) { # finally for custom permissions, we set the passed-in permissions (and unset # any that might have been brought in by the clone operation above) my ($permid) = $dbh->selectrow_array("SELECT permission_id FROM permissions WHERE user_id=?", undef, ($user_id) ); foreach (@permtypes) { if ($permstring =~ /,$_/) { $dbh->do("UPDATE permissions SET $_='t' WHERE permission_id=?", undef, ($permid) ); } else { $dbh->do("UPDATE permissions SET $_='f' WHERE permission_id=?", undef, ($permid) ); } } } $dbh->do("UPDATE users SET inherit_perm='n' WHERE user_id=?", undef, ($user_id) ); ##fixme: add another table to hold name/email for log table? _log($dbh, (group_id => $group, entry => "Added user $username ($fname $lname)")); # once we get here, we should have suceeded. $dbh->commit; }; # end eval if ($@) { my $msg = $@; eval { $dbh->rollback; }; if ($config{log_failures}) { _log($dbh, (group_id => $group, entry => "Error adding user $username: $msg")); $dbh->commit; # since we enabled transactions earlier } return ('FAIL',"Error adding user $username: $msg"); } return ('OK',"User $username ($fname $lname) added"); } # end addUser ## DNSDB::checkUser() # Check user/pass combo on login sub checkUser { my $dbh = shift; my $user = shift; my $inpass = shift; my $sth = $dbh->prepare("SELECT user_id,group_id,password,firstname,lastname FROM users WHERE username=?"); $sth->execute($user); my ($uid,$gid,$pass,$fname,$lname) = $sth->fetchrow_array; my $loginfailed = 1 if !defined($uid); if ($pass =~ m|^\$1\$([A-Za-z0-9/.]+)\$|) { $loginfailed = 1 if $pass ne unix_md5_crypt($inpass,$1); } else { $loginfailed = 1 if $pass ne $inpass; } # nnnngggg return ($uid, $gid); } # end checkUser ## DNSDB:: updateUser() # Update general data about user sub updateUser { my $dbh = shift; ##fixme: tweak calling convention so that we can update any given bit of data my $uid = shift; my $username = shift; my $group = shift; my $pass = shift; my $state = shift; my $type = shift || 'u'; my $fname = shift || $username; my $lname = shift || ''; my $phone = shift || ''; # not going format-check my $resultmsg = ''; # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; my $sth; # Password can be left blank; if so we assume there's one on file. # Actual blank passwords are bad, mm'kay? if (!$pass) { ($pass) = $dbh->selectrow_array("SELECT password FROM users WHERE user_id=?", undef, ($uid)); } else { $pass = unix_md5_crypt($pass); } eval { $dbh->do("UPDATE users SET username=?, password=?, firstname=?, lastname=?, phone=?, type=?, status=?". " WHERE user_id=?", undef, ($username, $pass, $fname, $lname, $phone, $type, $state, $uid)); $resultmsg = "Updated user info for $username ($fname $lname)"; _log($dbh, group_id => $group, entry => $resultmsg); $dbh->commit; }; if ($@) { my $msg = $@; eval { $dbh->rollback; }; if ($config{log_failures}) { _log($dbh, (group_id => $group, entry => "Error updating user $username: $msg")); $dbh->commit; # since we enabled transactions earlier } return ('FAIL',"Error updating user $username: $msg"); } return ('OK',$resultmsg); } # end updateUser() ## DNSDB::delUser() # Delete a user. # Takes a database handle and user ID # Returns a success/failure code and matching message sub delUser { my $dbh = shift; my $userid = shift; return ('FAIL',"Bad userid") if !defined($userid); my $userdata = getUserData($dbh, $userid); # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; eval { $dbh->do("DELETE FROM users WHERE user_id=?", undef, ($userid)); _log($dbh, (group_id => $userdata->{group_id}, entry => "Deleted user ID $userid/".$userdata->{username}. " (".$userdata->{firstname}." ".$userdata->{lastname}.")") ); $dbh->commit; }; if ($@) { my $msg = $@; eval { $dbh->rollback; }; if ($config{log_failures}) { _log($dbh, (group_id => $userdata->{group_id}, entry => "Error deleting user ID ". "$userid/".$userdata->{username}.": $msg") ); $dbh->commit; } return ('FAIL',"Error deleting user $userid/".$userdata->{username}.": $msg"); } return ('OK',"Deleted user ".$userdata->{username}." (".$userdata->{firstname}." ".$userdata->{lastname}.")"); } # end delUser ## DNSDB::userFullName() # Return a pretty string! # Takes a user_id and optional printf-ish string to indicate which pieces where: # %u for the username # %f for the first name # %l for the last name # All other text in the passed string will be left as-is. ##fixme: need a "smart" option too, so that missing/null/blank first/last names don't give funky output sub userFullName { $errstr = ''; my $dbh = shift; my $userid = shift; my $fullformat = shift || '%f %l (%u)'; my $sth = $dbh->prepare("select username,firstname,lastname from users where user_id=?"); $sth->execute($userid); my ($uname,$fname,$lname) = $sth->fetchrow_array(); $errstr = $DBI::errstr if !$uname; $fullformat =~ s/\%u/$uname/g; $fullformat =~ s/\%f/$fname/g; $fullformat =~ s/\%l/$lname/g; return $fullformat; } # end userFullName ## DNSDB::userStatus() # Sets and/or returns a user's status # Takes a database handle, user ID and optionally a status argument # Returns undef on errors. sub userStatus { my $dbh = shift; my $id = shift; my $newstatus = shift || 'mu'; return undef if $id !~ /^\d+$/; my $userdata = getUserData($dbh, $id); # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; if ($newstatus ne 'mu') { # ooo, fun! let's see what we were passed for status eval { $newstatus = 0 if $newstatus eq 'useroff'; $newstatus = 1 if $newstatus eq 'useron'; $dbh->do("UPDATE users SET status=? WHERE user_id=?", undef, ($newstatus, $id)); $resultstr = ($newstatus ? 'Enabled' : 'Disabled')." user ".$userdata->{username}. " (".$userdata->{firstname}." ".$userdata->{lastname}.")"; my %loghash; $loghash{group_id} = parentID($dbh, (id => $id, type => 'user')); $loghash{entry} = $resultstr; _log($dbh, %loghash); $dbh->commit; }; if ($@) { my $msg = $@; eval { $dbh->rollback; }; $resultstr = ''; $errstr = $msg; ##fixme: failure logging? return; } } my ($status) = $dbh->selectrow_array("SELECT status FROM users WHERE user_id=?", undef, ($id)); return $status; } # end userStatus() ## DNSDB::getUserData() # Get misc user data for display sub getUserData { my $dbh = shift; my $uid = shift; my $sth = $dbh->prepare("SELECT group_id,username,firstname,lastname,phone,type,status,inherit_perm ". "FROM users WHERE user_id=?"); $sth->execute($uid); return $sth->fetchrow_hashref(); } # end getUserData() ## DNSDB::getSOA() # Return all suitable fields from an SOA record in separate elements of a hash # Takes a database handle, default/live flag, domain/reverse flag, and parent ID sub getSOA { $errstr = ''; my $dbh = shift; my $def = shift; my $rev = shift; my $id = shift; # (ab)use distance and weight columns to store SOA data? can't for default_rev_records... # - should really attach serial to the zone parent somewhere my $sql = "SELECT record_id,host,val,ttl from "._rectable($def,$rev). " WHERE "._recparent($def,$rev)." = ? AND type=$reverse_typemap{SOA}"; my $ret = $dbh->selectrow_hashref($sql, undef, ($id) ); return if !$ret; ##fixme: stick a flag somewhere if the record doesn't exist. by the API, this is an impossible case, but... ($ret->{contact},$ret->{prins}) = split /:/, $ret->{host}; delete $ret->{host}; ($ret->{refresh},$ret->{retry},$ret->{expire},$ret->{minttl}) = split /:/, $ret->{val}; delete $ret->{val}; return $ret; } # end getSOA() ## DNSDB::updateSOA() # Update the specified SOA record # Takes a database handle, default/live flag, forward/reverse flag, and SOA data hash # Returns a two-element list with a result code and message sub updateSOA { my $dbh = shift; my $defrec = shift; my $revrec = shift; my %soa = @_; my $oldsoa = getSOA($dbh, $defrec, $revrec, $soa{id}); my $msg; my %logdata; if ($defrec eq 'n') { $logdata{domain_id} = $soa{id} if $revrec eq 'n'; $logdata{rdns_id} = $soa{id} if $revrec eq 'y'; $logdata{group_id} = parentID($dbh, (id => $soa{id}, revrec => $revrec, type => ($revrec eq 'n' ? 'domain' : 'revzone') ) ); } else { $logdata{group_id} = $soa{id}; } my $parname = ($defrec eq 'y' ? groupName($dbh, $soa{id}) : ($revrec eq 'n' ? domainName($dbh, $soa{id}) : revName($dbh, $soa{id})) ); # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; eval { my $sql = "UPDATE "._rectable($defrec, $revrec)." SET host=?, val=?, ttl=? WHERE record_id=? AND type=6"; $dbh->do($sql, undef, ("$soa{contact}:$soa{prins}", "$soa{refresh}:$soa{retry}:$soa{expire}:$soa{minttl}", $soa{ttl}, $oldsoa->{record_id}) ); $msg = "Updated ".($defrec eq 'y' ? ($revrec eq 'y' ? 'default reverse ' : 'default ') : ''). "SOA for $parname: ". "(ns $oldsoa->{prins}, contact $oldsoa->{contact}, refresh $oldsoa->{refresh},". " retry $oldsoa->{retry}, expire $oldsoa->{expire}, minTTL $oldsoa->{minttl}, TTL $oldsoa->{ttl}) to ". "(ns $soa{prins}, contact $soa{contact}, refresh $soa{refresh},". " retry $soa{retry}, expire $soa{expire}, minTTL $soa{minttl}, TTL $soa{ttl})"; $logdata{entry} = $msg; _log($dbh, %logdata); $dbh->commit; }; if ($@) { $msg = $@; eval { $dbh->rollback; }; $logdata{entry} = "Error updating ".($defrec eq 'y' ? ($revrec eq 'y' ? 'default reverse zone ' : 'default ') : ''). "SOA record for $parname: $msg"; if ($config{log_failures}) { _log($dbh, %logdata); $dbh->commit; } return ('FAIL', $logdata{entry}); } else { return ('OK', $msg); } } # end updateSOA() ## DNSDB::getRecLine() # Return all data fields for a zone record in separate elements of a hash # Takes a database handle, default/live flag, forward/reverse flag, and record ID sub getRecLine { $errstr = ''; my $dbh = shift; my $defrec = shift; my $revrec = shift; my $id = shift; my $sql = "SELECT record_id,host,type,val,ttl".($revrec eq 'n' ? ',distance,weight,port' : ''). (($defrec eq 'y') ? ',group_id FROM ' : ',domain_id,rdns_id FROM '). _rectable($defrec,$revrec)." WHERE record_id=?"; my $ret = $dbh->selectrow_hashref($sql, undef, ($id) ); if ($dbh->err) { $errstr = $DBI::errstr; return undef; } if (!$ret) { $errstr = "No such record"; return undef; } # explicitly set a parent id if ($defrec eq 'y') { $ret->{parid} = $ret->{group_id}; } else { $ret->{parid} = (($revrec eq 'n') ? $ret->{domain_id} : $ret->{rdns_id}); # and a secondary if we have a custom type that lives in both a forward and reverse zone $ret->{secid} = (($revrec eq 'y') ? $ret->{domain_id} : $ret->{rdns_id}) if $ret->{type} > 65279; } return $ret; } ##fixme: should use above (getRecLine()) to get lines for below? ## DNSDB::getDomRecs() # Return records for a domain # Takes a database handle, default/live flag, group/domain ID, start, # number of records, sort field, and sort order # Returns a reference to an array of hashes sub getDomRecs { $errstr = ''; my $dbh = shift; my $def = shift; my $rev = shift; my $id = shift; my $nrecs = shift || 'all'; my $nstart = shift || 0; ## for order, need to map input to column names my $order = shift || 'host'; my $direction = shift || 'ASC'; my $filter = shift || ''; my $sql = "SELECT r.record_id,r.host,r.type,r.val,r.ttl"; $sql .= ",r.distance,r.weight,r.port" if $rev eq 'n'; $sql .= " FROM "._rectable($def,$rev)." r "; $sql .= "INNER JOIN rectypes t ON r.type=t.val "; # for sorting by type alphabetically $sql .= "WHERE "._recparent($def,$rev)." = ?"; $sql .= " AND NOT r.type=$reverse_typemap{SOA}"; $sql .= " AND host ~* ?" if $filter; # use alphaorder column for "correct" ordering of sort-by-type instead of DNS RR type number $sql .= " ORDER BY ".($order eq 'type' ? 't.alphaorder' : "r.$order")." $direction"; my @bindvars = ($id); push @bindvars, $filter if $filter; # just to be ultraparanoid about SQL injection vectors if ($nstart ne 'all') { $sql .= " LIMIT ? OFFSET ?"; push @bindvars, $nrecs; push @bindvars, ($nstart*$nrecs); } my $sth = $dbh->prepare($sql) or warn $dbh->errstr; $sth->execute(@bindvars) or warn "$sql: ".$sth->errstr; my @retbase; while (my $ref = $sth->fetchrow_hashref()) { push @retbase, $ref; } my $ret = \@retbase; return $ret; } # end getDomRecs() ## DNSDB::getRecCount() # Return count of non-SOA records in zone (or default records in a group) # Takes a database handle, default/live flag, reverse/forward flag, group/domain ID, # and optional filtering modifier # Returns the count sub getRecCount { my $dbh = shift; my $defrec = shift; my $revrec = shift; my $id = shift; my $filter = shift || ''; # keep the nasties down, since we can't ?-sub this bit. :/ # note this is chars allowed in DNS hostnames $filter =~ s/[^a-zA-Z0-9_.:-]//g; my @bindvars = ($id); push @bindvars, $filter if $filter; my $sql = "SELECT count(*) FROM ". _rectable($defrec,$revrec). " WHERE "._recparent($defrec,$revrec)."=? ". "AND NOT type=$reverse_typemap{SOA}". ($filter ? " AND host ~* ?" : ''); my ($count) = $dbh->selectrow_array($sql, undef, (@bindvars) ); return $count; } # end getRecCount() ## DNSDB::addRec() # Add a new record to a domain or a group's default records # Takes a database handle, default/live flag, group/domain ID, # host, type, value, and TTL # Some types require additional detail: "distance" for MX and SRV, # and weight/port for SRV # Returns a status code and detail message in case of error ##fixme: pass a hash with the record data, not a series of separate values sub addRec { $errstr = ''; my $dbh = shift; my $defrec = shift; my $revrec = shift; my $id = shift; # parent (group_id for defrecs, rdns_id for reverse records, # domain_id for domain records) my $host = shift; my $rectype = shift; # reference so we can coerce it if "+"-types can't find both zones my $val = shift; my $ttl = shift; # prep for validation my $addr = NetAddr::IP->new($$val); $$host =~ s/\.+$//; # FQDNs ending in . are an internal detail, and really shouldn't be exposed in the UI. my $domid = 0; my $revid = 0; my $retcode = 'OK'; # assume everything will go OK my $retmsg = ''; # do simple validation first return ('FAIL', "TTL must be numeric") unless $ttl =~ /^\d+$/; # Quick check on hostname parts. Note the regex is more forgiving than the error message; # domain names technically are case-insensitive, and we use printf-like % codes for a couple # of types. Other things may also be added to validate default records of several flavours. return ('FAIL', "Hostnames may not contain anything other than (0-9 a-z . _)") if $defrec eq 'n' && $$host !~ /^[0-9a-z_%.-]+$/i; # Collect these even if we're only doing a simple A record so we can call *any* validation sub my $dist = shift; my $weight = shift; my $port = shift; my $fields; my @vallist; # Call the validation sub for the type requested. ($retcode,$retmsg) = $validators{$$rectype}($dbh, (defrec => $defrec, revrec => $revrec, id => $id, host => $host, rectype => $rectype, val => $val, addr => $addr, dist => \$dist, port => \$port, weight => \$weight, fields => \$fields, vallist => \@vallist) ); return ($retcode,$retmsg) if $retcode eq 'FAIL'; # Set up database fields and bind parameters $fields .= "host,type,val,ttl,"._recparent($defrec,$revrec); push @vallist, ($$host,$$rectype,$$val,$ttl,$id); my $vallen = '?'.(',?'x$#vallist); # Put together the success log entry. We have to use this horrible kludge # because domain_id and rdns_id may or may not be present, and if they are, # they're not at a guaranteed consistent index in the array. wheee! my %logdata; my @ftmp = split /,/, $fields; for (my $i=0; $i <= $#vallist; $i++) { $logdata{domain_id} = $vallist[$i] if $ftmp[$i] eq 'domain_id'; $logdata{rdns_id} = $vallist[$i] if $ftmp[$i] eq 'rdns_id'; } $logdata{group_id} = $id if $defrec eq 'y'; $logdata{group_id} = parentID($dbh, (id => $id, type => ($revrec eq 'n' ? 'domain' : 'revzone'), revrec => $revrec) ) if $defrec eq 'n'; $logdata{entry} = "Added ".($defrec eq 'y' ? 'default record' : 'record')." '$$host $typemap{$$rectype} $$val"; $logdata{entry} .= " [distance $dist]" if $typemap{$$rectype} eq 'MX'; $logdata{entry} .= " [priority $dist] [weight $weight] [port $port]" if $typemap{$$rectype} eq 'SRV'; $logdata{entry} .= "', TTL $ttl"; # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; eval { $dbh->do("INSERT INTO "._rectable($defrec, $revrec)." ($fields) VALUES ($vallen)", undef, @vallist); _log($dbh, %logdata); $dbh->commit; }; if ($@) { my $msg = $@; eval { $dbh->rollback; }; if ($config{log_failures}) { $logdata{entry} = "Failed adding ".($defrec eq 'y' ? 'default ' : ''). "record '$$host $typemap{$$rectype} $$val', TTL $ttl ($msg)"; _log($dbh, %logdata); $dbh->commit; } return ('FAIL',$msg); } $resultstr = $logdata{entry}; return ($retcode, $retmsg); } # end addRec() ## DNSDB::updateRec() # Update a record # Takes a database handle, default and reverse flags, record ID, immediate parent ID, and new record data. # Returns a status code and message sub updateRec { $errstr = ''; my $dbh = shift; my $defrec = shift; my $revrec = shift; my $id = shift; my $parid = shift; # immediate parent entity that we're descending from to update the record # all records have these my $host = shift; my $hostbk = $$host; # Keep a backup copy of the original, so we can WARN if the update mangles the domain my $rectype = shift; my $val = shift; my $ttl = shift; # prep for validation my $addr = NetAddr::IP->new($$val); $$host =~ s/\.+$//; # FQDNs ending in . are an internal detail, and really shouldn't be exposed in the UI. my $domid = 0; my $revid = 0; my $retcode = 'OK'; # assume everything will go OK my $retmsg = ''; # do simple validation first return ('FAIL', "TTL must be numeric") unless $ttl =~ /^\d+$/; # Quick check on hostname parts. Note the regex is more forgiving than the error message; # domain names technically are case-insensitive, and we use printf-like % codes for a couple # of types. Other things may also be added to validate default records of several flavours. return ('FAIL', "Hostnames may not contain anything other than (0-9 a-z - . _)") if $defrec eq 'n' && $$host !~ /^[0-9a-z_%.-]+$/i; # only MX and SRV will use these my $dist = shift || 0; my $weight = shift || 0; my $port = shift || 0; my $fields; my @vallist; # get old record data so we have the right parent ID # and for logging (eventually) my $oldrec = getRecLine($dbh, $defrec, $revrec, $id); # Call the validation sub for the type requested. # Note the ID to pass here is the *parent*, not the record ($retcode,$retmsg) = $validators{$$rectype}($dbh, (defrec => $defrec, revrec => $revrec, id => ($defrec eq 'y' ? $oldrec->{group_id} : ($revrec eq 'n' ? $oldrec->{domain_id} : $oldrec->{rdns_id})), host => $host, rectype => $rectype, val => $val, addr => $addr, dist => \$dist, port => \$port, weight => \$weight, fields => \$fields, vallist => \@vallist, update => $id) ); return ($retcode,$retmsg) if $retcode eq 'FAIL'; # Set up database fields and bind parameters. Note only the optional fields # (distance, weight, port, secondary parent ID) are added in the validation call above $fields .= "host,type,val,ttl,"._recparent($defrec,$revrec); push @vallist, ($$host,$$rectype,$$val,$ttl, ($defrec eq 'y' ? $oldrec->{group_id} : ($revrec eq 'n' ? $oldrec->{domain_id} : $oldrec->{rdns_id})) ); # hack hack PTHUI # need to forcibly make sure we disassociate a record with a parent it's no longer related to. # eg, PTR records may not have a domain parent, or A/AAAA records may not have a revzone parent. # mainly needed for crossover types that got coerced down to "standard" types if ($defrec eq 'n') { if ($$rectype == $reverse_typemap{PTR}) { $fields .= ",domain_id"; push @vallist, 0; } if ($$rectype == $reverse_typemap{A} || $$rectype == $reverse_typemap{AAAA}) { $fields .= ",rdns_id"; push @vallist, 0; } } # Fiddle the field list into something suitable for updates $fields =~ s/,/=?,/g; $fields .= "=?"; # Put together the success log entry. Horrible kludge from addRec() copied as-is since # we don't know whether the passed arguments or retrieved values for domain_id and rdns_id # will be maintained (due to "not-in-zone" validation changes) my %logdata; my @ftmp = split /,/, $fields; for (my $i=0; $i <= $#vallist; $i++) { $logdata{domain_id} = $vallist[$i] if $ftmp[$i] eq 'domain_id'; $logdata{rdns_id} = $vallist[$i] if $ftmp[$i] eq 'rdns_id'; } $logdata{group_id} = $parid if $defrec eq 'y'; $logdata{group_id} = parentID($dbh, (id => $parid, type => ($revrec eq 'n' ? 'domain' : 'revzone'), revrec => $revrec) ) if $defrec eq 'n'; $logdata{entry} = "Updated ".($defrec eq 'y' ? 'default record' : 'record')." from\n". "'$oldrec->{host} $typemap{$oldrec->{type}} $oldrec->{val}"; $logdata{entry} .= " [distance $oldrec->{distance}]" if $typemap{$oldrec->{type}} eq 'MX'; $logdata{entry} .= " [priority $oldrec->{distance}] [weight $oldrec->{weight}] [port $oldrec->{port}]" if $typemap{$oldrec->{type}} eq 'SRV'; $logdata{entry} .= "', TTL $oldrec->{ttl}\nto\n'$$host $typemap{$$rectype} $$val"; $logdata{entry} .= " [distance $dist]" if $typemap{$$rectype} eq 'MX'; $logdata{entry} .= " [priority $dist] [weight $weight] [port $port]" if $typemap{$$rectype} eq 'SRV'; $logdata{entry} .= "', TTL $ttl"; local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; eval { $dbh->do("UPDATE "._rectable($defrec,$revrec)." SET $fields WHERE record_id=?", undef, (@vallist, $id) ); _log($dbh, %logdata); $dbh->commit; }; if ($@) { my $msg = $@; eval { $dbh->rollback; }; if ($config{log_failures}) { $logdata{entry} = "Failed updating ".($defrec eq 'y' ? 'default ' : ''). "record '$oldrec->{host} $typemap{$oldrec->{type}} $oldrec->{val}', TTL $oldrec->{ttl} ($msg)"; _log($dbh, %logdata); $dbh->commit; } return ('FAIL', $msg); } $resultstr = $logdata{entry}; return ($retcode, $retmsg); } # end updateRec() ## DNSDB::delRec() # Delete a record. sub delRec { $errstr = ''; my $dbh = shift; my $defrec = shift; my $revrec = shift; my $id = shift; my $oldrec = getRecLine($dbh, $defrec, $revrec, $id); # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; # Put together the log entry my %logdata; $logdata{domain_id} = $oldrec->{domain_id}; $logdata{rdns_id} = $oldrec->{rdns_id}; $logdata{group_id} = $oldrec->{group_id} if $defrec eq 'y'; $logdata{group_id} = parentID($dbh, (id => $oldrec->{domain_id}, type => ($revrec eq 'n' ? 'domain' : 'revzone'), revrec => $revrec) ) if $defrec eq 'n'; $logdata{entry} = "Deleted ".($defrec eq 'y' ? 'default record ' : 'record '). "'$oldrec->{host} $typemap{$oldrec->{type}} $oldrec->{val}"; $logdata{entry} .= " [distance $oldrec->{distance}]" if $typemap{$oldrec->{type}} eq 'MX'; $logdata{entry} .= " [priority $oldrec->{distance}] [weight $oldrec->{weight}] [port $oldrec->{port}]" if $typemap{$oldrec->{type}} eq 'SRV'; $logdata{entry} .= "', TTL $oldrec->{ttl}\n"; eval { my $sth = $dbh->do("DELETE FROM "._rectable($defrec,$revrec)." WHERE record_id=?", undef, ($id)); _log($dbh, %logdata); $dbh->commit; }; if ($@) { my $msg = $@; eval { $dbh->rollback; }; if ($config{log_failures}) { $logdata{entry} = "Error deleting ".($defrec eq 'y' ? 'default record' : 'record'). " '$oldrec->{host} $typemap{$oldrec->{type}} $oldrec->{val}', TTL $oldrec->{ttl} ($msg)"; _log($dbh, %logdata); $dbh->commit; } return ('FAIL', $msg); } return ('OK',$logdata{entry}); } # end delRec() ## DNSDB::getTypelist() # Get a list of record types for various UI dropdowns # Takes database handle, forward/reverse/lookup flag, and optional "tag as selected" indicator (defaults to A) # Returns an arrayref to list of hashrefs perfect for HTML::Template sub getTypelist { my $dbh = shift; my $recgroup = shift; my $type = shift || $reverse_typemap{A}; # also accepting $webvar{revrec}! $recgroup = 'f' if $recgroup eq 'n'; $recgroup = 'r' if $recgroup eq 'y'; my $sql = "SELECT val,name FROM rectypes WHERE "; if ($recgroup eq 'r') { # reverse zone types $sql .= "stdflag=2 OR stdflag=3"; } elsif ($recgroup eq 'l') { # DNS lookup types. Note we avoid our custom types >= 65280, since those are entirely internal. $sql .= "(stdflag=1 OR stdflag=2 OR stdflag=3) AND val < 65280"; } else { # default; forward zone types. technically $type eq 'f' but not worth the error message. $sql .= "stdflag=1 OR stdflag=2"; } $sql .= " ORDER BY listorder"; my $sth = $dbh->prepare($sql); $sth->execute; my @typelist; while (my ($rval,$rname) = $sth->fetchrow_array()) { my %row = ( recval => $rval, recname => $rname ); $row{tselect} = 1 if $rval == $type; push @typelist, \%row; } # Add SOA on lookups since it's not listed in other dropdowns. if ($recgroup eq 'l') { my %row = ( recval => $reverse_typemap{SOA}, recname => 'SOA' ); $row{tselect} = 1 if $reverse_typemap{SOA} == $type; push @typelist, \%row; } return \@typelist; } # end getTypelist() ## DNSDB::parentID() # Get ID of entity that is nearest parent to requested id # Takes a database handle and a hash of entity ID, entity type, optional parent type flag # (domain/reverse zone or group), and optional default/live and forward/reverse flags # Returns the ID or undef on failure sub parentID { my $dbh = shift; my %args = @_; # clean up the parent-type. Set it to group if not set; coerce revzone to domain for simpler logic $args{partype} = 'group' if !$args{partype}; $args{partype} = 'domain' if $args{partype} eq 'revzone'; # clean up defrec and revrec. default to live record, forward zone $args{defrec} = 'n' if !$args{defrec}; $args{revrec} = 'n' if !$args{revrec}; if ($par_type{$args{partype}} eq 'domain') { # only live records can have a domain/zone parent return unless ($args{type} eq 'record' && $args{defrec} eq 'n'); my $result = $dbh->selectrow_hashref("SELECT ".($args{revrec} eq 'n' ? 'domain_id' : 'rdns_id'). " FROM records WHERE record_id = ?", undef, ($args{id}) ) or return; return $result; } else { # snag some arguments that will either fall through or be overwritten to save some code duplication my $tmpid = $args{id}; my $type = $args{type}; if ($type eq 'record' && $args{defrec} eq 'n') { # Live records go through the records table first. ($tmpid) = $dbh->selectrow_array("SELECT ".($args{revrec} eq 'n' ? 'domain_id' : 'rdns_id'). " FROM records WHERE record_id = ?", undef, ($args{id}) ) or return; $type = ($args{revrec} eq 'n' ? 'domain' : 'revzone'); } my ($result) = $dbh->selectrow_array("SELECT $par_col{$type} FROM $par_tbl{$type} WHERE $id_col{$type} = ?", undef, ($tmpid) ); return $result; } # should be impossible to get here with even remotely sane arguments return; } # end parentID() ## DNSDB::isParent() # Returns true if $id1 is a parent of $id2, false otherwise sub isParent { my $dbh = shift; my $id1 = shift; my $type1 = shift; my $id2 = shift; my $type2 = shift; ##todo: immediate, secondary, full (default) # Return false on invalid types return 0 if !grep /^$type1$/, ('record','defrec','defrevrec','user','domain','revzone','group'); return 0 if !grep /^$type2$/, ('record','defrec','defrevrec','user','domain','revzone','group'); # Return false on impossible relations return 0 if $type1 eq 'record'; # nothing may be a child of a record return 0 if $type1 eq 'defrec'; # nothing may be a child of a record return 0 if $type1 eq 'defrevrec'; # nothing may be a child of a record return 0 if $type1 eq 'user'; # nothing may be child of a user return 0 if $type1 eq 'domain' && $type2 ne 'record'; # domain may not be a parent of anything other than a record return 0 if $type1 eq 'revzone' && $type2 ne 'record';# reverse zone may not be a parent of anything other than a record # ennnhhhh.... if we're passed an id of 0, it will never be found. usual # case would be the UI creating a new , and so we don't have an ID for # to look up yet. in that case the UI should check the parent as well. return 0 if $id1 == 0; # nothing can have a parent id of 0 return 1 if $id2 == 0; # anything could have a child id of 0 (or "unknown") # group 1 is the ultimate root parent return 1 if $type1 eq 'group' && $id1 == 1; # groups are always (a) parent of themselves return 1 if $type1 eq 'group' && $type2 eq 'group' && $id1 == $id2; my $id = $id2; my $type = $type2; my $foundparent = 0; # Records are the only entity with two possible parents. We need to split the parent checks on # domain/rdns. if ($type eq 'record') { my ($dom,$rdns) = $dbh->selectrow_array("SELECT domain_id,rdns_id FROM records WHERE record_id=?", undef, ($id)); # check immediate parent against request return 1 if $type1 eq 'domain' && $id1 == $dom; return 1 if $type1 eq 'revzone' && $id1 == $rdns; # if request is group, check *both* parents. Only check if the parent is nonzero though. return 1 if $dom && isParent($dbh, $id1, $type1, $dom, 'domain'); return 1 if $rdns && isParent($dbh, $id1, $type1, $rdns, 'revzone'); # exit here since we've executed the loop below by proxy in the above recursive calls. return 0; } # almost the same loop as getParents() above my $limiter = 0; while (1) { my $sql = "SELECT $par_col{$type} FROM $par_tbl{$type} WHERE $id_col{$type} = ?"; my $result = $dbh->selectrow_hashref($sql, undef, ($id) ); if (!$result) { $limiter++; ##fixme: how often will this happen on a live site? fail at max limiter ? warn "no results looking for $sql with id $id (depth $limiter)\n"; last; } if ($result && $result->{$par_col{$type}} == $id1) { $foundparent = 1; last; } else { ##fixme: do we care about trying to return a "no such record/domain/user/group" error? # should be impossible to create an inconsistent DB just with API calls. warn $dbh->errstr." $sql, $id" if $dbh->errstr; } # group 1 is its own parent. need this here more to break strange loops than for detecting a parent last if $result->{$par_col{$type}} == 1; $id = $result->{$par_col{$type}}; $type = $par_type{$type}; } return $foundparent; } # end isParent() ## DNSDB::zoneStatus() # Returns and optionally sets a zone's status # Takes a database handle, domain/revzone ID, forward/reverse flag, and optionally a status argument # Returns status, or undef on errors. sub zoneStatus { my $dbh = shift; my $id = shift; my $revrec = shift; my $newstatus = shift || 'mu'; return undef if $id !~ /^\d+$/; # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; if ($newstatus ne 'mu') { # ooo, fun! let's see what we were passed for status eval { $newstatus = 0 if $newstatus eq 'domoff'; $newstatus = 1 if $newstatus eq 'domon'; $dbh->do("UPDATE ".($revrec eq 'n' ? 'domains' : 'revzones')." SET status=? WHERE ". ($revrec eq 'n' ? 'domain_id' : 'rdns_id')."=?", undef, ($newstatus,$id) ); ##fixme switch to more consise "Enabled " as with users? $resultstr = "Changed ".($revrec eq 'n' ? domainName($dbh, $id) : revName($dbh, $id)). " state to ".($newstatus ? 'active' : 'inactive'); my %loghash; $loghash{domain_id} = $id if $revrec eq 'n'; $loghash{rdns_id} = $id if $revrec eq 'y'; $loghash{group_id} = parentID($dbh, (id => $id, type => ($revrec eq 'n' ? 'domain' : 'revzone'), revrec => $revrec) ); $loghash{entry} = $resultstr; _log($dbh, %loghash); $dbh->commit; }; if ($@) { my $msg = $@; eval { $dbh->rollback; }; $resultstr = ''; $errstr = $msg; return; } } my ($status) = $dbh->selectrow_array("SELECT status FROM ". ($revrec eq 'n' ? "domains WHERE domain_id=?" : "revzones WHERE rdns_id=?"), undef, ($id) ); return $status; } # end zoneStatus() ## DNSDB::importAXFR # Import a domain via AXFR # Takes AXFR host, domain to transfer, group to put the domain in, # and optionally: # - active/inactive state flag (defaults to active) # - overwrite-SOA flag (defaults to off) # - overwrite-NS flag (defaults to off, doesn't affect subdomain NS records) # Returns a status code (OK, WARN, or FAIL) and message - message should be blank # if status is OK, but WARN includes conditions that are not fatal but should # really be reported. sub importAXFR { my $dbh = shift; my $ifrom_in = shift; my $zone = shift; my $group = shift; my $status = shift || 1; my $rwsoa = shift || 0; my $rwns = shift || 0; my $merge = shift || 0; # do we attempt to merge A/AAAA and PTR records whenever possible? # do we overload this with the fixme below? ##fixme: add mode to delete&replace, merge+overwrite, merge new? my $nrecs = 0; my $soaflag = 0; my $nsflag = 0; my $warnmsg = ''; my $ifrom; my $rev = 'n'; my $code = 'OK'; my $msg = 'foobar?'; # choke on possible bad setting in ifrom # IPv4 and v6, and valid hostnames! ($ifrom) = ($ifrom_in =~ /^([0-9a-f\:.]+|[0-9a-z_.-]+)$/i); return ('FAIL', "Bad AXFR source host $ifrom") unless ($ifrom) = ($ifrom_in =~ /^([0-9a-f\:.]+|[0-9a-z_.-]+)$/i); my $errmsg; my $zone_id; my $domain_id = 0; my $rdns_id = 0; my $cidr; # magic happens! detect if we're importing a domain or a reverse zone # while we're at it, figure out what the CIDR netblock is (if we got a .arpa) # or what the formal .arpa zone is (if we got a CIDR netblock) # Handles sub-octet v4 zones in the format specified in the Cricket Book, 2nd Ed, p217-218 if ($zone =~ m{(?:\.arpa\.?|/\d+)$}) { # we seem to have a reverse zone $rev = 'y'; if ($zone =~ /\.arpa\.?$/) { # we have a formal reverse zone. call _zone2cidr and get the CIDR block. ($code,$msg) = _zone2cidr($zone); return ($code, $msg) if $code eq 'FAIL'; $cidr = $msg; } elsif ($zone =~ m|^[\d.]+/\d+$|) { # v4 revzone, CIDR netblock $cidr = NetAddr::IP->new($zone) or return ('FAIL',"$zone is not a valid CIDR block"); $zone = _ZONE($cidr, 'ZONE.in-addr.arpa', 'r', '.'); } elsif ($zone =~ m|^[a-fA-F\d:]+/\d+$|) { # v6 revzone, CIDR netblock $cidr = NetAddr::IP->new($zone) or return ('FAIL',"$zone is not a valid CIDR block"); return ('FAIL', "$zone is not a nibble-aligned block") if $cidr->masklen % 4 != 0; $zone = _ZONE($cidr, 'ZONE.ip6.arpa', 'r', '.'); } else { # there is. no. else! return ('FAIL', "Unknown zone name format"); } # quick check to start to see if we've already got one ($zone_id) = $dbh->selectrow_array("SELECT rdns_id FROM revzones WHERE revnet=?", undef, ("$cidr")); $rdns_id = $zone_id; } else { # default to domain ($zone_id) = $dbh->selectrow_array("SELECT domain_id FROM domains WHERE domain=?", undef, ($zone)); $domain_id = $zone_id; } return ('FAIL', ($rev eq 'n' ? 'Domain' : 'Reverse zone')." already exists") if $zone_id; # little local utility sub to swap $val and $host for revzone records. sub _revswap { my $rechost = shift; my $recdata = shift; if ($rechost =~ /\.in-addr\.arpa\.?$/) { $rechost =~ s/\.in-addr\.arpa\.?$//; $rechost = join '.', reverse split /\./, $rechost; } else { $rechost =~ s/\.ip6\.arpa\.?$//; my @nibs = reverse split /\./, $rechost; $rechost = ''; my $nc; foreach (@nibs) { $rechost.= $_; $rechost .= ":" if ++$nc % 4 == 0 && $nc < 32; } $rechost .= ":" if $nc < 32 && $rechost !~ /\*$/; # close netblock records? ##fixme: there's a case that ends up with a partial entry here: # ip:add:re:ss:: # can't reproduce after letting it sit overnight after discovery. :( #print "$rechost\n"; # canonicalize with NetAddr::IP $rechost = NetAddr::IP->new($rechost)->addr unless $rechost =~ /\*$/; } return ($recdata,$rechost) } # Allow transactions, and raise an exception on errors so we can catch it later. # Use local to make sure these get "reset" properly on exiting this block local $dbh->{AutoCommit} = 0; local $dbh->{RaiseError} = 1; my $sth; eval { if ($rev eq 'n') { ##fixme: serial $dbh->do("INSERT INTO domains (domain,group_id,status) VALUES (?,?,?)", undef, ($zone,$group,$status) ); # get domain id so we can do the records ($zone_id) = $dbh->selectrow_array("SELECT currval('domains_domain_id_seq')"); $domain_id = $zone_id; _log($dbh, (group_id => $group, domain_id => $domain_id, entry => "[Added ".($status ? 'active' : 'inactive')." domain $zone via AXFR]") ); } else { ##fixme: serial $dbh->do("INSERT INTO revzones (revnet,group_id,status) VALUES (?,?,?)", undef, ($cidr,$group,$status) ); # get revzone id so we can do the records ($zone_id) = $dbh->selectrow_array("SELECT currval('revzones_rdns_id_seq')"); $rdns_id = $zone_id; _log($dbh, (group_id => $group, rdns_id => $rdns_id, entry => "[Added ".($status ? 'active' : 'inactive')." reverse zone $cidr via AXFR]") ); } ## bizarre DBI<->Net::DNS interaction bug: ## sometimes a zone will cause an immediate commit-and-exit (sort of) of the while() ## fixed, apparently I was doing *something* odd, but not certain what it was that ## caused a commit instead of barfing my $res = Net::DNS::Resolver->new; $res->nameservers($ifrom); $res->axfr_start($zone) or die "Couldn't begin AXFR\n"; $sth = $dbh->prepare("INSERT INTO records (domain_id,rdns_id,host,type,val,distance,weight,port,ttl)". " VALUES (?,?,?,?,?,?,?,?,?)"); # Stash info about sub-octet v4 revzones here so we don't have # to store the CNAMEs used to delegate a suboctet zone # $suboct{zone}{ns}[] -> array of nameservers # $suboct{zone}{cname}[] -> array of extant CNAMEs (Just In Case someone did something bizarre) ## commented pending actual use of this data. for now, we'll just ## auto-(re)create the CNAMEs in revzones on export # my %suboct; while (my $rr = $res->axfr_next()) { my $val; my $distance = 0; my $weight = 0; my $port = 0; my $logfrag = ''; my $type = $rr->type; my $host = $rr->name; my $ttl = $rr->ttl; $soaflag = 1 if $type eq 'SOA'; $nsflag = 1 if $type eq 'NS'; # "Primary" types: # A, NS, CNAME, SOA, PTR(warn in forward), MX, TXT, AAAA, SRV, A6(ob), SPF # maybe KEY # BIND supports: # [standard] # A AAAA CNAME MX NS PTR SOA TXT # [variously experimental, obsolete, or obscure] # HINFO MB(ex) MD(ob) MF(ob) MG(ex) MINFO(ex) MR(ex) NULL WKS AFSDB(ex) ISDN(ex) RP(ex) RT(ex) X25(ex) PX # ... if one can ever find the right magic to format them correctly # Net::DNS supports: # RRSIG SIG NSAP NS NIMLOC NAPTR MX MR MINFO MG MB LOC ISDN IPSECKEY HINFO # EID DNAME CNAME CERT APL AFSDB AAAA A DS NXT NSEC3PARAM NSEC3 NSEC KEY # DNSKEY DLV X25 TXT TSIG TKEY SSHFP SRV SPF SOA RT RP PX PTR NULL APL::AplItem # nasty big ugly case-like thing here, since we have to do *some* different # processing depending on the record. le sigh. ##fixme: what record types other than TXT can/will have >255-byte payloads? if ($type eq 'A') { $val = $rr->address; } elsif ($type eq 'NS') { # hmm. should we warn here if subdomain NS'es are left alone? next if ($rwns && ($rr->name eq $zone)); if ($rev eq 'y') { # revzones have records more or less reversed from forward zones. my ($tmpcode,$tmpmsg) = _zone2cidr($host); die "Error converting NS record: $tmpmsg" if $tmpcode eq 'FAIL'; # hmm. may not make sense... $val = "$tmpmsg"; $host = $rr->nsdname; $logfrag = "Added record '$val $type $host', TTL $ttl"; # Tag and preserve. For now this is commented for a no-op, but we have Ideas for # another custom storage type ("DELEGATE") that will use these subzone-delegation records #if ($val ne "$cidr") { # push @{$suboct{$val}{ns}}, $host; #} } else { $val = $rr->nsdname; } $nsflag = 1; } elsif ($type eq 'CNAME') { if ($rev eq 'y') { # hmm. do we even want to bother with storing these at this level? Sub-octet delegation # by CNAME is essentially a record-publication hack, and we want to just represent the # "true" logical intentions as far down the stack as we can from the UI. ($host,$val) = _revswap($host,$rr->cname); $logfrag = "Added record '$val $type $host', TTL $ttl"; # Tag and preserve in case we want to commit them as-is later, but mostly we don't care. # Commented pending actually doing something with possibly new type DELEGATE #my $tmprev = $host; #$tmprev =~ s/^\d+\.//; #($code,$tmprev) = _zone2cidr($tmprev); #push @{$suboct{"$tmprev"}{cname}}, $val; # Silently skip CNAMEs in revzones. next; } else { $val = $rr->cname; } } elsif ($type eq 'SOA') { next if $rwsoa; $host = $rr->rname.":".$rr->mname; $val = $rr->refresh.":".$rr->retry.":".$rr->expire.":".$rr->minimum; $soaflag = 1; } elsif ($type eq 'PTR') { ($host,$val) = _revswap($host,$rr->ptrdname); $logfrag = "Added record '$val $type $host', TTL $ttl"; # hmm. PTR records should not be in forward zones. } elsif ($type eq 'MX') { $val = $rr->exchange; $distance = $rr->preference; } elsif ($type eq 'TXT') { ##fixme: Net::DNS docs say this should be deprecated for rdatastr() or char_str_list(), ## but don't really seem enthusiastic about it. #print "should use rdatastr:\n\t".$rr->rdatastr."\n or char_str_list:\n\t".join(' ',$rr->char_str_list())."\n"; # rdatastr returns a BIND-targetted logical string, including opening and closing quotes # char_str_list returns a list of the individual string fragments in the record # txtdata returns the more useful all-in-one form (since we want to push such protocol # details as far down the stack as we can) # NB: this may turn out to be more troublesome if we ever have need of >512-byte TXT records. if ($rev eq 'y') { ($host,$val) = _revswap($host,$rr->txtdata); $logfrag = "Added record '$val $type $host', TTL $ttl"; } else { $val = $rr->txtdata; } } elsif ($type eq 'SPF') { ##fixme: and the same caveat here, since it is apparently a clone of ::TXT $val = $rr->txtdata; } elsif ($type eq 'AAAA') { $val = $rr->address; } elsif ($type eq 'SRV') { $val = $rr->target; $distance = $rr->priority; $weight = $rr->weight; $port = $rr->port; } elsif ($type eq 'KEY') { # we don't actually know what to do with these... $val = $rr->flags.":".$rr->protocol.":".$rr->algorithm.":".$rr->key.":".$rr->keytag.":".$rr->privatekeyname; } else { $val = $rr->rdatastr; # Finding a different record type is not fatal.... just problematic. # We may not be able to export it correctly. $warnmsg .= "Unusual record ".$rr->name." ($type) found\n"; } my $logentry = "[AXFR ".($rev eq 'n' ? $zone : $cidr)."] "; if ($merge) { if ($rev eq 'n') { # importing a domain; we have A and AAAA records that could be merged with matching PTR records my $etype; my ($erdns,$erid,$ettl) = $dbh->selectrow_array("SELECT rdns_id,record_id,ttl FROM records ". "WHERE host=? AND val=? AND type=12", undef, ($host, $val) ); if ($erid) { if ($type eq 'A') { # PTR -> A+PTR $etype = 65280; $logentry .= "Merged A record with existing PTR record '$host A+PTR $val', TTL $ettl"; } if ($type eq 'AAAA') { # PTR -> AAAA+PTR $etype = 65281; $logentry .= "Merged AAAA record with existing PTR record '$host AAAA+PTR $val', TTL $ettl"; } $ettl = ($ettl < $ttl ? $ettl : $ttl); # use lower TTL $dbh->do("UPDATE records SET domain_id=?,ttl=?,type=? WHERE record_id=?", undef, ($domain_id, $ettl, $etype, $erid)); $nrecs++; _log($dbh, (group_id => $group, domain_id => $domain_id, rdns_id => $erdns, entry => $logentry) ); next; # while axfr_next } } # $rev eq 'n' else { # importing a revzone, we have PTR records that could be merged with matching A/AAAA records my ($domid,$erid,$ettl,$etype) = $dbh->selectrow_array("SELECT domain_id,record_id,ttl,type FROM records ". "WHERE host=? AND val=? AND (type=1 OR type=28)", undef, ($host, $val) ); if ($erid) { if ($etype == 1) { # A -> A+PTR $etype = 65280; $logentry .= "Merged PTR record with existing matching A record '$host A+PTR $val', TTL $ettl"; } if ($etype == 28) { # AAAA -> AAAA+PTR $etype = 65281; $logentry .= "Merged PTR record with existing matching AAAA record '$host AAAA+PTR $val', TTL $ettl"; } $ettl = ($ettl < $ttl ? $ettl : $ttl); # use lower TTL $dbh->do("UPDATE records SET rdns_id=?,ttl=?,type=? WHERE record_id=?", undef, ($rdns_id, $ettl, $etype, $erid)); $nrecs++; _log($dbh, (group_id => $group, domain_id => $domid, rdns_id => $rdns_id, entry => $logentry) ); next; # while axfr_next } } # $rev eq 'y' } # if $merge # Insert the new record $sth->execute($domain_id, $rdns_id, $host, $reverse_typemap{$type}, $val, $distance, $weight, $port, $ttl); $nrecs++; if ($type eq 'SOA') { # also !$rwsoa, but if that's set, it should be impossible to get here. my @tmp1 = split /:/, $host; my @tmp2 = split /:/, $val; $logentry .= "Added SOA record [contact $tmp1[0]] [master $tmp1[1]] ". "[refresh $tmp2[0]] [retry $tmp2[1]] [expire $tmp2[2]] [minttl $tmp2[3]], TTL $ttl"; } elsif ($logfrag) { # special case for log entries we need to meddle with a little. $logentry .= $logfrag; } else { $logentry .= "Added record '$host $type"; $logentry .= " [distance $distance]" if $type eq 'MX'; $logentry .= " [priority $distance] [weight $weight] [port $port]" if $type eq 'SRV'; $logentry .= " $val', TTL $ttl"; } _log($dbh, (group_id => $group, domain_id => $domain_id, rdns_id => $rdns_id, entry => $logentry) ); } # while axfr_next # Detect and handle delegated subzones # Placeholder for when we decide what to actually do with this, see previous comments in NS and CNAME handling. #foreach (keys %suboct) { # print "found ".($suboct{$_}{ns} ? @{$suboct{$_}{ns}} : '0')." NS records and ". # ($suboct{$_}{cname} ? @{$suboct{$_}{cname}} : '0')." CNAMEs for $_\n"; #} # Overwrite SOA record if ($rwsoa) { $soaflag = 1; my $sthgetsoa = $dbh->prepare("SELECT host,val,ttl FROM default_records WHERE group_id=? AND type=?"); my $sthputsoa = $dbh->prepare("INSERT INTO records (domain_id,host,type,val,ttl) VALUES (?,?,?,?,?)"); $sthgetsoa->execute($group,$reverse_typemap{SOA}); while (my ($host,$val,$ttl) = $sthgetsoa->fetchrow_array()) { $host =~ s/DOMAIN/$zone/g; $val =~ s/DOMAIN/$zone/g; $sthputsoa->execute($zone_id,$host,$reverse_typemap{SOA},$val,$ttl); } } # Overwrite NS records if ($rwns) { $nsflag = 1; my $sthgetns = $dbh->prepare("SELECT host,val,ttl FROM default_records WHERE group_id=? AND type=?"); my $sthputns = $dbh->prepare("INSERT INTO records (domain_id,host,type,val,ttl) VALUES (?,?,?,?,?)"); $sthgetns->execute($group,$reverse_typemap{NS}); while (my ($host,$val,$ttl) = $sthgetns->fetchrow_array()) { $host =~ s/DOMAIN/$zone/g; $val =~ s/DOMAIN/$zone/g; $sthputns->execute($zone_id,$host,$reverse_typemap{NS},$val,$ttl); } } die "No records found; either $ifrom is not authoritative or doesn't allow transfers\n" if !$nrecs; die "Bad zone: No SOA record!\n" if !$soaflag; die "Bad zone: No NS records!\n" if !$nsflag; $dbh->commit; }; if ($@) { my $msg = $@; eval { $dbh->rollback; }; return ('FAIL',$msg." $warnmsg"); } else { return ('WARN', $warnmsg) if $warnmsg; return ('OK',"Imported OK"); } # it should be impossible to get here. return ('WARN',"OOOK!"); } # end importAXFR() ## DNSDB::importBIND() sub importBIND { } # end importBIND() ## DNSDB::import_tinydns() sub import_tinydns { } # end import_tinydns() ## DNSDB::export() # Export the DNS database, or a part of it # Takes database handle, export type, optional arguments depending on type # Writes zone data to targets as appropriate for type sub export { my $dbh = shift; my $target = shift; if ($target eq 'tiny') { __export_tiny($dbh,@_); } # elsif ($target eq 'foo') { # __export_foo($dbh,@_); #} # etc } # end export() ## DNSDB::__export_tiny # Internal sub to implement tinyDNS (compatible) export # Takes database handle, filehandle to write export to, optional argument(s) # to determine which data gets exported sub __export_tiny { my $dbh = shift; my $datafile = shift; ##fixme: slurp up further options to specify particular zone(s) to export ## Convert a bare number into an octal-coded pair of octets. # Take optional arg to indicate a decimal or hex input. Defaults to hex. sub octalize { my $tmp = shift; my $srctype = shift || 'h'; # default assumes hex string $tmp = sprintf "%0.4x", hex($tmp) if $srctype eq 'h'; # 0-pad hex to 4 digits $tmp = sprintf "%0.4x", $tmp if $srctype eq 'd'; # 0-pad decimal to 4 hex digits my @o = ($tmp =~ /^(..)(..)$/); # split into octets return sprintf "\\%0.3o\\%0.3o", hex($o[0]), hex($o[1]);; } ##fixme: fail if $datafile isn't an open, writable file # easy case - export all evarything # not-so-easy case - export item(s) specified # todo: figure out what kind of list we use to export items my $domsth = $dbh->prepare("SELECT domain_id,domain,status FROM domains WHERE status=1"); my $recsth = $dbh->prepare("SELECT host,type,val,distance,weight,port,ttl ". "FROM records WHERE domain_id=?"); $domsth->execute(); while (my ($domid,$dom,$domstat) = $domsth->fetchrow_array) { $recsth->execute($domid); while (my ($host,$type,$val,$dist,$weight,$port,$ttl) = $recsth->fetchrow_array) { ##fixme: need to store location in the db, and retrieve it here. # temporarily hardcoded to empty so we can include it further down. my $loc = ''; ##fixme: record validity timestamp. tinydns supports fiddling with timestamps. # note $ttl must be set to 0 if we want to use tinydns's auto-expiring timestamps. # timestamps are TAI64 # ~~ 2^62 + time() my $stamp = ''; # raw packet in unknown format: first byte indicates length # of remaining data, allows up to 255 raw bytes ##fixme? append . to all host/val hostnames if ($typemap{$type} eq 'SOA') { # host contains pri-ns:responsible # val is abused to contain refresh:retry:expire:minttl ##fixme: "manual" serial vs tinydns-autoserial # let's be explicit about abusing $host and $val my ($email, $primary) = (split /:/, $host)[0,1]; my ($refresh, $retry, $expire, $min_ttl) = (split /:/, $val)[0,1,2,3]; print $datafile "Z$dom:$primary:$email"."::$refresh:$retry:$expire:$min_ttl:$ttl:$stamp:$loc\n"; } elsif ($typemap{$type} eq 'A') { print $datafile "+$host:$val:$ttl:$stamp:$loc\n"; } elsif ($typemap{$type} eq 'NS') { print $datafile "\&$host"."::$val:$ttl:$stamp:$loc\n"; } elsif ($typemap{$type} eq 'AAAA') { print $datafile ":$host:28:"; my $altgrp = 0; my @altconv; # Split in to up to 8 groups of hex digits (allows for IPv6 :: 0-collapsing) foreach (split /:/, $val) { if (/^$/) { # flag blank entry; this is a series of 0's of (currently) unknown length $altconv[$altgrp++] = 's'; } else { # call sub to convert 1-4 hex digits to 2 string-rep octal bytes $altconv[$altgrp++] = octalize($_) } } foreach my $octet (@altconv) { # if not 's', output print $datafile $octet unless $octet =~ /^s$/; # if 's', output (9-array length)x literal '\000\000' print $datafile '\000\000'x(9-$altgrp) if $octet =~ /^s$/; } print $datafile ":$ttl:$stamp:$loc\n"; } elsif ($typemap{$type} eq 'MX') { print $datafile "\@$host"."::$val:$dist:$ttl:$stamp:$loc\n"; } elsif ($typemap{$type} eq 'TXT') { ##fixme: split v-e-r-y long TXT strings? will need to do so for BIND export, at least $val =~ s/:/\\072/g; # may need to replace other symbols print $datafile "'$host:$val:$ttl:$stamp:$loc\n"; # by-hand TXT #:deepnet.cx:16:2v\075spf1\040a\040a\072bacon.deepnet.cx\040a\072home.deepnet.cx\040-all:3600 #@ IN TXT "v=spf1 a a:bacon.deepnet.cx a:home.deepnet.cx -all" #'deepnet.cx:v=spf1 a a\072bacon.deepnet.cx a\072home.deepnet.cx -all:3600 #txttest IN TXT "v=foo bar:bob kn;ob' \" !@#$%^&*()-=_+[]{}<>?" #:txttest.deepnet.cx:16:\054v\075foo\040bar\072bob\040kn\073ob\047\040\042\040\041\100\043\044\045\136\046\052\050\051-\075\137\053\133\135\173\175\074\076\077:3600 # very long TXT record as brought in by axfr-get # note tinydns does not support >512-byte RR data, need axfr-dns (for TCP support) for that # also note, tinydns does not seem to support <512, >256-byte RRdata from axfr-get either. :/ #:longtxt.deepnet.cx:16: #\170this is a very long txt record. it is really long. long. very long. really very long. this is a very long txt record. #\263 it is really long. long. very long. really very long. this is a very long txt record. it is really long. long. very long. really very long. this is a very long txt record. #\351 it is really long. long. very long. really very long.this is a very long txt record. it is really long. long. very long. really very long. this is a very long txt record. it is really long. long. very long. really very long. #:3600 } elsif ($typemap{$type} eq 'CNAME') { print $datafile "C$host:$val:$ttl:$stamp:$loc\n"; } elsif ($typemap{$type} eq 'SRV') { # data is two-byte values for priority, weight, port, in that order, # followed by length/string data print $datafile ":$host:33:".octalize($dist,'d').octalize($weight,'d').octalize($port,'d'); $val .= '.' if $val !~ /\.$/; foreach (split /\./, $val) { printf $datafile "\\%0.3o%s", length($_), $_; } print $datafile "\\000:$ttl:$stamp:$loc\n"; } elsif ($typemap{$type} eq 'RP') { # RP consists of two mostly free-form strings. # The first is supposed to be an email address with @ replaced by . (as with the SOA contact) # The second is the "hostname" of a TXT record with more info. print $datafile ":$host:17:"; my ($who,$what) = split /\s/, $val; foreach (split /\./, $who) { printf $datafile "\\%0.3o%s", length($_), $_; } print $datafile '\000'; foreach (split /\./, $what) { printf $datafile "\\%0.3o%s", length($_), $_; } print $datafile "\\000:$ttl:$stamp:$loc\n"; } elsif ($typemap{$type} eq 'PTR') { # must handle both IPv4 and IPv6 ##work # data should already be in suitable reverse order. print $datafile "^$host:$val:$ttl:$stamp:$loc\n"; } else { # raw record. we don't know what's in here, so we ASS-U-ME the user has # put it in correctly, since either the user is messing directly with the # database, or the record was imported via AXFR # # convert anything not a-zA-Z0-9.- to octal coding ##fixme: add flag to export "unknown" record types - note we'll probably end up # mangling them since they were written to the DB from Net::DNS::RR::->rdatastr. #print $datafile ":$host:$type:$val:$ttl:$stamp:$loc\n"; } # record type if-else } # while ($recsth) } # while ($domsth) } # end __export_tiny() ## DNSDB::mailNotify() # Sends notification mail to recipients regarding a DNSDB operation sub mailNotify { my $dbh = shift; my ($subj,$message) = @_; return if $config{mailhost} eq 'smtp.example.com'; # do nothing if still using default SMTP host. my $mailer = Net::SMTP->new($config{mailhost}, Hello => "dnsadmin.$config{domain}"); my $mailsender = ($config{mailsender} ? $config{mailsender} : $config{mailnotify}); $mailer->mail($mailsender); $mailer->to($config{mailnotify}); $mailer->data("From: \"$config{mailname}\" <$mailsender>\n", "To: <$config{mailnotify}>\n", "Date: ".strftime("%a, %d %b %Y %H:%M:%S %z",localtime)."\n", "Subject: $subj\n", "X-Mailer: DNSAdmin Notify v".sprintf("%.1d",$DNSDB::VERSION)."\n", "Organization: $config{orgname}\n", "\n$message\n"); $mailer->quit; } # shut Perl up 1;