1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
|
#!/bin/sh
# Copyright (C) 2015 Internet Systems Consortium, Inc. ("ISC")
# Copyright (C) Internet Systems Consortium, Inc. ("ISC")
#
# SPDX-License-Identifier: MPL-2.0
#
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, you can obtain one at https://mozilla.org/MPL/2.0/.
#
# See the COPYRIGHT file distributed with this work for additional
# information regarding copyright ownership.
HELP="
Generates a set of <count> successive DNSSEC keys for <zone>
Key timings are based on a pre-publication rollover strategy
<life> (lifetime) is the key active lifetime in days [default 180]
<intro> (introduction time) is the number of days from publication
to activation of a key [default 30]
<ret> (retirement time) is the number of days from inactivation
to deletion of a key [default 30]
Options:
-a <alg> Cryptographic algorithm. See man dnssec-keygen for defaults.
-b <bits> Number of bits in the key. See man dnssec-keygen for defaults.
-k if present, generate Key Signing Keys (KSKs). Otherwise,
generate Zone Signing Keys (ZSKs).
-3 If present and if -a is not specified, use an NSEC3-
capable algorithm. See man dnssec-keygen for defaults.
-i <date> Inception date of the set of keys, in 'mm/dd/yyyy' format.
The first two keys will be published by this date, and the
first one will be activated. Default is today.
-f <index> Index of first key generated. Defaults to 0.
-K <dir> Key repository: write keys to this directory. Defaults to CWD.
-d Dry run. No actual keys generated if present."
USAGE="Usage:
`basename $0` [-a <alg>] [-b <bits>] [-k] [-3] [-i <date>]
[-f <index>] [-d] <zone> <count> [<life>] [<intro>] [<ret>]"
ALGFLAG=''
BITSFLAG=''
KSKFLAG=''
NSEC3FLAG=''
KEYREPO=''
DRYRUN=false
OPTKSK=false
K=0
INCEP=`date +%m/%d/%Y`
# Parse command line options
while getopts ":a:b:df:hkK:3i:" thisOpt
do
case $thisOpt in
a)
ALGFLAG=" -a $OPTARG"
;;
b)
BITSFLAG=" -b $OPTARG"
;;
d)
DRYRUN=true
;;
f)
OPTKSK=true
K=$OPTARG
;;
h)
echo "$USAGE"
echo "$HELP"
exit 0
;;
k)
KSKFLAG=" -f KSK"
;;
K)
KEYREPO=$OPTARG
;;
3)
NSEC3FLAG=" -3"
;;
i)
INCEP=$OPTARG
;;
*)
echo 'Unrecognized option.'
echo "$USAGE"
exit 1
;;
esac
done
shift `expr $OPTIND - 1`
# Check that required arguments are present
if [ $# -gt 5 -o $# -lt 2 ]; then
echo "$USAGE"
exit 1
fi
# Remaining arguments:
# DNS zone name
ZONE=$1
shift
# Number of keys to be generated
COUNT=$1
shift
# Key active lifetime
LIFE=${1:-180}
[ $# -ne 0 ] && shift
# Key introduction time (publication to activation)
INTRO=${1:-30}
[ $# -ne 0 ] && shift
# Key retirement time (inactivation to deletion)
RET=${1:-30}
# Today's date in dnssec-keygen format (YYYYMMDD)
TODAY=`date +%Y%m%d`
# Key repository defaults to CWD
if [ -z "$KEYREPO" ]; then
KEYREPO="."
fi
if $DRYRUN; then
echo 'Dry Run (no key files generated)'
elif [ ! -d "$KEYREPO" ]; then
# Create the key repository if it does not currently exist
mkdir -p "$KEYREPO"
fi
# Iterate through the key set. K is the index, zero-based.
KLAST=`expr $K + $COUNT`
while [ $K -lt $KLAST ]; do
KEYLABEL="Key `printf \"%02d\" $K`:"
# Epoch of the current key
# (zero for the first key, increments of key lifetime)
# The epoch is in days relative to the inception date of the key set
EPOCH=`expr $LIFE \* $K`
# Activation date in days is the same as the epoch
ACTIVATE=$EPOCH
# Publication date in days relative to the key epoch
PUBLISH=`expr $EPOCH - $LIFE - $INTRO`
# Inactivation date in days relative to the key epoch
INACTIVE=`expr $EPOCH + $LIFE`
# Deletion date in days relative to the key epoch
DELETE=`expr $EPOCH + $LIFE + $RET`
# ... these values should not precede the key epoch
[ $ACTIVATE -lt 0 ] && ACTIVATE=0
[ $PUBLISH -lt 0 ] && PUBLISH=0
[ $INACTIVE -lt 0 ] && INACTIVE=0
[ $DELETE -lt 0 ] && DELETE=0
# Key timing dates in dnssec-keygen format (YYYYMMDD):
# publication, activation, inactivation, deletion
PDATE=`date -d "$INCEP +$PUBLISH day" +%Y%m%d`
ADATE=`date -d "$INCEP +$ACTIVATE day" +%Y%m%d`
IDATE=`date -d "$INCEP +$INACTIVE day" +%Y%m%d`
DDATE=`date -d "$INCEP +$DELETE day" +%Y%m%d`
# Construct the dnssec-keygen command including all the specified options.
# Suppress key generation progress information, and save the key in
# the $KEYREPO directory.
KEYGENCMD="dnssec-keygen -q$ALGFLAG$BITSFLAG$NSEC3FLAG$KSKFLAG -P $PDATE -A $ADATE -I $IDATE -D $DDATE -K $KEYREPO $ZONE"
echo "$KEYLABEL $KEYGENCMD"
# Generate the key and retrieve its name
if $DRYRUN; then
KEYNAME="DryRunKey-`printf \"%02d\" $K`"
else
KEYNAME=`$KEYGENCMD`
fi
# Indicate the key status based on key timing dates relative to today
if [ $TODAY -ge $DDATE ]; then
echo "$KEYLABEL $KEYNAME is obsolete post deletion date."
elif [ $TODAY -ge $IDATE ]; then
echo "$KEYLABEL $KEYNAME is published and inactive prior to deletion date."
elif [ $TODAY -ge $ADATE ]; then
echo "$KEYLABEL $KEYNAME is published and active."
elif [ $TODAY -ge $PDATE ]; then
echo "$KEYLABEL $KEYNAME is published prior to activation date."
else
echo "$KEYLABEL $KEYNAME is pending publication."
fi
# For published KSKs, generate the required DS records,
# saving them to the file $KEYREPO/DS-$KEYNAME
if $OPTKSK && [ $TODAY -ge $PDATE -a $TODAY -lt $DDATE ]; then
echo "$KEYLABEL $KEYNAME (KSK) requires the publication of DS records in the parent zone."
if $DRYRUN; then
echo "$KEYLABEL No DS-$KEYNAME file created."
else
dnssec-dsfromkey "$KEYREPO/$KEYNAME" > "$KEYREPO/DS-$KEYNAME"
echo "$KEYLABEL See $KEYREPO/DS-$KEYNAME."
fi
fi
K=`expr $K + 1`
done
exit 0
|
