1Net::DNS::SEC::Private(U3s)er Contributed Perl DocumentatNieotn::DNS::SEC::Private(3)
2
3
4
6 Net::DNS::SEC::Private - DNSSEC Private key object
7
9 use Net::DNS::SEC::Private;
10
11 $private = new Net::DNS::SEC::Private( $keypath );
12
13 $private = new Net::DNS::SEC::Private(
14 'algorithm' => '13',
15 'keytag' => '26512',
16 'privatekey' => 'h/mc+iq9VDUbNAjQgi8S8JzlEX29IALchwJmNM3QYKk=',
17 'signame' => 'example.com.'
18 );
19
21 Class representing private keys as read from a keyfile generated by
22 BIND dnssec-keygen. The class is written to be used only in the context
23 of the Net::DNS::RR::RRSIG create method. This class is not designed to
24 interact with any other system.
25
27 new (from private keyfile)
28 $keypath = '/home/foo/Kexample.com.+013+26512.private';
29 $private = new Net::DNS::SEC::Private( $keypath );
30
31 The argument is the full path to a private key file generated by the
32 BIND dnssec-keygen tool. Note that the filename contains information
33 about the algorithm and keytag.
34
35 new (from private key parameters)
36 $private = new Net::DNS::SEC::Private(
37 'algorithm' => '13',
38 'keytag' => '26512',
39 'privatekey' => 'h/mc+iq9VDUbNAjQgi8S8JzlEX29IALchwJmNM3QYKk=',
40 'signame' => 'example.com.'
41 );
42
43 The arguments define the private key parameters as (name,value) pairs.
44 The name and data representation are identical to that used in a BIND
45 private keyfile.
46
47 private_key_format
48 $format = $private->private_key_format;
49
50 Returns a string which identifies the format of the private key file.
51
52 algorithm, keytag, signame
53 $algorithm = $private->algorithm;
54 $keytag = $private->keytag;
55 $signame = $private->signame;
56
57 Returns the corresponding attribute determined from the filename.
58
59 Private key attributes
60 $attribute = $private->attribute;
61
62 Returns the value as it appears in the private key file. The attribute
63 names correspond to the tag in the key file, modified to form an
64 acceptable Perl subroutine name.
65
66 created, publish, activate
67 $created = $private->created;
68 $publish = $private->publish;
69 $activate = $private->activate;
70
71 Returns a string which represents a date in the form 20141212123456.
72 Returns undefined value for key formats older than v1.3.
73
75 Copyright (c)2014,2018 Dick Franks
76
77 All Rights Reserved
78
80 Permission to use, copy, modify, and distribute this software and its
81 documentation for any purpose and without fee is hereby granted,
82 provided that the above copyright notice appear in all copies and that
83 both that copyright notice and this permission notice appear in
84 supporting documentation, and that the name of the author not be used
85 in advertising or publicity pertaining to distribution of the software
86 without specific prior written permission.
87
88 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
89 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
90 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
91 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
92 CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
93 TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
94 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
95
97 perl, Net::DNS, Net::DNS::SEC, Net::DNS::RR::DNSKEY,
98 Net::DNS::RR::RRSIG
99
100
101
102perl v5.30.1 2020-01-30 Net::DNS::SEC::Private(3)