| Net-DNS-SEC documentation | Contained in the Net-DNS-SEC distribution. |
Net::DNS::RR::DNSKEY - DNS DNSKEY resource record
use Net::DNS::RR;
Class for DNSSEC KEY (DNSKEY) resource records.
print "flags" = ", $rr->flags, "\n";
Returns the RR's flags in decimal representation
print "protocol" = ", $rr->protocol, "\n";
Returns the RR's protocol field in decimal representation
print "algoritm" = ", $rr->algorithm, "\n";
Returns the RR's algorithm field in decimal representation
1 = RSA/MD5
2 = DH
3 = DSA/SHA-1
4 = Elliptic Curve
5 = RSA/SHA-1
6 - DSA/SHA-1 (NSEC3)
7 - RSA/SHA-1 (NSEC3)
8 - RSA/SHA-256
10 - RSA/SHA-512
Note that only algorithm 1 and 3 are supported by the methods provided through Net::DNS::RR::SIG.pm.
print "key" = ", $rr->key, "\n";
Returns the key in base64 representation
$keybin = $rr->keybin;
Returns the key binary material
print "keytag" = ", $rr->keytag, "\n";
Returns the key tag of the key. (RFC2535 4.1.6)
$privatekeyname=$rr->privatekeyname
Returns the name of the privatekey as it would be generated by the BIND dnssec-keygen program. The format of that name being K\<fqdn\>+\<algorithm\>+\<keyid\>.private
is_sep() returns 1 if the secure entry point flag field is set, set_sep() sets secure entry point flag field is set and clear_sep() clears the value.
Return the length of a key.
For RSA this method returns the length (in bits) of the modulus.
For DSA this method returnse the value of the T parameter (See RFC2536)
Returns -1 if the keysize cannot be determined (e.g. for unknown algorithms algorithm).
Copyright (c) 2003-2005 RIPE NCC. Author Olaf M. Kolkman <olaf@net-dns.org>
All Rights Reserved
Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of the author not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission.
THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS; IN NO EVENT SHALL AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
Based on, and contains, code by Copyright (c) 1997 Michael Fuhr.
perl(1), Net::DNS, Net::DNS::Resolver, Net::DNS::Packet, Net::DNS::Header, Net::DNS::Question, Net::DNS::RR, RFC 4033, RFC 4034, RFC 4035.
| Net-DNS-SEC documentation | Contained in the Net-DNS-SEC distribution. |
package Net::DNS::RR::DNSKEY; # $Id: DNSKEY.pm 847 2010-03-12 13:04:13Z olaf $ use strict; use vars qw(@ISA $VERSION); use bytes; use Net::DNS::SEC; use MIME::Base64; use Carp; @ISA = qw(Net::DNS::RR Net::DNS::SEC); $VERSION = do { my @r=(q$Revision: 847 $=~/\d+/g); sprintf "%d."."%03d"x$#r,@r }; sub new { my ($class, $self, $data, $offset) = @_; bless $self, $class; if ($self->{"rdlength"} > 0) { my $offsettoprot=$offset+2; my $offsettoalg=$offset+3; my $offsettokey=$offset+4; $self->{"flags"}=unpack("n",substr($$data,$offset,2)); $self->{"protocol"}=unpack("C",substr($$data,$offsettoprot,1)); $self->{"algorithm"}=unpack("C",substr($$data,$offsettoalg,1)); my $keymaterial=substr($$data,$offsettokey,$self->{"rdlength"}-4); $self->{"keybin"}=($keymaterial); $self->{"key"}= encode_base64($keymaterial); } bless $self, $class; $self->setkeytag; return $self; } sub new_from_string { my ($class, $self, $string) = @_; if ($string) { $string =~ tr/()//d; $string =~ s/;.*$//mg; $string =~ s/\n//mg; my ($flags, $protocol, $algorithm,$key) = $string =~ /^\s*(\S+)\s+(\S+)\s+(\S+)\s+(.*)/; $key =~ s/\s*//g; $self->{"flags"}=$flags; $self->{"algorithm"}=Net::DNS::SEC->algorithm($algorithm); $self->{"protocol"}=$protocol; my $keymaterial=decode_base64($key); $self->{"keybin"}=($keymaterial); $self->{"key"}=$key; } bless $self, $class; $self->setkeytag(); return $self; } sub rdatastr { my $self = shift; my $rdatastr; if (exists $self->{"flags"}) { $rdatastr = $self->{flags}; $rdatastr .= " " . "$self->{protocol}"; $rdatastr .= " " . $self->algorithm; $rdatastr .= " ( \n" ; # do some nice formatting my $keystring=$self->{key}; $keystring =~ s/\n//g; $keystring =~ s/(\S{36})/$1\n\t\t\t/g; $rdatastr .= "\t\t\t".$keystring; $rdatastr .= " \n\t\t\t) ; Key ID = " . "$self->{keytag}"; } else { $rdatastr = "; no data"; } return $rdatastr; } sub rr_rdata { my $self = shift; my $rdata; if (exists $self->{"flags"}) { $rdata= pack("n",$self->{"flags"}) ; $rdata.= pack("C2",$self->{"protocol"} , $self->algorithm) ; $rdata.= $self->{"keybin"} } return $rdata; } sub setkeytag { my $self=shift; if (($self->{"flags"} & hex("0xc000") ) == hex("0xc000") ){ # NULL KEY $self->{"keytag"} = 0; }elsif ($self->algorithm == '1'){ # RFC 2535 4.1.6 most significant 16 bits of the least # significant 24 bits my @keystr=split //, $self->{"keybin"}; my $keysize= $#keystr+1; $self->{"keytag"} = (unpack("C",$keystr[$keysize - 3]) << 8) + unpack("C",$keystr[$keysize - 2]); 0; }else{ # All others # RFC 2535 Appendix C my ($ac, $i); # $self->{"rr_data"} cannot be # used if the object has not been constructed ?!? my $rdata= pack("n",$self->{"flags"}) ; $rdata.= pack("C2",$self->{"protocol"} , $self->algorithm) ; $rdata.= $self->{"keybin"}; my @keyrr=split //, $rdata; for ( $ac=0 , $i=0; $i <= $#keyrr ; $i++ ){ $ac += ($i & 1) ? unpack("C",$keyrr[$i]) : unpack("C", $keyrr[$i])<<8; } $ac += ($ac>>16) & 0xFFFF; $self->{"keytag"} =($ac & 0xFFFF); 0; } } sub set_sep { my $self=shift; return $self->is_sep if $self->is_sep; $self->{"flags"}+=1; $self->setkeytag; return if $self->is_sep; } sub unset_sep { my $self=shift; return $self->clear_sep(); } sub clear_sep { my $self=shift; return $self->is_sep if ! $self->is_sep; $self->{"flags"}-=1; $self->setkeytag; return $self->is_sep; } sub is_sep { my $self=shift; return $self->{"flags"} % 2; # Hey it;s odd. } sub privatekeyname { my $self=shift; return sprintf("K%s.+%03d+%05d.private", $self->name, $self->algorithm, $self->keytag); } # Return the length in bits of a RSA key and DSA key (crypto speaking) # -1 if it's not a know algorithm # RSA part contributed by Hugo Salgado <hsalgado@nic.cl> sub keylength { my $self = shift; if ( $self->algorithm("mnemonic") =~ /RSA/ ){ # Modulus length, see RFC 2537 # First we need the total length in the wire rdata my $total = length(unpack("B*",$self->{"keybin"})); # Now we obtain the first octet (exponent length) my $octet = unpack("B8", $self->{"keybin"}); my $expo_length; # If the first octet is zero, we need the next two if ($octet == 0) { # This part is untested. I couldn't create a real key test case :( $octet = unpack("B24", $self->{"keybin"}); $expo_length = unpack("N", pack("B32", substr("0" x 8 . $octet, -24))); $expo_length += 3; # we add the 3 octets with the length } else { $expo_length = unpack("N", pack("B32", substr("0" x 32 . $octet, -32))); $expo_length++; # we add the first octet } # The modulus is the remaining, in bits return $total - ($expo_length*8); }elsif ( $self->algorithm("mnemonic") =~ /DSA/ ) { # T parameter see RFC 2536 return unpack("C", $self->{"keybin"}); }else { return -1; } } 1;