source: trunk/DNSDB.pm@ 260

Last change on this file since 260 was 260, checked in by Kris Deugau, 13 years ago

/trunk

First pass adding add-reverse-zone.

  • add newrdns/addrdns templates
  • add handling in dns.cgi for pages, copy-paste-modify'ed from add-domain
  • add addRDNS() in DNSDB.pm, copy-paste-modify'ed from addDomain()

addRDNS() still needs extension at the ##work to properly substitute
ZONE in hostname and value fields as well as pick and choose default
records (ie, skip A+PTR in v6 zones, and skip AAAA+PTR in v4 zones)
See #26

  • Property svn:keywords set to Date Rev Author Id
File size: 96.5 KB
Line 
1# dns/trunk/DNSDB.pm
2# Abstraction functions for DNS administration
3###
4# SVN revision info
5# $Date: 2012-03-02 22:51:29 +0000 (Fri, 02 Mar 2012) $
6# SVN revision $Rev: 260 $
7# Last update by $Author: kdeugau $
8###
9# Copyright (C) 2008-2011 - Kris Deugau <kdeugau@deepnet.cx>
10
11package DNSDB;
12
13use strict;
14use warnings;
15use Exporter;
16use DBI;
17use Net::DNS;
18use Crypt::PasswdMD5;
19use Net::SMTP;
20use NetAddr::IP qw(:lower);
21use POSIX;
22use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS);
23
24$VERSION = 0.1; ##VERSION##
25@ISA = qw(Exporter);
26@EXPORT_OK = qw(
27 &initGlobals
28 &initPermissions &getPermissions &changePermissions &comparePermissions
29 &changeGroup
30 &loadConfig &connectDB &finish
31 &addDomain &delDomain &domainName &revName &domainID &addRDNS
32 &getZoneCount &getZoneList
33 &addGroup &delGroup &getChildren &groupName
34 &addUser &updateUser &delUser &userFullName &userStatus &getUserData
35 &getSOA &getRecLine &getDomRecs &getRecCount
36 &addRec &updateRec &delRec
37 &getTypelist
38 &parentID
39 &isParent
40 &domStatus &importAXFR
41 &export
42 &mailNotify
43 %typemap %reverse_typemap %config
44 %permissions @permtypes $permlist
45 );
46
47@EXPORT = (); # Export nothing by default.
48%EXPORT_TAGS = ( ALL => [qw(
49 &initGlobals
50 &initPermissions &getPermissions &changePermissions &comparePermissions
51 &changeGroup
52 &loadConfig &connectDB &finish
53 &addDomain &delDomain &domainName &revName &domainID &addRDNS
54 &getZoneCount &getZoneList
55 &addGroup &delGroup &getChildren &groupName
56 &addUser &updateUser &delUser &userFullName &userStatus &getUserData
57 &getSOA &getRecLine &getDomRecs &getRecCount
58 &addRec &updateRec &delRec
59 &getTypelist
60 &parentID
61 &isParent
62 &domStatus &importAXFR
63 &export
64 &mailNotify
65 %typemap %reverse_typemap %config
66 %permissions @permtypes $permlist
67 )]
68 );
69
70our $group = 1;
71our $errstr = '';
72
73# Halfway sane defaults for SOA, TTL, etc.
74# serial defaults to 0 for convenience.
75# value will be either YYYYMMDDNN for BIND/etc, or auto-internal for tinydns
76our %def = qw (
77 contact hostmaster.DOMAIN
78 prins ns1.myserver.com
79 serial 0
80 soattl 86400
81 refresh 10800
82 retry 3600
83 expire 604800
84 minttl 10800
85 ttl 10800
86);
87
88# Arguably defined wholly in the db, but little reason to change without supporting code changes
89our @permtypes = qw (
90 group_edit group_create group_delete
91 user_edit user_create user_delete
92 domain_edit domain_create domain_delete
93 record_edit record_create record_delete
94 self_edit admin
95);
96our $permlist = join(',',@permtypes);
97
98# DNS record type map and reverse map.
99# loaded from the database, from http://www.iana.org/assignments/dns-parameters
100our %typemap;
101our %reverse_typemap;
102
103our %permissions;
104
105# Prepopulate a basic config. Note some of these *will* cause errors if left unset.
106# note: add appropriate stanzas in loadConfig to parse these
107our %config = (
108 # Database connection info
109 dbname => 'dnsdb',
110 dbuser => 'dnsdb',
111 dbpass => 'secret',
112 dbhost => '',
113
114 # Email notice settings
115 mailhost => 'smtp.example.com',
116 mailnotify => 'dnsdb@example.com', # to
117 mailsender => 'dnsdb@example.com', # from
118 mailname => 'DNS Administration',
119 orgname => 'Example Corp',
120 domain => 'example.com',
121
122 # Template directory
123 templatedir => 'templates/',
124# fmeh. this is a real web path, not a logical internal one. hm..
125# cssdir => 'templates/',
126 sessiondir => 'session/',
127
128 # Session params
129 timeout => '3600', # 1 hour default
130
131 # Other miscellanea
132 log_failures => 1, # log all evarthing by default
133 perpage => 15,
134 );
135
136## (Semi)private variables
137# Hash of functions for validating record types. Filled in initGlobals() since
138# it relies on visibility flags from the rectypes table in the DB
139my %validators;
140
141
142##
143## utility functions
144# _rectable()
145# Takes default+rdns flags, returns appropriate table name
146sub _rectable {
147 my $def = shift;
148 my $rev = shift;
149
150 return 'records' if $def ne 'y';
151 return 'default_records' if $rev ne 'y';
152 return 'default_rev_records';
153} # end _rectable()
154
155# _recparent()
156# Takes default+rdns flags, returns appropriate parent-id column name
157sub _recparent {
158 my $def = shift;
159 my $rev = shift;
160
161 return 'group_id' if $def eq 'y';
162 return 'rdns_id' if $rev eq 'y';
163 return 'domain_id';
164} # end _recparent()
165
166# Check an IP to be added in a reverse zone to see if it's really in the requested parent.
167# Takes a database handle, default and reverse flags, IP (fragment) to check, parent zone ID,
168# and a reference to a NetAddr::IP object (also used to pass back a fully-reconstructed IP for
169# database insertion)
170sub _ipparent {
171 my $dbh = shift;
172 my $defrec = shift;
173 my $revrec = shift;
174 my $val = shift;
175 my $id = shift;
176 my $addr = shift;
177
178 return if $revrec ne 'y'; # this sub not useful in forward zones
179
180 $$addr = NetAddr::IP->new($$val); #necessary?
181
182 # subsub to split, reverse, and overlay an IP fragment on a netblock
183 sub __rev_overlay {
184 my $splitme = shift; # ':' or '.', m'lud?
185 my $parnet = shift;
186 my $val = shift;
187 my $addr = shift;
188
189 my $joinme = $splitme;
190 $splitme = '\.' if $splitme eq '.';
191 my @working = reverse(split($splitme, $parnet->addr));
192 my @parts = reverse(split($splitme, $$val));
193 for (my $i = 0; $i <= $#parts; $i++) {
194 $working[$i] = $parts[$i];
195 }
196 my $checkme = NetAddr::IP->new(join($joinme, reverse(@working))) or return 0;
197 return 0 unless $checkme->within($parnet);
198 $$addr = $checkme; # force "correct" IP to be recorded.
199 return 1;
200 }
201
202 my ($parstr) = $dbh->selectrow_array("SELECT revnet FROM revzones WHERE rdns_id = ?", undef, ($id));
203 my $parnet = NetAddr::IP->new($parstr);
204
205 # Fail early on v6-in-v4 or v4-in-v6. We're not accepting these ATM.
206 return 0 if $parnet->addr =~ /\./ && $$val =~ /:/;
207 return 0 if $parnet->addr =~ /:/ && $$val =~ /\./;
208
209 if ($$addr && $$val =~ /^[\da-fA-F][\da-fA-F:]+[\da-fA-F]$/) {
210 # the only case where NetAddr::IP's acceptance of legitimate IPs is "correct" is for a proper IPv6 address.
211 # the rest we have to restructure before fiddling. *sigh*
212 return 1 if $$addr->within($parnet);
213 } else {
214 # We don't have a complete IP in $$val (yet)
215 if ($parnet->addr =~ /:/) {
216 $$val =~ s/^:+//; # gotta strip'em all...
217 return __rev_overlay(':', $parnet, $val, $addr);
218 }
219 if ($parnet->addr =~ /\./) {
220 $$val =~ s/^\.+//;
221 return __rev_overlay('.', $parnet, $val, $addr);
222 }
223 # should be impossible to get here...
224 }
225 # ... and here.
226 # can't do nuttin' in forward zones
227} # end _ipparent()
228
229# A little different than _ipparent above; this tries to *find* the parent zone of a hostname
230sub _hostparent {
231 my $dbh = shift;
232 my $hname = shift;
233
234 my @hostbits = split /\./, $hname;
235 my $sth = $dbh->prepare("SELECT count(*),domain_id FROM domains WHERE domain = ? GROUP BY domain_id");
236 foreach (@hostbits) {
237 $sth->execute($hname);
238 my ($found, $parid) = $sth->fetchrow_array;
239 if ($found) {
240 return $parid;
241 }
242 $hname =~ s/^$_\.//;
243 }
244} # end _hostparent()
245
246##
247## Record validation subs.
248##
249
250# A record
251sub _validate_1 {
252 my $dbh = shift;
253
254 my %args = @_;
255
256 return ('FAIL', 'Reverse zones cannot contain A records') if $args{revrec} eq 'y';
257
258 # Coerce all hostnames to end in ".DOMAIN" for group/default records,
259 # or the intended parent domain for live records.
260 my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id}));
261 ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/;
262
263 # Check IP is well-formed, and that it's a v4 address
264 # Fail on "compact" IPv4 variants, because they are not consistent and predictable.
265 return ('FAIL',"$typemap{${$args{rectype}}} record must be a valid IPv4 address")
266 unless ${$args{val}} =~ /^\d+\.\d+\.\d+\.\d+$/;
267 return ('FAIL',"$typemap{${$args{rectype}}} record must be a valid IPv4 address")
268 unless $args{addr} && !$args{addr}->{isv6};
269 # coerce IP/value to normalized form for storage
270 ${$args{val}} = $args{addr}->addr;
271
272 return ('OK','OK');
273} # done A record
274
275# NS record
276sub _validate_2 {
277 my $dbh = shift;
278
279 my %args = @_;
280
281 # Coerce the hostname to "DOMAIN" for forward default records, "ZONE" for reverse default records,
282 # or the intended parent zone for live records.
283##fixme: allow for delegating <subdomain>.DOMAIN?
284 if ($args{revrec} eq 'y') {
285 my $pname = ($args{defrec} eq 'y' ? 'ZONE' : revName($dbh,$args{id}));
286 ${$args{host}} = $pname if ${$args{host}} ne $pname;
287 } else {
288 my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id}));
289 ${$args{host}} = $pname if ${$args{host}} ne $pname;
290 }
291
292# Let this lie for now. Needs more magic.
293# # Check IP is well-formed, and that it's a v4 address
294# return ('FAIL',"A record must be a valid IPv4 address")
295# unless $addr && !$addr->{isv6};
296# # coerce IP/value to normalized form for storage
297# $$val = $addr->addr;
298
299 return ('OK','OK');
300} # done NS record
301
302# CNAME record
303sub _validate_5 {
304 my $dbh = shift;
305
306 my %args = @_;
307
308# Not really true, but these are only useful for delegating smaller-than-/24 IP blocks.
309# This is fundamentally a messy operation and should really just be taken care of by the
310# export process, not manual maintenance of the necessary records.
311 return ('FAIL', 'Reverse zones cannot contain CNAME records') if $args{revrec} eq 'y';
312
313 # Coerce all hostnames to end in ".DOMAIN" for group/default records,
314 # or the intended parent domain for live records.
315 my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id}));
316 ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/;
317
318 return ('OK','OK');
319} # done CNAME record
320
321# SOA record
322sub _validate_6 {
323 # Smart monkeys won't stick their fingers in here; we have
324 # separate dedicated routines to deal with SOA records.
325 return ('OK','OK');
326} # done SOA record
327
328# PTR record
329sub _validate_12 {
330 my $dbh = shift;
331
332 my %args = @_;
333
334 if ($args{revrec} eq 'y') {
335 if ($args{defrec} eq 'n') {
336 return ('FAIL', "IP or IP fragment ${$args{val}} is not within ".revName($dbh, $args{id}))
337 unless _ipparent($dbh, $args{defrec}, $args{revrec}, $args{val}, $args{id}, \$args{addr});
338 ${$args{val}} = $args{addr}->addr;
339 } else {
340 if (${$args{val}} =~ /\./) {
341 # looks like a v4 or fragment
342 if (${$args{val}} =~ /^\d+\.\d+\.\d+\.\d+$/) {
343 # woo! a complete IP! validate it and normalize, or fail.
344 $args{addr} = NetAddr::IP->new(${$args{val}})
345 or return ('FAIL', "IP/value looks like IPv4 but isn't valid");
346 ${$args{val}} = $args{addr}->addr;
347 } else {
348 ${$args{val}} =~ s/^\.*/ZONE./ unless ${$args{val}} =~ /^ZONE/;
349 }
350 } elsif (${$args{val}} =~ /[a-f:]/) {
351 # looks like a v6 or fragment
352 ${$args{val}} =~ s/^:*/ZONE::/ if !$args{addr} && ${$args{val}} !~ /^ZONE/;
353 if ($args{addr}) {
354 if ($args{addr}->addr =~ /^0/) {
355 ${$args{val}} =~ s/^:*/ZONE::/ unless ${$args{val}} =~ /^ZONE/;
356 } else {
357 ${$args{val}} = $args{addr}->addr;
358 }
359 }
360 } else {
361 # bare number (probably). These could be v4 or v6, so we'll
362 # expand on these on creation of a reverse zone.
363 ${$args{val}} = "ZONE,${$args{val}}" unless ${$args{val}} =~ /^ZONE/;
364 }
365 ${$args{host}} =~ s/\.*$/\.$config{domain}/ if ${$args{host}} !~ /(?:$config{domain}|ADMINDOMAIN)$/;
366 }
367
368# Multiple PTR records do NOT generally do what most people believe they do,
369# and tend to fail in the most awkward way possible. Check and warn.
370# We use $val instead of $addr->addr since we may be in a defrec, and may have eg "ZONE::42" or "ZONE.12"
371
372 my @checkvals = (${$args{val}});
373 if (${$args{val}} =~ /,/) {
374 # push . and :: variants into checkvals if val has ,
375 my $tmp;
376 ($tmp = ${$args{val}}) =~ s/,/./;
377 push @checkvals, $tmp;
378 ($tmp = ${$args{val}}) =~ s/,/::/;
379 push @checkvals, $tmp;
380 }
381 my $pcsth = $dbh->prepare("SELECT count(*) FROM "._rectable($args{defrec},$args{revrec})." WHERE val = ?");
382 foreach my $checkme (@checkvals) {
383 my $ptrcount;
384 ($ptrcount) = $dbh->selectrow_array("SELECT count(*) FROM "._rectable($args{defrec},$args{revrec}).
385 " WHERE val = ?", undef, ($checkme));
386 return ('WARN', "PTR record for $checkme already exists; adding another will probably not do what you want")
387 if $ptrcount;
388 }
389 } else {
390 # Not absolutely true but only useful if you hack things up for sub-/24 v4 reverse delegations
391 # Simpler to just create the reverse zone and grant access for the customer to edit it, and create direct
392 # PTR records on export
393 return ('FAIL',"Forward zones cannot contain PTR records");
394 }
395
396 return ('OK','OK');
397} # done PTR record
398
399# MX record
400sub _validate_15 {
401 my $dbh = shift;
402
403 my %args = @_;
404
405# Not absolutely true but WTF use is an MX record for a reverse zone?
406 return ('FAIL', 'Reverse zones cannot contain MX records') if $args{revrec} eq 'y';
407
408 return ('FAIL', "Distance is required for MX records") unless defined(${$args{dist}});
409 ${$args{dist}} =~ s/\s*//g;
410 return ('FAIL',"Distance is required, and must be numeric") unless ${$args{dist}} =~ /^\d+$/;
411
412 ${$args{fields}} = "distance,";
413 push @{$args{vallist}}, ${$args{dist}};
414
415 # Coerce all hostnames to end in ".DOMAIN" for group/default records,
416 # or the intended parent domain for live records.
417 my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id}));
418 ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/;
419
420 return ('OK','OK');
421} # done MX record
422
423# TXT record
424sub _validate_16 {
425 # Could arguably put a WARN return here on very long (>512) records
426 return ('OK','OK');
427} # done TXT record
428
429# RP record
430sub _validate_17 {
431 # Probably have to validate these some day
432 return ('OK','OK');
433} # done RP record
434
435# AAAA record
436sub _validate_28 {
437 my $dbh = shift;
438
439 my %args = @_;
440
441 return ('FAIL', 'Reverse zones cannot contain AAAA records') if $args{revrec} eq 'y';
442
443 # Coerce all hostnames to end in ".DOMAIN" for group/default records,
444 # or the intended parent domain for live records.
445 my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id}));
446 ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/;
447
448 # Check IP is well-formed, and that it's a v6 address
449 return ('FAIL',"$typemap{${$args{rectype}}} record must be a valid IPv6 address")
450 unless $args{addr} && $args{addr}->{isv6};
451 # coerce IP/value to normalized form for storage
452 ${$args{val}} = $args{addr}->addr;
453
454 return ('OK','OK');
455} # done AAAA record
456
457# SRV record
458sub _validate_33 {
459 my $dbh = shift;
460
461 my %args = @_;
462
463# Not absolutely true but WTF use is an SRV record for a reverse zone?
464 return ('FAIL', 'Reverse zones cannot contain SRV records') if $args{revrec} eq 'y';
465
466 return ('FAIL', "Distance is required for SRV records") unless defined(${$args{dist}});
467 ${$args{dist}} =~ s/\s*//g;
468 return ('FAIL',"Distance is required, and must be numeric") unless ${$args{dist}} =~ /^\d+$/;
469
470 return ('FAIL',"SRV records must begin with _service._protocol [${$args{host}}]")
471 unless ${$args{host}} =~ /^_[A-Za-z]+\._[A-Za-z]+\.[a-zA-Z0-9-]+/;
472 return ('FAIL',"Port and weight are required for SRV records")
473 unless defined(${$args{weight}}) && defined(${$args{port}});
474 ${$args{weight}} =~ s/\s*//g;
475 ${$args{port}} =~ s/\s*//g;
476
477 return ('FAIL',"Port and weight are required, and must be numeric")
478 unless ${$args{weight}} =~ /^\d+$/ && ${$args{port}} =~ /^\d+$/;
479
480 ${$args{fields}} = "distance,weight,port,";
481 push @{$args{vallist}}, (${$args{dist}}, ${$args{weight}}, ${$args{port}});
482
483 # Coerce all hostnames to end in ".DOMAIN" for group/default records,
484 # or the intended parent domain for live records.
485 my $pname = ($args{defrec} eq 'y' ? 'DOMAIN' : domainName($dbh,$args{id}));
486 ${$args{host}} =~ s/\.*$/\.$pname/ if ${$args{host}} !~ /$pname$/;
487
488 return ('OK','OK');
489} # done SRV record
490
491# Now the custom types
492
493# A+PTR record. With a very little bit of magic we can also use this sub to validate AAAA+PTR. Whee!
494sub _validate_65280 {
495 my $dbh = shift;
496
497 my %args = @_;
498
499 my $code = 'OK';
500 my $msg = 'OK';
501
502 if ($args{defrec} eq 'n') {
503 # live record; revrec determines whether we validate the PTR or A component first.
504
505 if ($args{revrec} eq 'y') {
506 ($code,$msg) = _validate_12($dbh, %args);
507 return ($code,$msg) if $code eq 'FAIL';
508
509 # Check if the reqested domain exists. If not, coerce the type down to PTR and warn.
510 if (!(${$args{domid}} = _hostparent($dbh, ${$args{host}}))) {
511 my $addmsg = "Record added as PTR instead of $typemap{${$args{rectype}}}; domain not found for ${$args{host}}";
512 $msg .= "\n$addmsg" if $code eq 'WARN';
513 $msg = $addmsg if $code eq 'OK';
514 ${$args{rectype}} = $reverse_typemap{PTR};
515 return ('WARN', $msg);
516 }
517
518 # Add domain ID to field list and values
519 ${$args{fields}} .= "domain_id,";
520 push @{$args{vallist}}, ${$args{domid}};
521
522 } else {
523 ($code,$msg) = _validate_1($dbh, %args) if ${$args{rectype}} == 65280;
524 ($code,$msg) = _validate_28($dbh, %args) if ${$args{rectype}} == 65281;
525 return ($code,$msg) if $code eq 'FAIL';
526
527 # Check if the requested reverse zone exists - note, an IP fragment won't
528 # work here since we don't *know* which parent to put it in.
529 # ${$args{val}} has been validated as a valid IP by now, in one of the above calls.
530 my ($revid) = $dbh->selectrow_array("SELECT rdns_id FROM revzones WHERE revnet >> ?".
531 " ORDER BY masklen(revnet) DESC", undef, (${$args{val}}));
532 if (!$revid) {
533 $msg = "Record added as ".(${$args{rectype}} == 65280 ? 'A' : 'AAAA').
534 " instead of $typemap{${$args{rectype}}}; reverse zone not found for ${$args{val}}";
535 ${$args{rectype}} = (${$args{rectype}} == 65280 ? $reverse_typemap{A} : $reverse_typemap{AAAA});
536 return ('WARN', $msg);
537 }
538
539 # Check for duplicate PTRs. Note we don't have to play games with $code and $msg, because
540 # by definition there can't be duplicate PTRs if the reverse zone isn't managed here.
541 my ($ptrcount) = $dbh->selectrow_array("SELECT count(*) FROM "._rectable($args{defrec},$args{revrec}).
542 " WHERE val = ?", undef, ${$args{val}});
543 if ($ptrcount) {
544 $msg = "PTR record for ${$args{val}} already exists; adding another will probably not do what you want";
545 $code = 'WARN';
546 }
547
548 ${$args{fields}} .= "rdns_id,";
549 push @{$args{vallist}}, $revid;
550 }
551
552 } else { # defrec eq 'y'
553 if ($args{revrec} eq 'y') {
554 ($code,$msg) = _validate_12($dbh, %args);
555 return ($code,$msg) if $code eq 'FAIL';
556 if (${$args{rectype}} == 65280) {
557 return ('FAIL',"A+PTR record must be a valid IPv4 address or fragment")
558 if ${$args{val}} =~ /:/;
559 ${$args{val}} =~ s/^ZONE,/ZONE./; # Clean up after uncertain IP-fragment-type from _validate_12
560 } elsif (${$args{rectype}} == 65281) {
561 return ('FAIL',"AAAA+PTR record must be a valid IPv6 address or fragment")
562 if ${$args{val}} =~ /\./;
563 ${$args{val}} =~ s/^ZONE,/ZONE::/; # Clean up after uncertain IP-fragment-type from _validate_12
564 }
565 } else {
566 # This is easy. I also can't see a real use-case for A/AAAA+PTR in *all* forward
567 # domains, since you wouldn't be able to substitute both domain and reverse zone
568 # sanely, and you'd end up with guaranteed over-replicated PTR records that would
569 # confuse the hell out of pretty much anything that uses them.
570##fixme: make this a config flag?
571 return ('FAIL', "$typemap{${$args{rectype}}} records not allowed in default domains");
572 }
573 }
574
575 return ($code, $msg);
576} # done A+PTR record
577
578# AAAA+PTR record
579# A+PTR above has been magicked to handle AAAA+PTR as well.
580sub _validate_65281 {
581 return _validate_65280(@_);
582} # done AAAA+PTR record
583
584# PTR template record
585sub _validate_65282 {
586 return ('OK','OK');
587} # done PTR template record
588
589# A+PTR template record
590sub _validate_65283 {
591 return ('OK','OK');
592} # done AAAA+PTR template record
593
594# AAAA+PTR template record
595sub _validate_65284 {
596 return ('OK','OK');
597} # done AAAA+PTR template record
598
599
600
601##
602## Initialization and cleanup subs
603##
604
605
606## DNSDB::loadConfig()
607# Load the minimum required initial state (DB connect info) from a config file
608# Load misc other bits while we're at it.
609# Takes an optional basename and config path to look for
610# Populates the %config and %def hashes
611sub loadConfig {
612 my $basename = shift || ''; # this will work OK
613##fixme $basename isn't doing what I think I thought I was trying to do.
614
615 my $deferr = ''; # place to put error from default config file in case we can't find either one
616
617 my $configroot = "/etc/dnsdb"; ##CFG_LEAF##
618 $configroot = '' if $basename =~ m|^/|;
619 $basename .= ".conf" if $basename !~ /\.conf$/;
620 my $defconfig = "$configroot/dnsdb.conf";
621 my $siteconfig = "$configroot/$basename";
622
623 # System defaults
624 __cfgload("$defconfig") or $deferr = $errstr;
625
626 # Per-site-ish settings.
627 if ($basename ne '.conf') {
628 unless (__cfgload("$siteconfig")) {
629 $errstr = ($deferr ? "Error opening default config file $defconfig: $deferr\n" : '').
630 "Error opening site config file $siteconfig";
631 return;
632 }
633 }
634
635 # Munge log_failures.
636 if ($config{log_failures} ne '1' && $config{log_failures} ne '0') {
637 # true/false, on/off, yes/no all valid.
638 if ($config{log_failures} =~ /^(?:true|false|on|off|yes|no)$/) {
639 if ($config{log_failures} =~ /(?:true|on|yes)/) {
640 $config{log_failures} = 1;
641 } else {
642 $config{log_failures} = 0;
643 }
644 } else {
645 $errstr = "Bad log_failures setting $config{log_failures}";
646 $config{log_failures} = 1;
647 # Bad setting shouldn't be fatal.
648 # return 2;
649 }
650 }
651
652 # All good, clear the error and go home.
653 $errstr = '';
654 return 1;
655} # end loadConfig()
656
657
658## DNSDB::__cfgload()
659# Private sub to parse a config file and load it into %config
660# Takes a file handle on an open config file
661sub __cfgload {
662 $errstr = '';
663 my $cfgfile = shift;
664
665 if (open CFG, "<$cfgfile") {
666 while (<CFG>) {
667 chomp;
668 s/^\s*//;
669 next if /^#/;
670 next if /^$/;
671# hmm. more complex bits in this file might require [heading] headers, maybe?
672# $mode = $1 if /^\[(a-z)+]/;
673 # DB connect info
674 $config{dbname} = $1 if /^dbname\s*=\s*([a-z0-9_.-]+)/i;
675 $config{dbuser} = $1 if /^dbuser\s*=\s*([a-z0-9_.-]+)/i;
676 $config{dbpass} = $1 if /^dbpass\s*=\s*([a-z0-9_.-]+)/i;
677 $config{dbhost} = $1 if /^dbhost\s*=\s*([a-z0-9_.-]+)/i;
678 # SOA defaults
679 $def{contact} = $1 if /^contact\s*=\s*([a-z0-9_.-]+)/i;
680 $def{prins} = $1 if /^prins\s*=\s*([a-z0-9_.-]+)/i;
681 $def{soattl} = $1 if /^soattl\s*=\s*(\d+)/i;
682 $def{refresh} = $1 if /^refresh\s*=\s*(\d+)/i;
683 $def{retry} = $1 if /^retry\s*=\s*(\d+)/i;
684 $def{expire} = $1 if /^expire\s*=\s*(\d+)/i;
685 $def{minttl} = $1 if /^minttl\s*=\s*(\d+)/i;
686 $def{ttl} = $1 if /^ttl\s*=\s*(\d+)/i;
687 # Mail settings
688 $config{mailhost} = $1 if /^mailhost\s*=\s*([a-z0-9_.-]+)/i;
689 $config{mailnotify} = $1 if /^mailnotify\s*=\s*([a-z0-9_.\@-]+)/i;
690 $config{mailsender} = $1 if /^mailsender\s*=\s*([a-z0-9_.\@-]+)/i;
691 $config{mailname} = $1 if /^mailname\s*=\s*([a-z0-9\s_.-]+)/i;
692 $config{orgname} = $1 if /^orgname\s*=\s*([a-z0-9\s_.,'-]+)/i;
693 $config{domain} = $1 if /^domain\s*=\s*([a-z0-9_.-]+)/i;
694 # session - note this is fed directly to CGI::Session
695 $config{timeout} = $1 if /^[tT][iI][mM][eE][oO][uU][tT]\s*=\s*(\d+[smhdwMy]?)/;
696 $config{sessiondir} = $1 if m{^sessiondir\s*=\s*([a-z0-9/_.-]+)}i;
697 # misc
698 $config{log_failures} = $1 if /^log_failures\s*=\s*([a-z01]+)/i;
699 $config{perpage} = $1 if /^perpage\s*=\s*(\d+)/i;
700 }
701 close CFG;
702 } else {
703 $errstr = $!;
704 return;
705 }
706 return 1;
707} # end __cfgload()
708
709
710## DNSDB::connectDB()
711# Creates connection to DNS database.
712# Requires the database name, username, and password.
713# Returns a handle to the db.
714# Set up for a PostgreSQL db; could be any transactional DBMS with the
715# right changes.
716sub connectDB {
717 $errstr = '';
718 my $dbname = shift;
719 my $user = shift;
720 my $pass = shift;
721 my $dbh;
722 my $DSN = "DBI:Pg:dbname=$dbname";
723
724 my $host = shift;
725 $DSN .= ";host=$host" if $host;
726
727# Note that we want to autocommit by default, and we will turn it off locally as necessary.
728# We may not want to print gobbledygook errors; YMMV. Have to ponder that further.
729 $dbh = DBI->connect($DSN, $user, $pass, {
730 AutoCommit => 1,
731 PrintError => 0
732 })
733 or return (undef, $DBI::errstr) if(!$dbh);
734
735##fixme: initialize the DB if we can't find the table (since, by definition, there's
736# nothing there if we can't select from it...)
737 my $tblsth = $dbh->prepare("SELECT count(*) FROM pg_catalog.pg_class WHERE relkind='r' AND relname=?");
738 my ($tblcount) = $dbh->selectrow_array($tblsth, undef, ('misc'));
739 return (undef,$DBI::errstr) if $dbh->err;
740
741#if ($tblcount == 0) {
742# # create tables one at a time, checking for each.
743# return (undef, "check table misc missing");
744#}
745
746
747# Return here if we can't select.
748# This should retrieve the dbversion key.
749 my $sth = $dbh->prepare("SELECT key,value FROM misc WHERE misc_id=1");
750 $sth->execute();
751 return (undef,$DBI::errstr) if ($sth->err);
752
753##fixme: do stuff to the DB on version mismatch
754# x.y series should upgrade on $DNSDB::VERSION > misc(key=>version)
755# DB should be downward-compatible; column defaults should give sane (if possibly
756# useless-and-needs-help) values in columns an older software stack doesn't know about.
757
758# See if the select returned anything (or null data). This should
759# succeed if the select executed, but...
760 $sth->fetchrow();
761 return (undef,$DBI::errstr) if ($sth->err);
762
763 $sth->finish;
764
765# If we get here, we should be OK.
766 return ($dbh,"DB connection OK");
767} # end connectDB
768
769
770## DNSDB::finish()
771# Cleans up after database handles and so on.
772# Requires a database handle
773sub finish {
774 my $dbh = $_[0];
775 $dbh->disconnect;
776} # end finish
777
778
779## DNSDB::initGlobals()
780# Initialize global variables
781# NB: this does NOT include web-specific session variables!
782# Requires a database handle
783sub initGlobals {
784 my $dbh = shift;
785
786# load record types from database
787 my $sth = $dbh->prepare("SELECT val,name,stdflag FROM rectypes");
788 $sth->execute;
789 while (my ($recval,$recname,$stdflag) = $sth->fetchrow_array()) {
790 $typemap{$recval} = $recname;
791 $reverse_typemap{$recname} = $recval;
792 # now we fill the record validation function hash
793 if ($stdflag < 5) {
794 my $fn = "_validate_$recval";
795 $validators{$recval} = \&$fn;
796 } else {
797 my $fn = "sub { return ('FAIL','Type $recval ($recname) not supported'); }";
798 $validators{$recval} = eval $fn;
799 }
800 }
801} # end initGlobals
802
803
804## DNSDB::initPermissions()
805# Set up permissions global
806# Takes database handle and UID
807sub initPermissions {
808 my $dbh = shift;
809 my $uid = shift;
810
811# %permissions = $(getPermissions($dbh,'user',$uid));
812 getPermissions($dbh, 'user', $uid, \%permissions);
813
814} # end initPermissions()
815
816
817## DNSDB::getPermissions()
818# Get permissions from DB
819# Requires DB handle, group or user flag, ID, and hashref.
820sub getPermissions {
821 my $dbh = shift;
822 my $type = shift;
823 my $id = shift;
824 my $hash = shift;
825
826 my $sql = qq(
827 SELECT
828 p.admin,p.self_edit,
829 p.group_create,p.group_edit,p.group_delete,
830 p.user_create,p.user_edit,p.user_delete,
831 p.domain_create,p.domain_edit,p.domain_delete,
832 p.record_create,p.record_edit,p.record_delete
833 FROM permissions p
834 );
835 if ($type eq 'group') {
836 $sql .= qq(
837 JOIN groups g ON g.permission_id=p.permission_id
838 WHERE g.group_id=?
839 );
840 } else {
841 $sql .= qq(
842 JOIN users u ON u.permission_id=p.permission_id
843 WHERE u.user_id=?
844 );
845 }
846
847 my $sth = $dbh->prepare($sql);
848
849 $sth->execute($id) or die "argh: ".$sth->errstr;
850
851# my $permref = $sth->fetchrow_hashref;
852# return $permref;
853# $hash = $permref;
854# Eww. Need to learn how to forcibly drop a hashref onto an existing hash.
855 ($hash->{admin},$hash->{self_edit},
856 $hash->{group_create},$hash->{group_edit},$hash->{group_delete},
857 $hash->{user_create},$hash->{user_edit},$hash->{user_delete},
858 $hash->{domain_create},$hash->{domain_edit},$hash->{domain_delete},
859 $hash->{record_create},$hash->{record_edit},$hash->{record_delete})
860 = $sth->fetchrow_array;
861
862} # end getPermissions()
863
864
865## DNSDB::changePermissions()
866# Update an ACL entry
867# Takes a db handle, type, owner-id, and hashref for the changed permissions.
868sub changePermissions {
869 my $dbh = shift;
870 my $type = shift;
871 my $id = shift;
872 my $newperms = shift;
873 my $inherit = shift || 0;
874
875 my $failmsg = '';
876
877 # see if we're switching from inherited to custom. for bonus points,
878 # snag the permid and parent permid anyway, since we'll need the permid
879 # to set/alter custom perms, and both if we're switching from custom to
880 # inherited.
881 my $sth = $dbh->prepare("SELECT (u.permission_id=g.permission_id) AS was_inherited,u.permission_id,g.permission_id".
882 " FROM ".($type eq 'user' ? 'users' : 'groups')." u ".
883 " JOIN groups g ON u.".($type eq 'user' ? '' : 'parent_')."group_id=g.group_id ".
884 " WHERE u.".($type eq 'user' ? 'user' : 'group')."_id=?");
885 $sth->execute($id);
886
887 my ($wasinherited,$permid,$parpermid) = $sth->fetchrow_array;
888
889# hack phtoui
890# group id 1 is "special" in that it's it's own parent (err... possibly.)
891# may make its parent id 0 which doesn't exist, and as a bonus is Perl-false.
892 $wasinherited = 0 if ($type eq 'group' && $id == 1);
893
894 local $dbh->{AutoCommit} = 0;
895 local $dbh->{RaiseError} = 1;
896
897 # Wrap all the SQL in a transaction
898 eval {
899 if ($inherit) {
900
901 $dbh->do("UPDATE ".($type eq 'user' ? 'users' : 'groups')." SET inherit_perm='t',permission_id=? ".
902 "WHERE ".($type eq 'user' ? 'user' : 'group')."_id=?", undef, ($parpermid, $id) );
903 $dbh->do("DELETE FROM permissions WHERE permission_id=?", undef, ($permid) );
904
905 } else {
906
907 if ($wasinherited) { # munge new permission entry in if we're switching from inherited perms
908##fixme: need to add semirecursive bit to properly munge inherited permission ID on subgroups and users
909# ... if'n'when we have groups with fully inherited permissions.
910 # SQL is coo
911 $dbh->do("INSERT INTO permissions ($permlist,".($type eq 'user' ? 'user' : 'group')."_id) ".
912 "SELECT $permlist,? FROM permissions WHERE permission_id=?", undef, ($id,$permid) );
913 ($permid) = $dbh->selectrow_array("SELECT permission_id FROM permissions ".
914 "WHERE ".($type eq 'user' ? 'user' : 'group')."_id=?", undef, ($id) );
915 $dbh->do("UPDATE ".($type eq 'user' ? 'users' : 'groups')." SET inherit_perm='f',permission_id=? ".
916 "WHERE ".($type eq 'user' ? 'user' : 'group')."_id=?", undef, ($permid, $id) );
917 }
918
919 # and now set the permissions we were passed
920 foreach (@permtypes) {
921 if (defined ($newperms->{$_})) {
922 $dbh->do("UPDATE permissions SET $_=? WHERE permission_id=?", undef, ($newperms->{$_},$permid) );
923 }
924 }
925
926 } # (inherited->)? custom
927
928 $dbh->commit;
929 }; # end eval
930 if ($@) {
931 my $msg = $@;
932 eval { $dbh->rollback; };
933 return ('FAIL',"$failmsg: $msg ($permid)");
934 } else {
935 return ('OK',$permid);
936 }
937
938} # end changePermissions()
939
940
941## DNSDB::comparePermissions()
942# Compare two permission hashes
943# Returns '>', '<', '=', '!'
944sub comparePermissions {
945 my $p1 = shift;
946 my $p2 = shift;
947
948 my $retval = '='; # assume equality until proven otherwise
949
950 no warnings "uninitialized";
951
952 foreach (@permtypes) {
953 next if $p1->{$_} == $p2->{$_}; # equal is good
954 if ($p1->{$_} && !$p2->{$_}) {
955 if ($retval eq '<') { # if we've already found an unequal pair where
956 $retval = '!'; # $p2 has more access, and we now find a pair
957 last; # where $p1 has more access, the overall access
958 } # is neither greater or lesser, it's unequal.
959 $retval = '>';
960 }
961 if (!$p1->{$_} && $p2->{$_}) {
962 if ($retval eq '>') { # if we've already found an unequal pair where
963 $retval = '!'; # $p1 has more access, and we now find a pair
964 last; # where $p2 has more access, the overall access
965 } # is neither greater or lesser, it's unequal.
966 $retval = '<';
967 }
968 }
969 return $retval;
970} # end comparePermissions()
971
972
973## DNSDB::changeGroup()
974# Change group ID of an entity
975# Takes a database handle, entity type, entity ID, and new group ID
976sub changeGroup {
977 my $dbh = shift;
978 my $type = shift;
979 my $id = shift;
980 my $newgrp = shift;
981
982##fixme: fail on not enough args
983 #return ('FAIL', "Missing
984
985 if ($type eq 'domain') {
986 $dbh->do("UPDATE domains SET group_id=? WHERE domain_id=?", undef, ($newgrp, $id))
987 or return ('FAIL','Group change failed: '.$dbh->errstr);
988 } elsif ($type eq 'user') {
989 $dbh->do("UPDATE users SET group_id=? WHERE user_id=?", undef, ($newgrp, $id))
990 or return ('FAIL','Group change failed: '.$dbh->errstr);
991 } elsif ($type eq 'group') {
992 $dbh->do("UPDATE groups SET parent_group_id=? WHERE group_id=?", undef, ($newgrp, $id))
993 or return ('FAIL','Group change failed: '.$dbh->errstr);
994 }
995 return ('OK','OK');
996} # end changeGroup()
997
998
999## DNSDB::_log()
1000# Log an action
1001# Internal sub
1002# Takes a database handle and log entry hash containing at least:
1003# user_id, group_id, log entry
1004# and optionally one or more of:
1005# username/email, user full name, domain_id, rdns_id
1006##fixme: convert to trailing hash for user info
1007# User info must contain a (user ID OR username)+fullname
1008sub _log {
1009 my $dbh = shift;
1010
1011 my %args = @_;
1012
1013 $args{rdns_id} = 0 if !$args{rdns_id};
1014 $args{domain_id} = 0 if !$args{domain_id};
1015
1016##fixme: need better way(s?) to snag userinfo for log entries. don't want to have
1017# to pass around yet *another* constant (already passing $dbh, shouldn't need to)
1018 my $fullname;
1019 if (!$args{user_id}) {
1020 ($args{user_id}, $fullname) = $dbh->selectrow_array("SELECT user_id, firstname || ' ' || lastname FROM users".
1021 " WHERE username=?", undef, ($args{username}));
1022 }
1023 if (!$args{username}) {
1024 ($args{username}, $fullname) = $dbh->selectrow_array("SELECT username, firstname || ' ' || lastname FROM users".
1025 " WHERE user_id=?", undef, ($args{user_id}));
1026 }
1027 if (!$args{fullname}) {
1028 ($fullname) = $dbh->selectrow_array("SELECT firstname || ' ' || lastname FROM users".
1029 " WHERE user_id=?", undef, ($args{user_id}));
1030 }
1031
1032 $args{name} = $fullname if !$args{name};
1033
1034##fixme: farm out the actual logging to different subs for file, syslog, internal, etc based on config
1035 $dbh->do("INSERT INTO log (domain_id,rdns_id,user_id,group_id,email,name,entry) VALUES (?,?,?,?,?,?,?)",
1036 undef,
1037 ($args{domain_id},$args{rdns_id},$args{user_id},$args{group_id},$args{username},$args{name},$args{entry}));
1038
1039} # end _log
1040
1041
1042##
1043## Processing subs
1044##
1045
1046## DNSDB::addDomain()
1047# Add a domain
1048# Takes a database handle, domain name, numeric group, boolean(ish) state (active/inactive),
1049# and user info hash (for logging).
1050# Returns a status code and message
1051sub addDomain {
1052 $errstr = '';
1053 my $dbh = shift;
1054 return ('FAIL',"Need database handle") if !$dbh;
1055 my $domain = shift;
1056 return ('FAIL',"Domain must not be blank") if !$domain;
1057 my $group = shift;
1058 return ('FAIL',"Need group") if !defined($group);
1059 my $state = shift;
1060 return ('FAIL',"Need domain status") if !defined($state);
1061
1062 my %userinfo = @_; # remaining bits.
1063# user ID, username, user full name
1064
1065 $state = 1 if $state =~ /^active$/;
1066 $state = 1 if $state =~ /^on$/;
1067 $state = 0 if $state =~ /^inactive$/;
1068 $state = 0 if $state =~ /^off$/;
1069
1070 return ('FAIL',"Invalid domain status") if $state !~ /^\d+$/;
1071
1072 return ('FAIL', "Invalid characters in domain") if $domain !~ /^[a-zA-Z0-9_.-]+$/;
1073
1074 my $sth = $dbh->prepare("SELECT domain_id FROM domains WHERE domain=?");
1075 my $dom_id;
1076
1077# quick check to start to see if we've already got one
1078 $sth->execute($domain);
1079 ($dom_id) = $sth->fetchrow_array;
1080
1081 return ('FAIL', "Domain already exists") if $dom_id;
1082
1083 # Allow transactions, and raise an exception on errors so we can catch it later.
1084 # Use local to make sure these get "reset" properly on exiting this block
1085 local $dbh->{AutoCommit} = 0;
1086 local $dbh->{RaiseError} = 1;
1087
1088 # Wrap all the SQL in a transaction
1089 eval {
1090 # insert the domain...
1091 $dbh->do("INSERT INTO domains (domain,group_id,status) VALUES (?,?,?)", undef, ($domain, $group, $state));
1092
1093 # get the ID...
1094 ($dom_id) = $dbh->selectrow_array("SELECT domain_id FROM domains WHERE domain=?", undef, ($domain));
1095
1096 _log($dbh, (domain_id => $dom_id, user_id => $userinfo{id}, group_id => $group, username => $userinfo{username},
1097 entry => "Added ".($state ? 'active' : 'inactive')." domain $domain"));
1098
1099 # ... and now we construct the standard records from the default set. NB: group should be variable.
1100 my $sth = $dbh->prepare("SELECT host,type,val,distance,weight,port,ttl FROM default_records WHERE group_id=?");
1101 my $sth_in = $dbh->prepare("INSERT INTO records (domain_id,host,type,val,distance,weight,port,ttl)".
1102 " VALUES ($dom_id,?,?,?,?,?,?,?)");
1103 $sth->execute($group);
1104 while (my ($host,$type,$val,$dist,$weight,$port,$ttl) = $sth->fetchrow_array()) {
1105 $host =~ s/DOMAIN/$domain/g;
1106 $val =~ s/DOMAIN/$domain/g;
1107 $sth_in->execute($host,$type,$val,$dist,$weight,$port,$ttl);
1108 if ($typemap{$type} eq 'SOA') {
1109 my @tmp1 = split /:/, $host;
1110 my @tmp2 = split /:/, $val;
1111 _log($dbh, (domain_id => $dom_id, user_id => $userinfo{id}, group_id => $group,
1112 username => $userinfo{username}, entry =>
1113 "[new $domain] Added SOA record [contact $tmp1[0]] [master $tmp1[1]] ".
1114 "[refresh $tmp2[0]] [retry $tmp2[1]] [expire $tmp2[2]] [minttl $tmp2[3]], TTL $ttl"));
1115 } else {
1116 my $logentry = "[new $domain] Added record '$host $typemap{$type}";
1117 $logentry .= " [distance $dist]" if $typemap{$type} eq 'MX';
1118 $logentry .= " [priority $dist] [weight $weight] [port $port]" if $typemap{$type} eq 'SRV';
1119 _log($dbh, (domain_id => $dom_id, user_id => $userinfo{id}, group_id => $group,
1120 username => $userinfo{username}, entry =>
1121 $logentry." $val', TTL $ttl"));
1122 }
1123 }
1124
1125 # once we get here, we should have suceeded.
1126 $dbh->commit;
1127 }; # end eval
1128
1129 if ($@) {
1130 my $msg = $@;
1131 eval { $dbh->rollback; };
1132 return ('FAIL',$msg);
1133 } else {
1134 return ('OK',$dom_id);
1135 }
1136} # end addDomain
1137
1138
1139## DNSDB::delDomain()
1140# Delete a domain.
1141# for now, just delete the records, then the domain.
1142# later we may want to archive it in some way instead (status code 2, for example?)
1143sub delDomain {
1144 my $dbh = shift;
1145 my $domid = shift;
1146
1147 # Allow transactions, and raise an exception on errors so we can catch it later.
1148 # Use local to make sure these get "reset" properly on exiting this block
1149 local $dbh->{AutoCommit} = 0;
1150 local $dbh->{RaiseError} = 1;
1151
1152 my $failmsg = '';
1153
1154 # Wrap all the SQL in a transaction
1155 eval {
1156 my $sth = $dbh->prepare("delete from records where domain_id=?");
1157 $failmsg = "Failure removing domain records";
1158 $sth->execute($domid);
1159 $sth = $dbh->prepare("delete from domains where domain_id=?");
1160 $failmsg = "Failure removing domain";
1161 $sth->execute($domid);
1162
1163 # once we get here, we should have suceeded.
1164 $dbh->commit;
1165 }; # end eval
1166
1167 if ($@) {
1168 my $msg = $@;
1169 eval { $dbh->rollback; };
1170 return ('FAIL',"$failmsg: $msg");
1171 } else {
1172 return ('OK','OK');
1173 }
1174
1175} # end delDomain()
1176
1177
1178## DNSDB::domainName()
1179# Return the domain name based on a domain ID
1180# Takes a database handle and the domain ID
1181# Returns the domain name or undef on failure
1182sub domainName {
1183 $errstr = '';
1184 my $dbh = shift;
1185 my $domid = shift;
1186 my ($domname) = $dbh->selectrow_array("SELECT domain FROM domains WHERE domain_id=?", undef, ($domid) );
1187 $errstr = $DBI::errstr if !$domname;
1188 return $domname if $domname;
1189} # end domainName()
1190
1191
1192## DNSDB::revName()
1193# Return the reverse zone name based on an rDNS ID
1194# Takes a database handle and the rDNS ID
1195# Returns the reverse zone name or undef on failure
1196sub revName {
1197 $errstr = '';
1198 my $dbh = shift;
1199 my $revid = shift;
1200 my ($revname) = $dbh->selectrow_array("SELECT revnet FROM revzones WHERE rdns_id=?", undef, ($revid) );
1201 $errstr = $DBI::errstr if !$revname;
1202 return $revname if $revname;
1203} # end revName()
1204
1205
1206## DNSDB::domainID()
1207# Takes a database handle and domain name
1208# Returns the domain ID number
1209sub domainID {
1210 $errstr = '';
1211 my $dbh = shift;
1212 my $domain = shift;
1213 my ($domid) = $dbh->selectrow_array("SELECT domain_id FROM domains WHERE domain=?", undef, ($domain) );
1214 $errstr = $DBI::errstr if !$domid;
1215 return $domid if $domid;
1216} # end domainID()
1217
1218
1219## DNSDB::addRDNS
1220# Adds a reverse DNS zone
1221# Takes a database handle, CIDR block, numeric group, boolean(ish) state (active/inactive),
1222# and user info hash (for logging).
1223# Returns a status code and message
1224sub addRDNS {
1225 my $dbh = shift;
1226 my $zone = NetAddr::IP->new(shift);
1227 return ('FAIL',"Zone name must be a valid CIDR netblock") unless ($zone && $zone->addr !~ /^0/);
1228 my $revpatt = shift;
1229 my $group = shift;
1230 my $state = shift;
1231
1232 my %userinfo = @_; # remaining bits.
1233# user ID, username, user full name
1234
1235 $state = 1 if $state =~ /^active$/;
1236 $state = 1 if $state =~ /^on$/;
1237 $state = 0 if $state =~ /^inactive$/;
1238 $state = 0 if $state =~ /^off$/;
1239
1240 return ('FAIL',"Invalid zone status") if $state !~ /^\d+$/;
1241
1242# quick check to start to see if we've already got one
1243 my ($rdns_id) = $dbh->selectrow_array("SELECT rdns_id FROM revzones WHERE revzone=?", undef, ("$zone"));
1244
1245 return ('FAIL', "Zone already exists") if $rdns_id;
1246
1247 # Allow transactions, and raise an exception on errors so we can catch it later.
1248 # Use local to make sure these get "reset" properly on exiting this block
1249 local $dbh->{AutoCommit} = 0;
1250 local $dbh->{RaiseError} = 1;
1251
1252#$dbh->selectrow_array("SELECT currval('users_user_id_seq')");
1253 # Wrap all the SQL in a transaction
1254 eval {
1255 # insert the domain...
1256 $dbh->do("INSERT INTO revzones (revnet,group_id,status) VALUES (?,?,?)", undef, ($zone, $group, $state));
1257
1258 # get the ID...
1259 ($rdns_id) = $dbh->selectrow_array("SELECT currval('revzones_rdns_id_seq')");
1260
1261 _log($dbh, (rdns_id => $rdns_id, user_id => $userinfo{id}, group_id => $group, username => $userinfo{name},
1262 entry => "Added ".($state ? 'active' : 'inactive')." reverse zone $zone"));
1263
1264 # ... and now we construct the standard records from the default set. NB: group should be variable.
1265 my $sth = $dbh->prepare("SELECT host,type,val,ttl FROM default_rev_records WHERE group_id=?");
1266 my $sth_in = $dbh->prepare("INSERT INTO records (rdns_id,host,type,val,ttl)".
1267 " VALUES ($rdns_id,?,?,?,?)");
1268 $sth->execute($group);
1269 while (my ($host,$type,$val,$ttl) = $sth->fetchrow_array()) {
1270 $host =~ s/ADMINDOMAIN/$config{domain}/g;
1271##work
1272# - replace ZONE in $val
1273# - skip records not appropriate for the zone (skip A+PTR on v6 zones, and AAAA+PTR on v4 zones)
1274# $val =~ s/DOMAIN/$domain/g;
1275 $sth_in->execute($host,$type,$val,$ttl);
1276 if ($typemap{$type} eq 'SOA') {
1277 my @tmp1 = split /:/, $host;
1278 my @tmp2 = split /:/, $val;
1279 _log($dbh, (rdns_id => $rdns_id, user_id => $userinfo{id}, group_id => $group,
1280 username => $userinfo{name}, entry =>
1281 "[new $zone] Added SOA record [contact $tmp1[0]] [master $tmp1[1]] ".
1282 "[refresh $tmp2[0]] [retry $tmp2[1]] [expire $tmp2[2]] [minttl $tmp2[3]], TTL $ttl"));
1283 } else {
1284 my $logentry = "[new $zone] Added record '$host $typemap{$type}";
1285# $logentry .= " [distance $dist]" if $typemap{$type} eq 'MX';
1286# $logentry .= " [priority $dist] [weight $weight] [port $port]" if $typemap{$type} eq 'SRV';
1287 _log($dbh, (rdns_id => $rdns_id, user_id => $userinfo{id}, group_id => $group,
1288 username => $userinfo{name}, entry =>
1289 $logentry." $val', TTL $ttl"));
1290 }
1291 }
1292
1293 # once we get here, we should have suceeded.
1294 $dbh->commit;
1295 }; # end eval
1296
1297 if ($@) {
1298 my $msg = $@;
1299 eval { $dbh->rollback; };
1300 return ('FAIL',$msg);
1301 } else {
1302 return ('OK',$rdns_id);
1303 }
1304
1305} # end addRDNS()
1306
1307
1308## DNSDB::getZoneCount
1309# Get count of zones in group or groups
1310# Takes a database handle and hash containing:
1311# - the "current" group
1312# - an array of "acceptable" groups
1313# - a flag for forward/reverse zones
1314# - Optionally accept a "starts with" and/or "contains" filter argument
1315# Returns an integer count of the resulting zone list.
1316sub getZoneCount {
1317 my $dbh = shift;
1318
1319 my %args = @_;
1320
1321 my @filterargs;
1322 $args{startwith} = undef if $args{startwith} && $args{startwith} !~ /^(?:[a-z]|0-9)$/;
1323 push @filterargs, "^$args{startwith}" if $args{startwith};
1324 $args{filter} =~ s/\./\[\.\]/g if $args{filter}; # only match literal dots, usually in reverse zones
1325 push @filterargs, $args{filter} if $args{filter};
1326
1327 my $sql;
1328 # Not as compact, and fix-me-twice if the common bits get wrong, but much easier to read
1329 if ($args{revrec} eq 'n') {
1330 $sql = "SELECT count(*) FROM domains".
1331 " WHERE group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")".
1332 ($args{startwith} ? " AND domain ~* ?" : '').
1333 ($args{filter} ? " AND domain ~* ?" : '');
1334 } else {
1335 $sql = "SELECT count(*) FROM revzones".
1336 " WHERE group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")".
1337 ($args{startwith} ? " AND CAST(revnet AS VARCHAR) ~* ?" : '').
1338 ($args{filter} ? " AND CAST(revnet AS VARCHAR) ~* ?" : '');
1339 }
1340 my ($count) = $dbh->selectrow_array($sql, undef, @filterargs);
1341 return $count;
1342} # end getZoneCount()
1343
1344
1345## DNSDB::getZoneList()
1346# Get a list of zones in the specified group(s)
1347# Takes the same arguments as getZoneCount() above
1348# Returns a reference to an array of hashrefs suitable for feeding to HTML::Template
1349sub getZoneList {
1350 my $dbh = shift;
1351
1352 my %args = @_;
1353
1354 my @zonelist;
1355
1356 $args{sortorder} = 'ASC' if !grep $args{sortorder}, ('ASC','DESC');
1357 $args{offset} = 0 if !$args{offset} || $args{offset} !~ /^(?:all|\d+)$/;
1358
1359 my @filterargs;
1360 $args{startwith} = undef if $args{startwith} && $args{startwith} !~ /^(?:[a-z]|0-9)$/;
1361 push @filterargs, "^$args{startwith}" if $args{startwith};
1362 $args{filter} =~ s/\./\[\.\]/g if $args{filter}; # only match literal dots, usually in reverse zones
1363 push @filterargs, $args{filter} if $args{filter};
1364
1365 my $sql;
1366 # Not as compact, and fix-me-twice if the common bits get wrong, but much easier to read
1367 if ($args{revrec} eq 'n') {
1368 $args{sortby} = 'domain' if !grep $args{sortby}, ('revnet','group','status');
1369 $sql = "SELECT domain_id,domain,status,groups.group_name AS group FROM domains".
1370 " INNER JOIN groups ON domains.group_id=groups.group_id".
1371 " WHERE domains.group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")".
1372 ($args{startwith} ? " AND domain ~* ?" : '').
1373 ($args{filter} ? " AND domain ~* ?" : '');
1374 } else {
1375##fixme: arguably startwith here is irrelevant. depends on the UI though.
1376 $args{sortby} = 'revnet' if !grep $args{sortby}, ('domain','group','status');
1377 $sql = "SELECT rdns_id,revnet,status,groups.group_name AS group FROM revzones".
1378 " INNER JOIN groups ON revzones.group_id=groups.group_id".
1379 " WHERE revzones.group_id IN ($args{curgroup}".($args{childlist} ? ",$args{childlist}" : '').")".
1380 ($args{startwith} ? " AND CAST(revnet AS VARCHAR) ~* ?" : '').
1381 ($args{filter} ? " AND CAST(revnet AS VARCHAR) ~* ?" : '');
1382 }
1383 # A common tail.
1384 $sql .= " ORDER BY ".($args{sortby} eq 'group' ? 'groups.group_name' : $args{sortby})." $args{sortorder} ".
1385 ($args{offset} eq 'all' ? '' : " LIMIT $config{perpage}".
1386 " OFFSET ".$args{offset}*$config{perpage});
1387 my $sth = $dbh->prepare($sql);
1388 $sth->execute(@filterargs);
1389 my $rownum = 0;
1390
1391 while (my @data = $sth->fetchrow_array) {
1392 my %row;
1393 $row{domainid} = $data[0];
1394 $row{domain} = $data[1];
1395 $row{status} = $data[2];
1396 $row{group} = $data[3];
1397 push @zonelist, \%row;
1398 }
1399
1400 return \@zonelist;
1401} # end getZoneList()
1402
1403
1404## DNSDB::addGroup()
1405# Add a group
1406# Takes a database handle, group name, parent group, hashref for permissions,
1407# and optional template-vs-cloneme flag
1408# Returns a status code and message
1409sub addGroup {
1410 $errstr = '';
1411 my $dbh = shift;
1412 my $groupname = shift;
1413 my $pargroup = shift;
1414 my $permissions = shift;
1415
1416 # 0 indicates "custom", hardcoded.
1417 # Any other value clones that group's default records, if it exists.
1418 my $inherit = shift || 0;
1419##fixme: need a flag to indicate clone records or <?> ?
1420
1421 # Allow transactions, and raise an exception on errors so we can catch it later.
1422 # Use local to make sure these get "reset" properly on exiting this block
1423 local $dbh->{AutoCommit} = 0;
1424 local $dbh->{RaiseError} = 1;
1425
1426 my $sth = $dbh->prepare("SELECT group_id FROM groups WHERE group_name=?");
1427 my $group_id;
1428
1429# quick check to start to see if we've already got one
1430 $sth->execute($groupname);
1431 ($group_id) = $sth->fetchrow_array;
1432
1433 return ('FAIL', "Group already exists") if $group_id;
1434
1435 # Wrap all the SQL in a transaction
1436 eval {
1437 $sth = $dbh->prepare("INSERT INTO groups (parent_group_id,group_name) VALUES (?,?)");
1438 $sth->execute($pargroup,$groupname);
1439
1440 my ($groupid) = $dbh->selectrow_array("SELECT group_id FROM groups WHERE group_name=?", undef, ($groupname));
1441
1442# Permissions
1443 if ($inherit) {
1444 } else {
1445 my @permvals;
1446 foreach (@permtypes) {
1447 if (!defined ($permissions->{$_})) {
1448 push @permvals, 0;
1449 } else {
1450 push @permvals, $permissions->{$_};
1451 }
1452 }
1453
1454 $sth = $dbh->prepare("INSERT INTO permissions (group_id,$permlist) values (?".',?'x($#permtypes+1).")");
1455 $sth->execute($groupid,@permvals);
1456
1457 $sth = $dbh->prepare("SELECT permission_id FROM permissions WHERE group_id=?");
1458 $sth->execute($groupid);
1459 my ($permid) = $sth->fetchrow_array();
1460
1461 $dbh->do("UPDATE groups SET permission_id=$permid WHERE group_id=$groupid");
1462 } # done permission fiddling
1463
1464# Default records
1465 my $sthf = $dbh->prepare("INSERT INTO default_records (group_id,host,type,val,distance,weight,port,ttl) ".
1466 "VALUES ($groupid,?,?,?,?,?,?,?)");
1467 my $sthr = $dbh->prepare("INSERT INTO default_rev_records (group_id,host,type,val,ttl) ".
1468 "VALUES ($groupid,?,?,?,?)");
1469 if ($inherit) {
1470 # Duplicate records from parent. Actually relying on inherited records feels
1471 # very fragile, and it would be problematic to roll over at a later time.
1472 my $sth2 = $dbh->prepare("SELECT host,type,val,distance,weight,port,ttl FROM default_records WHERE group_id=?");
1473 $sth2->execute($pargroup);
1474 while (my @clonedata = $sth2->fetchrow_array) {
1475 $sthf->execute(@clonedata);
1476 }
1477 # And now the reverse records
1478 $sth2 = $dbh->prepare("SELECT group_id,host,type,val,ttl FROM default_rev_records WHERE group_id=?");
1479 $sth2->execute($pargroup);
1480 while (my @clonedata = $sth2->fetchrow_array) {
1481 $sthr->execute(@clonedata);
1482 }
1483 } else {
1484##fixme: Hardcoding is Bad, mmmmkaaaay?
1485 # reasonable basic defaults for SOA, MX, NS, and minimal hosting
1486 # could load from a config file, but somewhere along the line we need hardcoded bits.
1487 $sthf->execute('ns1.example.com:hostmaster.example.com', 6, '10800:3600:604800:10800', 0, 0, 0, 86400);
1488 $sthf->execute('DOMAIN', 1, '192.168.4.2', 0, 0, 0, 7200);
1489 $sthf->execute('DOMAIN', 15, 'mx.example.com', 10, 0, 0, 7200);
1490 $sthf->execute('DOMAIN', 2, 'ns1.example.com', 0, 0, 0, 7200);
1491 $sthf->execute('DOMAIN', 2, 'ns2.example.com', 0, 0, 0, 7200);
1492 $sthf->execute('www.DOMAIN', 5, 'DOMAIN', 0, 0, 0, 7200);
1493 # reasonable basic defaults for generic reverse zone. Same as initial SQL tabledef.
1494 $sthr->execute('hostmaster.ADMINDOMAIN:ns1.ADMINDOMAIN', 6, '10800:3600:604800:10800', 86400);
1495 $sthr->execute('unused-%r.ADMINDOMAIN', 65283, 'ZONE', 3600);
1496 }
1497
1498 # once we get here, we should have suceeded.
1499 $dbh->commit;
1500 }; # end eval
1501
1502 if ($@) {
1503 my $msg = $@;
1504 eval { $dbh->rollback; };
1505 return ('FAIL',$msg);
1506 } else {
1507 return ('OK','OK');
1508 }
1509
1510} # end addGroup()
1511
1512
1513## DNSDB::delGroup()
1514# Delete a group.
1515# Takes a group ID
1516# Returns a status code and message
1517sub delGroup {
1518 my $dbh = shift;
1519 my $groupid = shift;
1520
1521 # Allow transactions, and raise an exception on errors so we can catch it later.
1522 # Use local to make sure these get "reset" properly on exiting this block
1523 local $dbh->{AutoCommit} = 0;
1524 local $dbh->{RaiseError} = 1;
1525
1526##fixme: locate "knowable" error conditions and deal with them before the eval
1527# ... or inside, whatever.
1528# -> domains still exist in group
1529# -> ...
1530 my $failmsg = '';
1531
1532 # Wrap all the SQL in a transaction
1533 eval {
1534 my $sth = $dbh->prepare("SELECT count(*) FROM domains WHERE group_id=?");
1535 $sth->execute($groupid);
1536 my ($domcnt) = $sth->fetchrow_array;
1537 $failmsg = "Can't remove group ".groupName($dbh,$groupid);
1538 die "$domcnt domains still in group\n" if $domcnt;
1539
1540 $sth = $dbh->prepare("delete from default_records where group_id=?");
1541 $failmsg = "Failed to delete default records for ".groupName($dbh,$groupid);
1542 $sth->execute($groupid);
1543 $sth = $dbh->prepare("delete from groups where group_id=?");
1544 $failmsg = "Failed to remove group ".groupName($dbh,$groupid);
1545 $sth->execute($groupid);
1546
1547 # once we get here, we should have suceeded.
1548 $dbh->commit;
1549 }; # end eval
1550
1551 if ($@) {
1552 my $msg = $@;
1553 eval { $dbh->rollback; };
1554 return ('FAIL',"$failmsg: $msg");
1555 } else {
1556 return ('OK','OK');
1557 }
1558} # end delGroup()
1559
1560
1561## DNSDB::getChildren()
1562# Get a list of all groups whose parent^n is group <n>
1563# Takes a database handle, group ID, reference to an array to put the group IDs in,
1564# and an optional flag to return only immediate children or all children-of-children
1565# default to returning all children
1566# Calls itself
1567sub getChildren {
1568 $errstr = '';
1569 my $dbh = shift;
1570 my $rootgroup = shift;
1571 my $groupdest = shift;
1572 my $immed = shift || 'all';
1573
1574 # special break for default group; otherwise we get stuck.
1575 if ($rootgroup == 1) {
1576 # by definition, group 1 is the Root Of All Groups
1577 my $sth = $dbh->prepare("SELECT group_id FROM groups WHERE NOT (group_id=1)".
1578 ($immed ne 'all' ? " AND parent_group_id=1" : ''));
1579 $sth->execute;
1580 while (my @this = $sth->fetchrow_array) {
1581 push @$groupdest, @this;
1582 }
1583 } else {
1584 my $sth = $dbh->prepare("SELECT group_id FROM groups WHERE parent_group_id=?");
1585 $sth->execute($rootgroup);
1586 return if $sth->rows == 0;
1587 my @grouplist;
1588 while (my ($group) = $sth->fetchrow_array) {
1589 push @$groupdest, $group;
1590 getChildren($dbh,$group,$groupdest) if $immed eq 'all';
1591 }
1592 }
1593} # end getChildren()
1594
1595
1596## DNSDB::groupName()
1597# Return the group name based on a group ID
1598# Takes a database handle and the group ID
1599# Returns the group name or undef on failure
1600sub groupName {
1601 $errstr = '';
1602 my $dbh = shift;
1603 my $groupid = shift;
1604 my $sth = $dbh->prepare("SELECT group_name FROM groups WHERE group_id=?");
1605 $sth->execute($groupid);
1606 my ($groupname) = $sth->fetchrow_array();
1607 $errstr = $DBI::errstr if !$groupname;
1608 return $groupname if $groupname;
1609} # end groupName
1610
1611
1612## DNSDB::groupID()
1613# Return the group ID based on the group name
1614# Takes a database handle and the group name
1615# Returns the group ID or undef on failure
1616sub groupID {
1617 $errstr = '';
1618 my $dbh = shift;
1619 my $group = shift;
1620 my ($grpid) = $dbh->selectrow_array("SELECT group_id FROM groups WHERE group=?", undef, ($group) );
1621 $errstr = $DBI::errstr if !$grpid;
1622 return $grpid if $grpid;
1623} # end groupID()
1624
1625
1626## DNSDB::addUser()
1627# Add a user.
1628# Takes a DB handle, username, group ID, password, state (active/inactive).
1629# Optionally accepts:
1630# user type (user/admin) - defaults to user
1631# permissions string - defaults to inherit from group
1632# three valid forms:
1633# i - Inherit permissions
1634# c:<user_id> - Clone permissions from <user_id>
1635# C:<permission list> - Set these specific permissions
1636# first name - defaults to username
1637# last name - defaults to blank
1638# phone - defaults to blank (could put other data within column def)
1639# Returns (OK,<uid>) on success, (FAIL,<message>) on failure
1640sub addUser {
1641 $errstr = '';
1642 my $dbh = shift;
1643 my $username = shift;
1644 my $group = shift;
1645 my $pass = shift;
1646 my $state = shift;
1647
1648 return ('FAIL', "Missing one or more required entries") if !defined($state);
1649 return ('FAIL', "Username must not be blank") if !$username;
1650
1651 my $type = shift || 'u'; # create limited users by default - fwiw, not sure yet how this will interact with ACLs
1652
1653 my $permstring = shift || 'i'; # default is to inhert permissions from group
1654
1655 my $fname = shift || $username;
1656 my $lname = shift || '';
1657 my $phone = shift || ''; # not going format-check
1658
1659 my $sth = $dbh->prepare("SELECT user_id FROM users WHERE username=?");
1660 my $user_id;
1661
1662# quick check to start to see if we've already got one
1663 $sth->execute($username);
1664 ($user_id) = $sth->fetchrow_array;
1665
1666 return ('FAIL', "User already exists") if $user_id;
1667
1668 # Allow transactions, and raise an exception on errors so we can catch it later.
1669 # Use local to make sure these get "reset" properly on exiting this block
1670 local $dbh->{AutoCommit} = 0;
1671 local $dbh->{RaiseError} = 1;
1672
1673 my $failmsg = '';
1674
1675 # Wrap all the SQL in a transaction
1676 eval {
1677 # insert the user... note we set inherited perms by default since
1678 # it's simple and cleans up some other bits of state
1679 my $sth = $dbh->prepare("INSERT INTO users ".
1680 "(group_id,username,password,firstname,lastname,phone,type,status,permission_id,inherit_perm) ".
1681 "VALUES (?,?,?,?,?,?,?,?,(SELECT permission_id FROM permissions WHERE group_id=?),'t')");
1682 $sth->execute($group,$username,unix_md5_crypt($pass),$fname,$lname,$phone,$type,$state,$group);
1683
1684 # get the ID...
1685 ($user_id) = $dbh->selectrow_array("SELECT currval('users_user_id_seq')");
1686
1687# Permissions! Gotta set'em all!
1688 die "Invalid permission string $permstring"
1689 if $permstring !~ /^(?:
1690 i # inherit
1691 |c:\d+ # clone
1692 # custom. no, the leading , is not a typo
1693 |C:(?:,(?:group|user|domain|record|self)_(?:edit|create|delete))*
1694 )$/x;
1695# bleh. I'd call another function to do my dirty work, but we're in the middle of a transaction already.
1696 if ($permstring ne 'i') {
1697 # for cloned or custom permissions, we have to create a new permissions entry.
1698 my $clonesrc = $group;
1699 if ($permstring =~ /^c:(\d+)/) { $clonesrc = $1; }
1700 $dbh->do("INSERT INTO permissions ($permlist,user_id) ".
1701 "SELECT $permlist,? FROM permissions WHERE permission_id=".
1702 "(SELECT permission_id FROM permissions WHERE ".($permstring =~ /^c:/ ? 'user' : 'group')."_id=?)",
1703 undef, ($user_id,$clonesrc) );
1704 $dbh->do("UPDATE users SET permission_id=".
1705 "(SELECT permission_id FROM permissions WHERE user_id=?) ".
1706 "WHERE user_id=?", undef, ($user_id, $user_id) );
1707 }
1708 if ($permstring =~ /^C:/) {
1709 # finally for custom permissions, we set the passed-in permissions (and unset
1710 # any that might have been brought in by the clone operation above)
1711 my ($permid) = $dbh->selectrow_array("SELECT permission_id FROM permissions WHERE user_id=?",
1712 undef, ($user_id) );
1713 foreach (@permtypes) {
1714 if ($permstring =~ /,$_/) {
1715 $dbh->do("UPDATE permissions SET $_='t' WHERE permission_id=?", undef, ($permid) );
1716 } else {
1717 $dbh->do("UPDATE permissions SET $_='f' WHERE permission_id=?", undef, ($permid) );
1718 }
1719 }
1720 }
1721
1722 $dbh->do("UPDATE users SET inherit_perm='n' WHERE user_id=?", undef, ($user_id) );
1723
1724##fixme: add another table to hold name/email for log table?
1725
1726 # once we get here, we should have suceeded.
1727 $dbh->commit;
1728 }; # end eval
1729
1730 if ($@) {
1731 my $msg = $@;
1732 eval { $dbh->rollback; };
1733 return ('FAIL',$msg." $failmsg");
1734 } else {
1735 return ('OK',$user_id);
1736 }
1737} # end addUser
1738
1739
1740## DNSDB::checkUser()
1741# Check user/pass combo on login
1742sub checkUser {
1743 my $dbh = shift;
1744 my $user = shift;
1745 my $inpass = shift;
1746
1747 my $sth = $dbh->prepare("SELECT user_id,group_id,password,firstname,lastname FROM users WHERE username=?");
1748 $sth->execute($user);
1749 my ($uid,$gid,$pass,$fname,$lname) = $sth->fetchrow_array;
1750 my $loginfailed = 1 if !defined($uid);
1751
1752 if ($pass =~ m|^\$1\$([A-Za-z0-9/.]+)\$|) {
1753 $loginfailed = 1 if $pass ne unix_md5_crypt($inpass,$1);
1754 } else {
1755 $loginfailed = 1 if $pass ne $inpass;
1756 }
1757
1758 # nnnngggg
1759 return ($uid, $gid);
1760} # end checkUser
1761
1762
1763## DNSDB:: updateUser()
1764# Update general data about user
1765sub updateUser {
1766 my $dbh = shift;
1767
1768##fixme: tweak calling convention so that we can update any given bit of data
1769 my $uid = shift;
1770 my $username = shift;
1771 my $group = shift;
1772 my $pass = shift;
1773 my $state = shift;
1774 my $type = shift || 'u';
1775 my $fname = shift || $username;
1776 my $lname = shift || '';
1777 my $phone = shift || ''; # not going format-check
1778
1779 my $failmsg = '';
1780
1781 # Allow transactions, and raise an exception on errors so we can catch it later.
1782 # Use local to make sure these get "reset" properly on exiting this block
1783 local $dbh->{AutoCommit} = 0;
1784 local $dbh->{RaiseError} = 1;
1785
1786 my $sth;
1787
1788 # Password can be left blank; if so we assume there's one on file.
1789 # Actual blank passwords are bad, mm'kay?
1790 if (!$pass) {
1791 $sth = $dbh->prepare("SELECT password FROM users WHERE user_id=?");
1792 $sth->execute($uid);
1793 ($pass) = $sth->fetchrow_array;
1794 } else {
1795 $pass = unix_md5_crypt($pass);
1796 }
1797
1798 eval {
1799 my $sth = $dbh->prepare(q(
1800 UPDATE users
1801 SET username=?, password=?, firstname=?, lastname=?, phone=?, type=?, status=?
1802 WHERE user_id=?
1803 )
1804 );
1805 $sth->execute($username, $pass, $fname, $lname, $phone, $type, $state, $uid);
1806 $dbh->commit;
1807 };
1808 if ($@) {
1809 my $msg = $@;
1810 eval { $dbh->rollback; };
1811 return ('FAIL',"$failmsg: $msg");
1812 } else {
1813 return ('OK','OK');
1814 }
1815} # end updateUser()
1816
1817
1818## DNSDB::delUser()
1819#
1820sub delUser {
1821 my $dbh = shift;
1822 return ('FAIL',"Need database handle") if !$dbh;
1823 my $userid = shift;
1824 return ('FAIL',"Missing userid") if !defined($userid);
1825
1826 my $sth = $dbh->prepare("delete from users where user_id=?");
1827 $sth->execute($userid);
1828
1829 return ('FAIL',"Couldn't remove user: ".$sth->errstr) if $sth->err;
1830
1831 return ('OK','OK');
1832
1833} # end delUser
1834
1835
1836## DNSDB::userFullName()
1837# Return a pretty string!
1838# Takes a user_id and optional printf-ish string to indicate which pieces where:
1839# %u for the username
1840# %f for the first name
1841# %l for the last name
1842# All other text in the passed string will be left as-is.
1843##fixme: need a "smart" option too, so that missing/null/blank first/last names don't give funky output
1844sub userFullName {
1845 $errstr = '';
1846 my $dbh = shift;
1847 my $userid = shift;
1848 my $fullformat = shift || '%f %l (%u)';
1849 my $sth = $dbh->prepare("select username,firstname,lastname from users where user_id=?");
1850 $sth->execute($userid);
1851 my ($uname,$fname,$lname) = $sth->fetchrow_array();
1852 $errstr = $DBI::errstr if !$uname;
1853
1854 $fullformat =~ s/\%u/$uname/g;
1855 $fullformat =~ s/\%f/$fname/g;
1856 $fullformat =~ s/\%l/$lname/g;
1857
1858 return $fullformat;
1859} # end userFullName
1860
1861
1862## DNSDB::userStatus()
1863# Sets and/or returns a user's status
1864# Takes a database handle, user ID and optionally a status argument
1865# Returns undef on errors.
1866sub userStatus {
1867 my $dbh = shift;
1868 my $id = shift;
1869 my $newstatus = shift;
1870
1871 return undef if $id !~ /^\d+$/;
1872
1873 my $sth;
1874
1875# ooo, fun! let's see what we were passed for status
1876 if ($newstatus) {
1877 $sth = $dbh->prepare("update users set status=? where user_id=?");
1878 # ass-u-me caller knows what's going on in full
1879 if ($newstatus =~ /^[01]$/) { # only two valid for now.
1880 $sth->execute($newstatus,$id);
1881 } elsif ($newstatus =~ /^usero(?:n|ff)$/) {
1882 $sth->execute(($newstatus eq 'useron' ? 1 : 0),$id);
1883 }
1884 }
1885
1886 $sth = $dbh->prepare("select status from users where user_id=?");
1887 $sth->execute($id);
1888 my ($status) = $sth->fetchrow_array;
1889 return $status;
1890} # end userStatus()
1891
1892
1893## DNSDB::getUserData()
1894# Get misc user data for display
1895sub getUserData {
1896 my $dbh = shift;
1897 my $uid = shift;
1898
1899 my $sth = $dbh->prepare("SELECT group_id,username,firstname,lastname,phone,type,status,inherit_perm ".
1900 "FROM users WHERE user_id=?");
1901 $sth->execute($uid);
1902 return $sth->fetchrow_hashref();
1903
1904} # end getUserData()
1905
1906
1907## DNSDB::getSOA()
1908# Return all suitable fields from an SOA record in separate elements of a hash
1909# Takes a database handle, default/live flag, domain/reverse flag, and parent ID
1910sub getSOA {
1911 $errstr = '';
1912 my $dbh = shift;
1913 my $def = shift;
1914 my $rev = shift;
1915 my $id = shift;
1916 my %ret;
1917
1918 # (ab)use distance and weight columns to store SOA data? can't for default_rev_records...
1919 # - should really attach serial to the zone parent somewhere
1920
1921 my $sql = "SELECT record_id,host,val,ttl from "._rectable($def,$rev).
1922 " WHERE "._recparent($def,$rev)." = ? AND type=$reverse_typemap{SOA}";
1923
1924 my $sth = $dbh->prepare($sql);
1925 $sth->execute($id);
1926##fixme: stick a flag somewhere if the record doesn't exist. by the API, this is an impossible case, but...
1927
1928 my ($recid,$host,$val,$ttl) = $sth->fetchrow_array() or return;
1929 my ($contact,$prins) = split /:/, $host;
1930 my ($refresh,$retry,$expire,$minttl) = split /:/, $val;
1931
1932 $ret{recid} = $recid;
1933 $ret{ttl} = $ttl;
1934# $ret{serial} = $serial; # ca't use distance for serial with default_rev_records
1935 $ret{prins} = $prins;
1936 $ret{contact} = $contact;
1937 $ret{refresh} = $refresh;
1938 $ret{retry} = $retry;
1939 $ret{expire} = $expire;
1940 $ret{minttl} = $minttl;
1941
1942 return %ret;
1943} # end getSOA()
1944
1945
1946## DNSDB::updateSOA()
1947# Update the specified SOA record
1948# Takes a database handle, default/live flag, forward/reverse flag, and SOA data hash
1949sub updateSOA {
1950 my $dbh = shift;
1951 my $defrec = shift;
1952 my $revrec = shift;
1953
1954 my %soa = @_;
1955
1956##fixme: data validation: make sure {recid} is really the SOA for {parent}
1957 my $sql = "UPDATE "._rectable($defrec, $revrec)." SET host=?, val=?, ttl=? WHERE record_id=? AND type=6";
1958 $dbh->do($sql, undef, ("$soa{contact}:$soa{prins}", "$soa{refresh}:$soa{retry}:$soa{expire}:$soa{minttl}",
1959 $soa{ttl}, $soa{recid}));
1960
1961} # end updateSOA()
1962
1963
1964## DNSDB::getRecLine()
1965# Return all data fields for a zone record in separate elements of a hash
1966# Takes a database handle, default/live flag, forward/reverse flag, and record ID
1967sub getRecLine {
1968 $errstr = '';
1969 my $dbh = shift;
1970 my $defrec = shift;
1971 my $revrec = shift;
1972 my $id = shift;
1973
1974 my $sql = "SELECT record_id,host,type,val,ttl".($revrec eq 'n' ? ',distance,weight,port' : '').
1975 (($defrec eq 'y') ? ',group_id FROM ' : ',domain_id,rdns_id FROM ').
1976 _rectable($defrec,$revrec)." WHERE record_id=?";
1977 my $ret = $dbh->selectrow_hashref($sql, undef, ($id) );
1978
1979 if ($dbh->err) {
1980 $errstr = $DBI::errstr;
1981 return undef;
1982 }
1983
1984 if (!$ret) {
1985 $errstr = "No such record";
1986 return undef;
1987 }
1988
1989 # explicitly set a parent id
1990 if ($defrec eq 'y') {
1991 $ret->{parid} = $ret->{group_id};
1992 } else {
1993 $ret->{parid} = (($revrec eq 'n') ? $ret->{domain_id} : $ret->{rdns_id});
1994 # and a secondary if we have a custom type that lives in both a forward and reverse zone
1995 $ret->{secid} = (($revrec eq 'y') ? $ret->{domain_id} : $ret->{rdns_id}) if $ret->{type} > 65279;
1996 }
1997
1998 return $ret;
1999}
2000
2001
2002##fixme: should use above (getRecLine()) to get lines for below?
2003## DNSDB::getDomRecs()
2004# Return records for a domain
2005# Takes a database handle, default/live flag, group/domain ID, start,
2006# number of records, sort field, and sort order
2007# Returns a reference to an array of hashes
2008sub getDomRecs {
2009 $errstr = '';
2010 my $dbh = shift;
2011 my $def = shift;
2012 my $rev = shift;
2013 my $id = shift;
2014 my $nrecs = shift || 'all';
2015 my $nstart = shift || 0;
2016
2017## for order, need to map input to column names
2018 my $order = shift || 'host';
2019 my $direction = shift || 'ASC';
2020
2021 my $filter = shift || '';
2022
2023 my $sql = "SELECT r.record_id,r.host,r.type,r.val,r.ttl";
2024 $sql .= ",r.distance,r.weight,r.port" if $rev eq 'n';
2025 $sql .= " FROM "._rectable($def,$rev)." r ";
2026 $sql .= "INNER JOIN rectypes t ON r.type=t.val "; # for sorting by type alphabetically
2027 $sql .= "WHERE "._recparent($def,$rev)." = ?";
2028 $sql .= " AND NOT r.type=$reverse_typemap{SOA}";
2029 $sql .= " AND host ~* ?" if $filter;
2030 # use alphaorder column for "correct" ordering of sort-by-type instead of DNS RR type number
2031 $sql .= " ORDER BY ".($order eq 'type' ? 't.alphaorder' : "r.$order")." $direction";
2032
2033 my @bindvars = ($id);
2034 push @bindvars, $filter if $filter;
2035
2036 # just to be ultraparanoid about SQL injection vectors
2037 if ($nstart ne 'all') {
2038 $sql .= " LIMIT ? OFFSET ?";
2039 push @bindvars, $nrecs;
2040 push @bindvars, ($nstart*$nrecs);
2041 }
2042 my $sth = $dbh->prepare($sql) or warn $dbh->errstr;
2043 $sth->execute(@bindvars) or warn "$sql: ".$sth->errstr;
2044
2045 my @retbase;
2046 while (my $ref = $sth->fetchrow_hashref()) {
2047 push @retbase, $ref;
2048 }
2049
2050 my $ret = \@retbase;
2051 return $ret;
2052} # end getDomRecs()
2053
2054
2055## DNSDB::getRecCount()
2056# Return count of non-SOA records in zone (or default records in a group)
2057# Takes a database handle, default/live flag, reverse/forward flag, group/domain ID,
2058# and optional filtering modifier
2059# Returns the count
2060sub getRecCount {
2061 my $dbh = shift;
2062 my $defrec = shift;
2063 my $revrec = shift;
2064 my $id = shift;
2065 my $filter = shift || '';
2066
2067 # keep the nasties down, since we can't ?-sub this bit. :/
2068 # note this is chars allowed in DNS hostnames
2069 $filter =~ s/[^a-zA-Z0-9_.:-]//g;
2070
2071 my @bindvars = ($id);
2072 push @bindvars, $filter if $filter;
2073 my $sql = "SELECT count(*) FROM ".
2074 _rectable($defrec,$revrec).
2075 " WHERE "._recparent($defrec,$revrec)."=? ".
2076 "AND NOT type=$reverse_typemap{SOA}".
2077 ($filter ? " AND host ~* ?" : '');
2078 my ($count) = $dbh->selectrow_array($sql, undef, (@bindvars) );
2079
2080 return $count;
2081
2082} # end getRecCount()
2083
2084
2085## DNSDB::addRec()
2086# Add a new record to a domain or a group's default records
2087# Takes a database handle, default/live flag, group/domain ID,
2088# host, type, value, and TTL
2089# Some types require additional detail: "distance" for MX and SRV,
2090# and weight/port for SRV
2091# Returns a status code and detail message in case of error
2092##fixme: pass a hash with the record data, not a series of separate values
2093sub addRec {
2094 $errstr = '';
2095 my $dbh = shift;
2096 my $defrec = shift;
2097 my $revrec = shift;
2098 my $id = shift; # parent (group_id for defrecs, rdns_id for reverse records,
2099 # domain_id for domain records)
2100
2101 my $host = shift;
2102 my $rectype = shift; # reference so we can coerce it if "+"-types can't find both zones
2103 my $val = shift;
2104 my $ttl = shift;
2105
2106 # prep for validation
2107 my $addr = NetAddr::IP->new($$val);
2108 $$host =~ s/\.+$//; # FQDNs ending in . are an internal detail, and really shouldn't be exposed in the UI.
2109
2110 my $domid = 0;
2111 my $revid = 0;
2112
2113 my $retcode = 'OK'; # assume everything will go OK
2114 my $retmsg = '';
2115
2116 # do simple validation first
2117 return ('FAIL', "TTL must be numeric") unless $ttl =~ /^\d+$/;
2118
2119 # Quick check on hostname parts. Note the regex is more forgiving than the error message;
2120 # domain names technically are case-insensitive, and we use printf-like % codes for a couple
2121 # of types. Other things may also be added to validate default records of several flavours.
2122 return ('FAIL', "Hostnames may not contain anything other than (0-9 a-z . _)")
2123 if $defrec eq 'n' && $$host !~ /^[0-9a-z_%.]+$/i;
2124
2125 # Collect these even if we're only doing a simple A record so we can call *any* validation sub
2126 my $dist = shift;
2127 my $port = shift;
2128 my $weight = shift;
2129
2130 my $fields;
2131 my @vallist;
2132
2133 # Call the validation sub for the type requested.
2134 ($retcode,$retmsg) = $validators{$$rectype}($dbh, (defrec => $defrec, revrec => $revrec, id => $id,
2135 host => $host, rectype => $rectype, val => $val, addr => $addr,
2136 dist => \$dist, port => \$port, weight => \$weight,
2137 fields => \$fields, vallist => \@vallist) );
2138
2139 return ($retcode,$retmsg) if $retcode eq 'FAIL';
2140
2141 # Set up database fields and bind parameters
2142 $fields .= "host,type,val,ttl,"._recparent($defrec,$revrec);
2143 push @vallist, ($$host,$$rectype,$$val,$ttl,$id);
2144 my $vallen = '?'.(',?'x$#vallist);
2145
2146 # Allow transactions, and raise an exception on errors so we can catch it later.
2147 # Use local to make sure these get "reset" properly on exiting this block
2148 local $dbh->{AutoCommit} = 0;
2149 local $dbh->{RaiseError} = 1;
2150
2151 eval {
2152 $dbh->do("INSERT INTO "._rectable($defrec, $revrec)." ($fields) VALUES ($vallen)",
2153 undef, @vallist);
2154 $dbh->commit;
2155 };
2156 if ($@) {
2157 my $msg = $@;
2158 eval { $dbh->rollback; };
2159 return ('FAIL',$msg);
2160 }
2161
2162 return ($retcode, $retmsg);
2163
2164} # end addRec()
2165
2166
2167## DNSDB::updateRec()
2168# Update a record
2169sub updateRec {
2170 $errstr = '';
2171
2172 my $dbh = shift;
2173 my $defrec = shift;
2174 my $id = shift;
2175
2176# all records have these
2177 my $host = shift;
2178 my $type = shift;
2179 my $val = shift;
2180 my $ttl = shift;
2181
2182 return('FAIL',"Missing standard argument(s)") if !defined($ttl);
2183
2184# only MX and SRV will use these
2185 my $dist = 0;
2186 my $weight = 0;
2187 my $port = 0;
2188
2189 if ($type == $reverse_typemap{MX} || $type == $reverse_typemap{SRV}) {
2190 $dist = shift;
2191 $dist =~ s/\s+//g;
2192 return ('FAIL',"MX or SRV requires distance") if !defined($dist);
2193 return ('FAIL', "Distance must be numeric") unless $dist =~ /^\d+$/;
2194 if ($type == $reverse_typemap{SRV}) {
2195 $weight = shift;
2196 $weight =~ s/\s+//g;
2197 return ('FAIL',"SRV requires weight") if !defined($weight);
2198 return ('FAIL',"Weight must be numeric") unless $weight =~ /^\d+$/;
2199 $port = shift;
2200 $port =~ s/\s+//g;
2201 return ('FAIL',"SRV requires port") if !defined($port);
2202 return ('FAIL',"Port must be numeric") unless $port =~ /^\d+$/;
2203 }
2204 }
2205
2206# Enforce IP addresses on A and AAAA types
2207 my $addr = NetAddr::IP->new($val);
2208 if ($type == $reverse_typemap{A}) {
2209 return ('FAIL',$typemap{$type}." record must be a valid IPv4 address")
2210 unless $addr && !$addr->{isv6};
2211 }
2212 if ($type == $reverse_typemap{AAAA}) {
2213 return ('FAIL',$typemap{$type}." record must be a valid IPv6 address")
2214 unless $addr && $addr->{isv6};
2215 }
2216
2217# hmm.. this might work. except possibly for something pointing to "deadbeef.ca". <g>
2218# if ($type == $reverse_typemap{NS} || $type == $reverse_typemap{MX} || $type == $reverse_typemap{SRV}) {
2219# if ($val =~ /^\s*[\da-f:.]+\s*$/) {
2220# return ('FAIL',"$val is not a valid IP address") if !$addr;
2221# }
2222# }
2223
2224 local $dbh->{AutoCommit} = 0;
2225 local $dbh->{RaiseError} = 1;
2226
2227 eval {
2228 $dbh->do("UPDATE ".($defrec eq 'y' ? 'default_' : '')."records ".
2229 "SET host=?,val=?,type=?,ttl=?,distance=?,weight=?,port=? ".
2230 "WHERE record_id=?", undef, ($host, $val, $type, $ttl, $dist, $weight, $port, $id) );
2231 $dbh->commit;
2232 };
2233 if ($@) {
2234 my $msg = $@;
2235 $dbh->rollback;
2236 return ('FAIL', $msg);
2237 }
2238
2239 return ('OK','OK');
2240} # end updateRec()
2241
2242
2243## DNSDB::delRec()
2244# Delete a record.
2245sub delRec {
2246 $errstr = '';
2247 my $dbh = shift;
2248 my $defrec = shift;
2249 my $revrec = shift;
2250 my $id = shift;
2251
2252 my $sth = $dbh->prepare("DELETE FROM "._rectable($defrec,$revrec)." WHERE record_id=?");
2253 $sth->execute($id);
2254
2255 return ('FAIL',"Couldn't remove record: ".$sth->errstr) if $sth->err;
2256
2257 return ('OK','OK');
2258} # end delRec()
2259
2260
2261 # Reference hashes.
2262my %par_tbl = (
2263 group => 'groups',
2264 user => 'users',
2265 defrec => 'default_records',
2266 defrevrec => 'default_rev_records',
2267 domain => 'domains',
2268 revzone => 'revzones',
2269 record => 'records'
2270 );
2271my %id_col = (
2272 group => 'group_id',
2273 user => 'user_id',
2274 defrec => 'record_id',
2275 defrevrec => 'record_id',
2276 domain => 'domain_id',
2277 revzone => 'rdns_id',
2278 record => 'record_id'
2279 );
2280my %par_col = (
2281 group => 'parent_group_id',
2282 user => 'group_id',
2283 defrec => 'group_id',
2284 defrevrec => 'group_id',
2285 domain => 'group_id',
2286 revzone => 'group_id',
2287 record => 'domain_id'
2288 );
2289my %par_type = (
2290 group => 'group',
2291 user => 'group',
2292 defrec => 'group',
2293 defrevrec => 'group',
2294 domain => 'group',
2295 revzone => 'group',
2296 record => 'domain'
2297 );
2298
2299
2300## DNSDB::getTypelist()
2301# Get a list of record types for various UI dropdowns
2302# Takes database handle, forward/reverse/lookup flag, and optional "tag as selected" indicator (defaults to A)
2303# Returns an arrayref to list of hashrefs perfect for HTML::Template
2304sub getTypelist {
2305 my $dbh = shift;
2306 my $recgroup = shift;
2307 my $type = shift || $reverse_typemap{A};
2308
2309 # also accepting $webvar{revrec}!
2310 $recgroup = 'f' if $recgroup eq 'n';
2311 $recgroup = 'r' if $recgroup eq 'y';
2312
2313 my $sql = "SELECT val,name FROM rectypes WHERE ";
2314 if ($recgroup eq 'r') {
2315 # reverse zone types
2316 $sql .= "stdflag=2 OR stdflag=3";
2317 } elsif ($recgroup eq 'l') {
2318 # DNS lookup types. Note we avoid our custom types >= 65280, since those are entirely internal.
2319 $sql .= "(stdflag=1 OR stdflag=2 OR stdflag=3) AND val < 65280";
2320 } else {
2321 # default; forward zone types. technically $type eq 'f' but not worth the error message.
2322 $sql .= "stdflag=1 OR stdflag=2";
2323 }
2324 $sql .= " ORDER BY listorder";
2325
2326 my $sth = $dbh->prepare($sql);
2327 $sth->execute;
2328 my @typelist;
2329 while (my ($rval,$rname) = $sth->fetchrow_array()) {
2330 my %row = ( recval => $rval, recname => $rname );
2331 $row{tselect} = 1 if $rval == $type;
2332 push @typelist, \%row;
2333 }
2334
2335 # Add SOA on lookups since it's not listed in other dropdowns.
2336 if ($recgroup eq 'l') {
2337 my %row = ( recval => $reverse_typemap{SOA}, recname => 'SOA' );
2338 $row{tselect} = 1 if $reverse_typemap{SOA} == $type;
2339 push @typelist, \%row;
2340 }
2341
2342 return \@typelist;
2343} # end getTypelist()
2344
2345
2346## DNSDB::parentID()
2347# Get ID of entity that is nearest parent to requested id
2348# Takes a database handle and a hash of entity ID, entity type, optional parent type flag
2349# (domain/reverse zone or group), and optional default/live and forward/reverse flags
2350# Returns the ID or undef on failure
2351sub parentID {
2352 my $dbh = shift;
2353
2354 my %args = @_;
2355
2356 # clean up the parent-type. Set it to group if not set; coerce revzone to domain for simpler logic
2357 $args{partype} = 'group' if !$args{partype};
2358 $args{partype} = 'domain' if $args{partype} eq 'revzone';
2359
2360 # clean up defrec and revrec. default to live record, forward zone
2361 $args{defrec} = 'n' if !$args{defrec};
2362 $args{revrec} = 'n' if !$args{revrec};
2363
2364 if ($par_type{$args{partype}} eq 'domain') {
2365 # only live records can have a domain/zone parent
2366 return unless ($args{type} eq 'record' && $args{defrec} eq 'n');
2367 my $result = $dbh->selectrow_hashref("SELECT ".($args{revrec} eq 'n' ? 'domain_id' : 'rdns_id').
2368 " FROM records WHERE record_id = ?",
2369 undef, ($args{id}) ) or return;
2370 return $result;
2371 } else {
2372 # snag some arguments that will either fall through or be overwritten to save some code duplication
2373 my $tmpid = $args{id};
2374 my $type = $args{type};
2375 if ($type eq 'record' && $args{defrec} eq 'n') {
2376 # Live records go through the records table first.
2377 ($tmpid) = $dbh->selectrow_array("SELECT ".($args{revrec} eq 'n' ? 'domain_id' : 'rdns_id').
2378 " FROM records WHERE record_id = ?",
2379 undef, ($args{id}) ) or return;
2380 $type = ($args{revrec} eq 'n' ? 'domain' : 'revzone');
2381 }
2382 my ($result) = $dbh->selectrow_array("SELECT $par_col{$type} FROM $par_tbl{$type} WHERE $id_col{$type} = ?",
2383 undef, ($tmpid) );
2384 return $result;
2385 }
2386# should be impossible to get here with even remotely sane arguments
2387 return;
2388} # end parentID()
2389
2390
2391## DNSDB::isParent()
2392# Returns true if $id1 is a parent of $id2, false otherwise
2393sub isParent {
2394 my $dbh = shift;
2395 my $id1 = shift;
2396 my $type1 = shift;
2397 my $id2 = shift;
2398 my $type2 = shift;
2399##todo: immediate, secondary, full (default)
2400
2401 # Return false on invalid types
2402 return 0 if !grep /^$type1$/, ('record','defrec','defrevrec','user','domain','revzone','group');
2403 return 0 if !grep /^$type2$/, ('record','defrec','defrevrec','user','domain','revzone','group');
2404
2405 # Return false on impossible relations
2406 return 0 if $type1 eq 'record'; # nothing may be a child of a record
2407 return 0 if $type1 eq 'defrec'; # nothing may be a child of a record
2408 return 0 if $type1 eq 'defrevrec'; # nothing may be a child of a record
2409 return 0 if $type1 eq 'user'; # nothing may be child of a user
2410 return 0 if $type1 eq 'domain' && $type2 ne 'record'; # domain may not be a parent of anything other than a record
2411 return 0 if $type1 eq 'revzone' && $type2 ne 'record';# reverse zone may not be a parent of anything other than a record
2412
2413 # ennnhhhh.... if we're passed an id of 0, it will never be found. usual
2414 # case would be the UI creating a new <thing>, and so we don't have an ID for
2415 # <thing> to look up yet. in that case the UI should check the parent as well.
2416 return 0 if $id1 == 0; # nothing can have a parent id of 0
2417 return 1 if $id2 == 0; # anything could have a child id of 0 (or "unknown")
2418
2419 # group 1 is the ultimate root parent
2420 return 1 if $type1 eq 'group' && $id1 == 1;
2421
2422 # groups are always (a) parent of themselves
2423 return 1 if $type1 eq 'group' && $type2 eq 'group' && $id1 == $id2;
2424
2425 my $id = $id2;
2426 my $type = $type2;
2427 my $foundparent = 0;
2428
2429 # Records are the only entity with two possible parents. We need to split the parent checks on
2430 # domain/rdns.
2431 if ($type eq 'record') {
2432 my ($dom,$rdns) = $dbh->selectrow_array("SELECT domain_id,rdns_id FROM records WHERE record_id=?",
2433 undef, ($id));
2434 # check immediate parent against request
2435 return 1 if $type1 eq 'domain' && $id1 == $dom;
2436 return 1 if $type1 eq 'revzone' && $id1 == $rdns;
2437 # if request is group, check *both* parents. Only check if the parent is nonzero though.
2438 return 1 if $dom && isParent($dbh, $id1, $type1, $dom, 'domain');
2439 return 1 if $rdns && isParent($dbh, $id1, $type1, $rdns, 'revzone');
2440 # exit here since we've executed the loop below by proxy in the above recursive calls.
2441 return 0;
2442 }
2443
2444# almost the same loop as getParents() above
2445 my $limiter = 0;
2446 while (1) {
2447 my $sql = "SELECT $par_col{$type} FROM $par_tbl{$type} WHERE $id_col{$type} = ?";
2448 my $result = $dbh->selectrow_hashref($sql,
2449 undef, ($id) );
2450 if (!$result) {
2451 $limiter++;
2452##fixme: how often will this happen on a live site? fail at max limiter <n>?
2453 warn "no results looking for $sql with id $id (depth $limiter)\n";
2454 last;
2455 }
2456 if ($result && $result->{$par_col{$type}} == $id1) {
2457 $foundparent = 1;
2458 last;
2459 } else {
2460##fixme: do we care about trying to return a "no such record/domain/user/group" error?
2461# should be impossible to create an inconsistent DB just with API calls.
2462 warn $dbh->errstr." $sql, $id" if $dbh->errstr;
2463 }
2464 # group 1 is its own parent. need this here more to break strange loops than for detecting a parent
2465 last if $result->{$par_col{$type}} == 1;
2466 $id = $result->{$par_col{$type}};
2467 $type = $par_type{$type};
2468 }
2469
2470 return $foundparent;
2471} # end isParent()
2472
2473
2474## DNSDB::domStatus()
2475# Sets and/or returns a domain's status
2476# Takes a database handle, domain ID and optionally a status argument
2477# Returns undef on errors.
2478sub domStatus {
2479 my $dbh = shift;
2480 my $id = shift;
2481 my $newstatus = shift;
2482
2483 return undef if $id !~ /^\d+$/;
2484
2485 my $sth;
2486
2487# ooo, fun! let's see what we were passed for status
2488 if ($newstatus) {
2489 $sth = $dbh->prepare("update domains set status=? where domain_id=?");
2490 # ass-u-me caller knows what's going on in full
2491 if ($newstatus =~ /^[01]$/) { # only two valid for now.
2492 $sth->execute($newstatus,$id);
2493 } elsif ($newstatus =~ /^domo(?:n|ff)$/) {
2494 $sth->execute(($newstatus eq 'domon' ? 1 : 0),$id);
2495 }
2496 }
2497
2498 $sth = $dbh->prepare("select status from domains where domain_id=?");
2499 $sth->execute($id);
2500 my ($status) = $sth->fetchrow_array;
2501 return $status;
2502} # end domStatus()
2503
2504
2505## DNSDB::importAXFR
2506# Import a domain via AXFR
2507# Takes AXFR host, domain to transfer, group to put the domain in,
2508# and optionally:
2509# - active/inactive state flag (defaults to active)
2510# - overwrite-SOA flag (defaults to off)
2511# - overwrite-NS flag (defaults to off, doesn't affect subdomain NS records)
2512# Returns a status code (OK, WARN, or FAIL) and message - message should be blank
2513# if status is OK, but WARN includes conditions that are not fatal but should
2514# really be reported.
2515sub importAXFR {
2516 my $dbh = shift;
2517 my $ifrom_in = shift;
2518 my $domain = shift;
2519 my $group = shift;
2520 my $status = shift || 1;
2521 my $rwsoa = shift || 0;
2522 my $rwns = shift || 0;
2523
2524##fixme: add mode to delete&replace, merge+overwrite, merge new?
2525
2526 my $nrecs = 0;
2527 my $soaflag = 0;
2528 my $nsflag = 0;
2529 my $warnmsg = '';
2530 my $ifrom;
2531
2532 # choke on possible bad setting in ifrom
2533 # IPv4 and v6, and valid hostnames!
2534 ($ifrom) = ($ifrom_in =~ /^([0-9a-f\:.]+|[0-9a-z_.-]+)$/i);
2535 return ('FAIL', "Bad AXFR source host $ifrom")
2536 unless ($ifrom) = ($ifrom_in =~ /^([0-9a-f\:.]+|[0-9a-z_.-]+)$/i);
2537
2538 # Allow transactions, and raise an exception on errors so we can catch it later.
2539 # Use local to make sure these get "reset" properly on exiting this block
2540 local $dbh->{AutoCommit} = 0;
2541 local $dbh->{RaiseError} = 1;
2542
2543 my $sth = $dbh->prepare("SELECT domain_id FROM domains WHERE domain=?");
2544 my $dom_id;
2545
2546# quick check to start to see if we've already got one
2547 $sth->execute($domain);
2548 ($dom_id) = $sth->fetchrow_array;
2549
2550 return ('FAIL', "Domain already exists") if $dom_id;
2551
2552 eval {
2553 # can't do this, can't nest transactions. sigh.
2554 #my ($dcode, $dmsg) = addDomain(dbh, domain, group, status);
2555
2556##fixme: serial
2557 my $sth = $dbh->prepare("INSERT INTO domains (domain,group_id,status) VALUES (?,?,?)");
2558 $sth->execute($domain,$group,$status);
2559
2560## bizarre DBI<->Net::DNS interaction bug:
2561## sometimes a zone will cause an immediate commit-and-exit (sort of) of the while()
2562## fixed, apparently I was doing *something* odd, but not certain what it was that
2563## caused a commit instead of barfing
2564
2565 # get domain id so we can do the records
2566 $sth = $dbh->prepare("SELECT domain_id FROM domains WHERE domain=?");
2567 $sth->execute($domain);
2568 ($dom_id) = $sth->fetchrow_array();
2569
2570 my $res = Net::DNS::Resolver->new;
2571 $res->nameservers($ifrom);
2572 $res->axfr_start($domain)
2573 or die "Couldn't begin AXFR\n";
2574
2575 while (my $rr = $res->axfr_next()) {
2576 my $type = $rr->type;
2577
2578 my $sql = "INSERT INTO records (domain_id,host,type,ttl,val";
2579 my $vallen = "?,?,?,?,?";
2580
2581 $soaflag = 1 if $type eq 'SOA';
2582 $nsflag = 1 if $type eq 'NS';
2583
2584 my @vallist = ($dom_id, $rr->name, $reverse_typemap{$type}, $rr->ttl);
2585
2586# "Primary" types:
2587# A, NS, CNAME, SOA, PTR(warn in forward), MX, TXT, AAAA, SRV, A6(ob), SPF
2588# maybe KEY
2589
2590# nasty big ugly case-like thing here, since we have to do *some* different
2591# processing depending on the record. le sigh.
2592
2593##fixme: what record types other than TXT can/will have >255-byte payloads?
2594
2595 if ($type eq 'A') {
2596 push @vallist, $rr->address;
2597 } elsif ($type eq 'NS') {
2598# hmm. should we warn here if subdomain NS'es are left alone?
2599 next if ($rwns && ($rr->name eq $domain));
2600 push @vallist, $rr->nsdname;
2601 $nsflag = 1;
2602 } elsif ($type eq 'CNAME') {
2603 push @vallist, $rr->cname;
2604 } elsif ($type eq 'SOA') {
2605 next if $rwsoa;
2606 $vallist[1] = $rr->mname.":".$rr->rname;
2607 push @vallist, ($rr->refresh.":".$rr->retry.":".$rr->expire.":".$rr->minimum);
2608 $soaflag = 1;
2609 } elsif ($type eq 'PTR') {
2610 push @vallist, $rr->ptrdname;
2611 # hmm. PTR records should not be in forward zones.
2612 } elsif ($type eq 'MX') {
2613 $sql .= ",distance";
2614 $vallen .= ",?";
2615 push @vallist, $rr->exchange;
2616 push @vallist, $rr->preference;
2617 } elsif ($type eq 'TXT') {
2618##fixme: Net::DNS docs say this should be deprecated for rdatastr() or char_str_list(),
2619## but don't really seem enthusiastic about it.
2620 my $rrdata = $rr->txtdata;
2621 push @vallist, $rrdata;
2622 } elsif ($type eq 'SPF') {
2623##fixme: and the same caveat here, since it is apparently a clone of ::TXT
2624 my $rrdata = $rr->txtdata;
2625 push @vallist, $rrdata;
2626 } elsif ($type eq 'AAAA') {
2627 push @vallist, $rr->address;
2628 } elsif ($type eq 'SRV') {
2629 $sql .= ",distance,weight,port" if $type eq 'SRV';
2630 $vallen .= ",?,?,?" if $type eq 'SRV';
2631 push @vallist, $rr->target;
2632 push @vallist, $rr->priority;
2633 push @vallist, $rr->weight;
2634 push @vallist, $rr->port;
2635 } elsif ($type eq 'KEY') {
2636 # we don't actually know what to do with these...
2637 push @vallist, ($rr->flags.":".$rr->protocol.":".$rr->algorithm.":".$rr->key.":".$rr->keytag.":".$rr->privatekeyname);
2638 } else {
2639 my $rrdata = $rr->rdatastr;
2640 push @vallist, $rrdata;
2641 # Finding a different record type is not fatal.... just problematic.
2642 # We may not be able to export it correctly.
2643 $warnmsg .= "Unusual record ".$rr->name." ($type) found\n";
2644 }
2645
2646# BIND supports:
2647# A CNAME HINFO MB(ex) MD(ob) MF(ob) MG(ex) MINFO(ex) MR(ex) MX NS NULL
2648# PTR SOA TXT WKS AFSDB(ex) ISDN(ex) RP(ex) RT(ex) X25(ex) PX
2649# ... if one can ever find the right magic to format them correctly
2650
2651# Net::DNS supports:
2652# RRSIG SIG NSAP NS NIMLOC NAPTR MX MR MINFO MG MB LOC ISDN IPSECKEY HINFO
2653# EID DNAME CNAME CERT APL AFSDB AAAA A DS NXT NSEC3PARAM NSEC3 NSEC KEY
2654# DNSKEY DLV X25 TXT TSIG TKEY SSHFP SRV SPF SOA RT RP PX PTR NULL APL::AplItem
2655
2656 $sth = $dbh->prepare($sql.") VALUES (".$vallen.")") or die "problem preparing record insert SQL\n";
2657 $sth->execute(@vallist) or die "failed to insert ".$rr->string.": ".$sth->errstr."\n";
2658
2659 $nrecs++;
2660
2661 } # while axfr_next
2662
2663 # Overwrite SOA record
2664 if ($rwsoa) {
2665 $soaflag = 1;
2666 my $sthgetsoa = $dbh->prepare("SELECT host,val,ttl FROM default_records WHERE group_id=? AND type=?");
2667 my $sthputsoa = $dbh->prepare("INSERT INTO records (domain_id,host,type,val,ttl) VALUES (?,?,?,?,?)");
2668 $sthgetsoa->execute($group,$reverse_typemap{SOA});
2669 while (my ($host,$val,$ttl) = $sthgetsoa->fetchrow_array()) {
2670 $host =~ s/DOMAIN/$domain/g;
2671 $val =~ s/DOMAIN/$domain/g;
2672 $sthputsoa->execute($dom_id,$host,$reverse_typemap{SOA},$val,$ttl);
2673 }
2674 }
2675
2676 # Overwrite NS records
2677 if ($rwns) {
2678 $nsflag = 1;
2679 my $sthgetns = $dbh->prepare("SELECT host,val,ttl FROM default_records WHERE group_id=? AND type=?");
2680 my $sthputns = $dbh->prepare("INSERT INTO records (domain_id,host,type,val,ttl) VALUES (?,?,?,?,?)");
2681 $sthgetns->execute($group,$reverse_typemap{NS});
2682 while (my ($host,$val,$ttl) = $sthgetns->fetchrow_array()) {
2683 $host =~ s/DOMAIN/$domain/g;
2684 $val =~ s/DOMAIN/$domain/g;
2685 $sthputns->execute($dom_id,$host,$reverse_typemap{NS},$val,$ttl);
2686 }
2687 }
2688
2689 die "No records found; either $ifrom is not authoritative or doesn't allow transfers\n" if !$nrecs;
2690 die "Bad zone: No SOA record!\n" if !$soaflag;
2691 die "Bad zone: No NS records!\n" if !$nsflag;
2692
2693 $dbh->commit;
2694
2695 };
2696
2697 if ($@) {
2698 my $msg = $@;
2699 eval { $dbh->rollback; };
2700 return ('FAIL',$msg." $warnmsg");
2701 } else {
2702 return ('WARN', $warnmsg) if $warnmsg;
2703 return ('OK',"Imported OK");
2704 }
2705
2706 # it should be impossible to get here.
2707 return ('WARN',"OOOK!");
2708} # end importAXFR()
2709
2710
2711## DNSDB::export()
2712# Export the DNS database, or a part of it
2713# Takes database handle, export type, optional arguments depending on type
2714# Writes zone data to targets as appropriate for type
2715sub export {
2716 my $dbh = shift;
2717 my $target = shift;
2718
2719 if ($target eq 'tiny') {
2720 __export_tiny($dbh,@_);
2721 }
2722# elsif ($target eq 'foo') {
2723# __export_foo($dbh,@_);
2724#}
2725# etc
2726
2727} # end export()
2728
2729
2730## DNSDB::__export_tiny
2731# Internal sub to implement tinyDNS (compatible) export
2732# Takes database handle, filehandle to write export to, optional argument(s)
2733# to determine which data gets exported
2734sub __export_tiny {
2735 my $dbh = shift;
2736 my $datafile = shift;
2737
2738##fixme: slurp up further options to specify particular zone(s) to export
2739
2740 ## Convert a bare number into an octal-coded pair of octets.
2741 # Take optional arg to indicate a decimal or hex input. Defaults to hex.
2742 sub octalize {
2743 my $tmp = shift;
2744 my $srctype = shift || 'h'; # default assumes hex string
2745 $tmp = sprintf "%0.4x", hex($tmp) if $srctype eq 'h'; # 0-pad hex to 4 digits
2746 $tmp = sprintf "%0.4x", $tmp if $srctype eq 'd'; # 0-pad decimal to 4 hex digits
2747 my @o = ($tmp =~ /^(..)(..)$/); # split into octets
2748 return sprintf "\\%0.3o\\%0.3o", hex($o[0]), hex($o[1]);;
2749 }
2750
2751##fixme: fail if $datafile isn't an open, writable file
2752
2753 # easy case - export all evarything
2754 # not-so-easy case - export item(s) specified
2755 # todo: figure out what kind of list we use to export items
2756
2757 my $domsth = $dbh->prepare("SELECT domain_id,domain,status FROM domains WHERE status=1");
2758 my $recsth = $dbh->prepare("SELECT host,type,val,distance,weight,port,ttl ".
2759 "FROM records WHERE domain_id=?");
2760 $domsth->execute();
2761 while (my ($domid,$dom,$domstat) = $domsth->fetchrow_array) {
2762 $recsth->execute($domid);
2763 while (my ($host,$type,$val,$dist,$weight,$port,$ttl) = $recsth->fetchrow_array) {
2764##fixme: need to store location in the db, and retrieve it here.
2765# temporarily hardcoded to empty so we can include it further down.
2766my $loc = '';
2767
2768##fixme: record validity timestamp. tinydns supports fiddling with timestamps.
2769# note $ttl must be set to 0 if we want to use tinydns's auto-expiring timestamps.
2770# timestamps are TAI64
2771# ~~ 2^62 + time()
2772my $stamp = '';
2773
2774# raw packet in unknown format: first byte indicates length
2775# of remaining data, allows up to 255 raw bytes
2776
2777##fixme? append . to all host/val hostnames
2778 if ($typemap{$type} eq 'SOA') {
2779
2780 # host contains pri-ns:responsible
2781 # val is abused to contain refresh:retry:expire:minttl
2782##fixme: "manual" serial vs tinydns-autoserial
2783 # let's be explicit about abusing $host and $val
2784 my ($email, $primary) = (split /:/, $host)[0,1];
2785 my ($refresh, $retry, $expire, $min_ttl) = (split /:/, $val)[0,1,2,3];
2786 print $datafile "Z$dom:$primary:$email"."::$refresh:$retry:$expire:$min_ttl:$ttl:$stamp:$loc\n";
2787
2788 } elsif ($typemap{$type} eq 'A') {
2789
2790 print $datafile "+$host:$val:$ttl:$stamp:$loc\n";
2791
2792 } elsif ($typemap{$type} eq 'NS') {
2793
2794 print $datafile "\&$host"."::$val:$ttl:$stamp:$loc\n";
2795
2796 } elsif ($typemap{$type} eq 'AAAA') {
2797
2798 print $datafile ":$host:28:";
2799 my $altgrp = 0;
2800 my @altconv;
2801 # Split in to up to 8 groups of hex digits (allows for IPv6 :: 0-collapsing)
2802 foreach (split /:/, $val) {
2803 if (/^$/) {
2804 # flag blank entry; this is a series of 0's of (currently) unknown length
2805 $altconv[$altgrp++] = 's';
2806 } else {
2807 # call sub to convert 1-4 hex digits to 2 string-rep octal bytes
2808 $altconv[$altgrp++] = octalize($_)
2809 }
2810 }
2811 foreach my $octet (@altconv) {
2812 # if not 's', output
2813 print $datafile $octet unless $octet =~ /^s$/;
2814 # if 's', output (9-array length)x literal '\000\000'
2815 print $datafile '\000\000'x(9-$altgrp) if $octet =~ /^s$/;
2816 }
2817 print $datafile ":$ttl:$stamp:$loc\n";
2818
2819 } elsif ($typemap{$type} eq 'MX') {
2820
2821 print $datafile "\@$host"."::$val:$dist:$ttl:$stamp:$loc\n";
2822
2823 } elsif ($typemap{$type} eq 'TXT') {
2824
2825##fixme: split v-e-r-y long TXT strings? will need to do so for BIND export, at least
2826 $val =~ s/:/\\072/g; # may need to replace other symbols
2827 print $datafile "'$host:$val:$ttl:$stamp:$loc\n";
2828
2829# by-hand TXT
2830#:deepnet.cx:16:2v\075spf1\040a\040a\072bacon.deepnet.cx\040a\072home.deepnet.cx\040-all:3600
2831#@ IN TXT "v=spf1 a a:bacon.deepnet.cx a:home.deepnet.cx -all"
2832#'deepnet.cx:v=spf1 a a\072bacon.deepnet.cx a\072home.deepnet.cx -all:3600
2833
2834#txttest IN TXT "v=foo bar:bob kn;ob' \" !@#$%^&*()-=_+[]{}<>?"
2835#: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
2836
2837# very long TXT record as brought in by axfr-get
2838# note tinydns does not support >512-byte RR data, need axfr-dns (for TCP support) for that
2839# also note, tinydns does not seem to support <512, >256-byte RRdata from axfr-get either. :/
2840#:longtxt.deepnet.cx:16:
2841#\170this is a very long txt record. it is really long. long. very long. really very long. this is a very long txt record.
2842#\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.
2843#\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.
2844#:3600
2845
2846 } elsif ($typemap{$type} eq 'CNAME') {
2847
2848 print $datafile "C$host:$val:$ttl:$stamp:$loc\n";
2849
2850 } elsif ($typemap{$type} eq 'SRV') {
2851
2852 # data is two-byte values for priority, weight, port, in that order,
2853 # followed by length/string data
2854
2855 print $datafile ":$host:33:".octalize($dist,'d').octalize($weight,'d').octalize($port,'d');
2856
2857 $val .= '.' if $val !~ /\.$/;
2858 foreach (split /\./, $val) {
2859 printf $datafile "\\%0.3o%s", length($_), $_;
2860 }
2861 print $datafile "\\000:$ttl:$stamp:$loc\n";
2862
2863 } elsif ($typemap{$type} eq 'RP') {
2864
2865 # RP consists of two mostly free-form strings.
2866 # The first is supposed to be an email address with @ replaced by . (as with the SOA contact)
2867 # The second is the "hostname" of a TXT record with more info.
2868 print $datafile ":$host:17:";
2869 my ($who,$what) = split /\s/, $val;
2870 foreach (split /\./, $who) {
2871 printf $datafile "\\%0.3o%s", length($_), $_;
2872 }
2873 print $datafile '\000';
2874 foreach (split /\./, $what) {
2875 printf $datafile "\\%0.3o%s", length($_), $_;
2876 }
2877 print $datafile "\\000:$ttl:$stamp:$loc\n";
2878
2879 } elsif ($typemap{$type} eq 'PTR') {
2880
2881 # must handle both IPv4 and IPv6
2882##work
2883 # data should already be in suitable reverse order.
2884 print $datafile "^$host:$val:$ttl:$stamp:$loc\n";
2885
2886 } else {
2887 # raw record. we don't know what's in here, so we ASS-U-ME the user has
2888 # put it in correctly, since either the user is messing directly with the
2889 # database, or the record was imported via AXFR
2890 # <split by char>
2891 # convert anything not a-zA-Z0-9.- to octal coding
2892
2893##fixme: add flag to export "unknown" record types - note we'll probably end up
2894# mangling them since they were written to the DB from Net::DNS::RR::<type>->rdatastr.
2895 #print $datafile ":$host:$type:$val:$ttl:$stamp:$loc\n";
2896
2897 } # record type if-else
2898
2899 } # while ($recsth)
2900 } # while ($domsth)
2901} # end __export_tiny()
2902
2903
2904## DNSDB::mailNotify()
2905# Sends notification mail to recipients regarding an IPDB operation
2906sub mailNotify {
2907 my $dbh = shift;
2908 my ($subj,$message) = @_;
2909
2910 return if $config{mailhost} eq 'smtp.example.com'; # do nothing if still using default SMTP host.
2911
2912 my $mailer = Net::SMTP->new($config{mailhost}, Hello => "dnsadmin.$config{domain}");
2913
2914 my $mailsender = ($config{mailsender} ? $config{mailsender} : $config{mailnotify});
2915
2916 $mailer->mail($mailsender);
2917 $mailer->to($config{mailnotify});
2918 $mailer->data("From: \"$config{mailname}\" <$mailsender>\n",
2919 "To: <$config{mailnotify}>\n",
2920 "Date: ".strftime("%a, %d %b %Y %H:%M:%S %z",localtime)."\n",
2921 "Subject: $subj\n",
2922 "X-Mailer: DNSAdmin Notify v".sprintf("%.1d",$DNSDB::VERSION)."\n",
2923 "Organization: $config{orgname}\n",
2924 "\n$message\n");
2925 $mailer->quit;
2926}
2927
2928# shut Perl up
29291;
Note: See TracBrowser for help on using the repository browser.