dnssec-signkey.html revision c651f15b30f1dae5cc2f00878fb5da5b3a35a468
6fe48fb46e53ffc37542853a1edb74cb481b7d94Automatic Updater - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
c78c39caab4cf8b5daefc9c65878f7f5ed3eb7a0Tinderbox User - Copyright (C) 2000, 2001, 2003 Internet Software Consortium.
ab496cc3df1648e9ad992a87c35c2c0870fdc69dTinderbox User - Permission to use, copy, modify, and distribute this software for any
7c1468ed500356839a4a222517364e6ce18cb1a2Tinderbox User - purpose with or without fee is hereby granted, provided that the above
c57668a2fbbe558c1bd21652813616f2f517c469Tinderbox User - copyright notice and this permission notice appear in all copies.
287a6a8f9040dc43560cd69cddf83bfc0f53b76fTinderbox User - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
8de3f14f1c300c3e1ed99084cc03485b42c92bf1Tinderbox User - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
950d203b64f512b85fcc093ee1e9e3e531a1aea3Tinderbox User - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
b886b04d8d2b085cbf3e1bf4442dee87f43ba5e4Tinderbox User - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews - PERFORMANCE OF THIS SOFTWARE.
a7c412f37cc73d0332887a746e81220cbf09dd00Mark Andrews<!-- $Id: dnssec-signkey.html,v 1.6 2005/04/07 03:49:56 marka Exp $ -->
e676a596869d8a80a644c99a848afb53d1c5975eMark Andrews>dnssec-signkey</TITLE
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserNAME="GENERATOR"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCONTENT="Modular DocBook HTML Stylesheet Version 1.61
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="REFENTRY"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsBGCOLOR="#FFFFFF"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserTEXT="#000000"
efb0e886f18894a1d2489f1ad74ad14b579e11c7Mark AndrewsLINK="#0000FF"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsVLINK="#840084"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserALINK="#0000FF"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="APPLICATION"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User>dnssec-signkey</SPAN
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan HuntCLASS="REFNAMEDIV"
aa9c561961e9d877946ebaa8795fa2be054ab7bfEvan HuntCLASS="APPLICATION"
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User>dnssec-signkey</SPAN
0e573cdd111e060e5f6c18249b5ccacbe8abe278Tinderbox User> -- DNSSEC key set signing tool</DIV
710bce1a85c96e85ca1a90471382055acd29d51fTinderbox UserCLASS="REFSYNOPSISDIV"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="COMMAND"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>dnssec-signkey</B
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="OPTION"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="OPTION"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="REPLACEABLE"
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox UserCLASS="OPTION"
2ae159b376dac23870d8005563c585acf85a4b5aEvan HuntCLASS="REPLACEABLE"
95637507c3d47481fbf0a8a8c750a57f944f677fMark Andrews>start-time</I
2ae159b376dac23870d8005563c585acf85a4b5aEvan HuntCLASS="OPTION"
2ae159b376dac23870d8005563c585acf85a4b5aEvan HuntCLASS="REPLACEABLE"
ee11dfc481f2ef6a032a715454f6290961a722d2Tinderbox UserCLASS="OPTION"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="OPTION"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="OPTION"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="REPLACEABLE"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="OPTION"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="REPLACEABLE"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User>] {keyset} {key...}</P
91216cff91b34c9ff6e846dc23f248219cafe660Andreas GustafssonCLASS="REFSECT1"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User>DESCRIPTION</H2
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="COMMAND"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User>dnssec-signkey</B
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> signs a keyset. Typically
28a5dd720187fddb16055a0f64b63a7b66f29f64Mark Andrews the keyset will be for a child zone, and will have been generated
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsCLASS="COMMAND"
e40c4e4c17d4df338e2a7db0f84d8dbb3858964cTinderbox User>dnssec-makekeyset</B
0e573cdd111e060e5f6c18249b5ccacbe8abe278Tinderbox User>. The child zone's keyset
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark Andrews is signed with the zone keys for its parent zone. The output file
fd972434c29fc1169d66594e4cc7697d33036c2bTinderbox User is of the form <TT
e40c4e4c17d4df338e2a7db0f84d8dbb3858964cTinderbox UserCLASS="FILENAME"
37d8e0a4455876fe1e4cca511076cc2c5ab9eedeTinderbox User>signedkey-nnnn.</TT
e40c4e4c17d4df338e2a7db0f84d8dbb3858964cTinderbox UserCLASS="FILENAME"
2a31bd531072824ef252c18303859d6af7451b00Francis Dupont> is the zone name.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="REFSECT1"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="VARIABLELIST"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews> Verify all generated signatures.
cdfc81e048bd34c1d628380247bda6b80a89e20eAutomatic UpdaterCLASS="REPLACEABLE"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> Specifies the DNS class of the key sets.
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="REPLACEABLE"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User>start-time</I
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> Specify the date and time when the generated SIG records
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User become valid. This can be either an absolute or relative
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews time. An absolute start time is indicated by a number
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User in YYYYMMDDHHMMSS notation; 20000530144500 denotes
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson 14:45:00 UTC on May 30th, 2000. A relative start time is
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User indicated by +N, which is N seconds from the current time.
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="OPTION"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>start-time</TT
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User> is specified, the current
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="REPLACEABLE"
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson> Specify the date and time when the generated SIG records
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User expire. As with <TT
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="OPTION"
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User>start-time</TT
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>, an absolute
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User time is indicated in YYYYMMDDHHMMSS notation. A time relative
5f7586ddbd3edd11272cdd30ed613d936129328bTinderbox User to the start time is indicated with +N, which is N seconds from
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox User the start time. A time realtive to the current time is
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews indicated with now+N. If no <TT
9ecb5d33470ebfb3719a1b8d56bcefdf4b27f7b2Tinderbox UserCLASS="OPTION"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>end-time</TT
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews specified, 30 days from the start time is used as a default.
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User> Prints a short summary of the options and arguments to
7ca715ad1587a68a531ea1cdea07515d7232567eTinderbox UserCLASS="COMMAND"
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox User>dnssec-signkey</B
4151211e6649332f7b5a55870cbe37128bcc7b29Tinderbox User> Use pseudo-random data when signing the zone. This is faster,
91d187ce035f39073f0732ff2a401a45c3c955fbMark Andrews but less secure, than using real random data. This option
bc0a53583d92309bebcf93c408e2f3247ebd3d3cAutomatic Updater may be useful when signing large zones or when the entropy
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater source is limited.
ba8b771c371967dd1254c7fa82ebe4158ee04b24Tinderbox UserCLASS="REPLACEABLE"
19b3dc94bce93fa76bd7e066f9298630dbc9dcb4Automatic Updater> Specifies the source of randomness. If the operating
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater system does not provide a <TT
9513a2a6670951f5cf5477fcfec9f933fcaff628Automatic UpdaterCLASS="FILENAME"
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic Updater or equivalent device, the default source of randomness
bac4435d473c9a0281507524f084480c34aa942aTinderbox User is keyboard input. <TT
39ae0eafed076ef769fef5c18b22a8051df5c93aTinderbox UserCLASS="FILENAME"
91d187ce035f39073f0732ff2a401a45c3c955fbMark Andrews>randomdev</TT
e21f41f6504b3381be86cbe7f457f9ee1fff947bTinderbox User the name of a character device or file containing random
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User data to be used instead of the default. The special value
ce9cad6bb04869c5e94d9dc721032b25117f9210Automatic UpdaterCLASS="FILENAME"
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User> indicates that keyboard
dc238a06bffa79de141ee7655765e2df91498a8aTinderbox User input should be used.
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark AndrewsCLASS="REPLACEABLE"
ba8b771c371967dd1254c7fa82ebe4158ee04b24Tinderbox User> Sets the debugging level.
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews> The file containing the child's keyset.
757ff043760e4743dda1a10e7d58349275934902Tinderbox User> The keys used to sign the child's keyset.
1bcc3273a80c256f11d9098a00ba2c041939e233Mark AndrewsCLASS="REFSECT1"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews> The DNS administrator for a DNSSEC-aware <TT
3857cb6fcabeb79d85de4b3e3e4ab99912b701f8Mark AndrewsCLASS="USERINPUT"
91216cff91b34c9ff6e846dc23f248219cafe660Andreas Gustafsson zone would use the following command to sign the
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="FILENAME"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews> file for <TT
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox UserCLASS="USERINPUT"
caaff35375fba833f156f952aeca689e5bc7cddfFrancis Dupont created by <B
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsCLASS="COMMAND"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>dnssec-makekeyset</B
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews> with a key generated
78f3ed4bc2fcd3d270bfd599804f3b27a1db4d91Mark AndrewsCLASS="COMMAND"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>dnssec-keygen</B
0e573cdd111e060e5f6c18249b5ccacbe8abe278Tinderbox UserCLASS="USERINPUT"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>dnssec-signkey keyset-example.com. Kcom.+003+51944</B
e8fc8c884b44371784805e1e0d3100da403dd3f1Automatic Updater> In this example, <B
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="COMMAND"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>dnssec-signkey</B
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews the file <TT
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="FILENAME"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews contains the <TT
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="USERINPUT"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews> keys and the
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews signatures by the <TT
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark AndrewsCLASS="USERINPUT"
b30ec46fec40a1b246f7965fbcd341fc6cfd1cc1Mark AndrewsCLASS="REFSECT1"
95c3a5e116c1da135f669c3f15398172fac6279dMark Andrews>SEE ALSO</H2
d7d105151a78d35afb4233d2a6dbd47b7ec0d9a5Tinderbox UserCLASS="CITEREFENTRY"
015055b6e23f5c08f6a5b34726f90b62597e9e45Tinderbox UserCLASS="REFENTRYTITLE"
dedefc0bdbb4e6e39eeb98aa2fc6883efec2ddb0Mark Andrews>dnssec-keygen</SPAN
757ff043760e4743dda1a10e7d58349275934902Tinderbox UserCLASS="CITEREFENTRY"
0e573cdd111e060e5f6c18249b5ccacbe8abe278Tinderbox UserCLASS="REFENTRYTITLE"
c651f15b30f1dae5cc2f00878fb5da5b3a35a468Mark Andrews>dnssec-makekeyset</SPAN
7f79131f9a8e804b93c57f3c679065cce878b726Automatic UpdaterCLASS="CITEREFENTRY"
91216cff91b34c9ff6e846dc23f248219cafe660Andreas GustafssonCLASS="REFENTRYTITLE"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark Andrews>dnssec-signzone</SPAN
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsCLASS="REFSECT1"
0eb371ca0dab50ae3462e98794a6126198c52f4bMark AndrewsNAME="AEN128"
91d187ce035f39073f0732ff2a401a45c3c955fbMark Andrews> Internet Software Consortium