dnssec-signzone.html revision 2cd182921e1b04ccda0a56995c4cc491c882af04
1516N/A<!--
281N/A - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
281N/A - Copyright (C) 2001-2003 Internet Software Consortium.
281N/A -
281N/A - Permission to use, copy, modify, and distribute this software for any
281N/A - purpose with or without fee is hereby granted, provided that the above
281N/A - copyright notice and this permission notice appear in all copies.
281N/A -
281N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
281N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
281N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
281N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
281N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
281N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
281N/A - PERFORMANCE OF THIS SOFTWARE.
281N/A-->
281N/A
281N/A<!-- $Id: dnssec-signzone.html,v 1.13 2004/08/23 00:05:44 marka Exp $ -->
281N/A
281N/A<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
281N/A<HTML
281N/A><HEAD
281N/A><TITLE
2936N/A>dnssec-signzone</TITLE
281N/A><META
281N/ANAME="GENERATOR"
281N/ACONTENT="Modular DocBook HTML Stylesheet Version 1.7"></HEAD
281N/A><BODY
281N/ACLASS="REFENTRY"
281N/ABGCOLOR="#FFFFFF"
281N/ATEXT="#000000"
281N/ALINK="#0000FF"
281N/AVLINK="#840084"
289N/AALINK="#0000FF"
289N/A><H1
289N/A><A
289N/ANAME="AEN1"
289N/A></A
281N/A><SPAN
2003N/ACLASS="APPLICATION"
2003N/A>dnssec-signzone</SPAN
281N/A></H1
281N/A><DIV
281N/ACLASS="REFNAMEDIV"
281N/A><A
1846N/ANAME="AEN9"
1846N/A></A
1846N/A><H2
1846N/A>Name</H2
281N/A><SPAN
281N/ACLASS="APPLICATION"
2205N/A>dnssec-signzone</SPAN
2639N/A>&nbsp;--&nbsp;DNSSEC zone signing tool</DIV
281N/A><DIV
281N/ACLASS="REFSYNOPSISDIV"
281N/A><A
281N/ANAME="AEN13"
281N/A></A
281N/A><H2
281N/A>Synopsis</H2
281N/A><P
2003N/A><B
281N/ACLASS="COMMAND"
281N/A>dnssec-signzone</B
289N/A> [<VAR
289N/ACLASS="OPTION"
289N/A>-a</VAR
289N/A>] [<VAR
1685N/ACLASS="OPTION"
281N/A>-c <VAR
2003N/ACLASS="REPLACEABLE"
281N/A>class</VAR
281N/A></VAR
1685N/A>] [<VAR
2936N/ACLASS="OPTION"
2936N/A>-d <VAR
2936N/ACLASS="REPLACEABLE"
2936N/A>directory</VAR
2936N/A></VAR
2936N/A>] [<VAR
2936N/ACLASS="OPTION"
2936N/A>-e <VAR
2936N/ACLASS="REPLACEABLE"
2936N/A>end-time</VAR
281N/A></VAR
2936N/A>] [<VAR
2936N/ACLASS="OPTION"
2936N/A>-f <VAR
2936N/ACLASS="REPLACEABLE"
2936N/A>output-file</VAR
2936N/A></VAR
2936N/A>] [<VAR
2936N/ACLASS="OPTION"
2936N/A>-g</VAR
2936N/A>] [<VAR
2936N/ACLASS="OPTION"
2936N/A>-h</VAR
2936N/A>] [<VAR
2936N/ACLASS="OPTION"
2936N/A>-k <VAR
2936N/ACLASS="REPLACEABLE"
2936N/A>key</VAR
2936N/A></VAR
2003N/A>] [<VAR
2003N/ACLASS="OPTION"
2003N/A>-l <VAR
2003N/ACLASS="REPLACEABLE"
2003N/A>domain</VAR
2003N/A></VAR
281N/A>] [<VAR
281N/ACLASS="OPTION"
1685N/A>-i <VAR
1685N/ACLASS="REPLACEABLE"
1685N/A>interval</VAR
1685N/A></VAR
1685N/A>] [<VAR
1685N/ACLASS="OPTION"
1685N/A>-n <VAR
289N/ACLASS="REPLACEABLE"
1685N/A>nthreads</VAR
1685N/A></VAR
1685N/A>] [<VAR
281N/ACLASS="OPTION"
2003N/A>-o <VAR
281N/ACLASS="REPLACEABLE"
281N/A>origin</VAR
940N/A></VAR
1552N/A>] [<VAR
1552N/ACLASS="OPTION"
1552N/A>-p</VAR
1552N/A>] [<VAR
1552N/ACLASS="OPTION"
1552N/A>-r <VAR
1552N/ACLASS="REPLACEABLE"
1552N/A>randomdev</VAR
1552N/A></VAR
1552N/A>] [<VAR
940N/ACLASS="OPTION"
1552N/A>-s <VAR
1552N/ACLASS="REPLACEABLE"
1552N/A>start-time</VAR
1552N/A></VAR
1552N/A>] [<VAR
1552N/ACLASS="OPTION"
1552N/A>-t</VAR
1552N/A>] [<VAR
1552N/ACLASS="OPTION"
1552N/A>-v <VAR
1552N/ACLASS="REPLACEABLE"
1552N/A>level</VAR
1685N/A></VAR
1685N/A>] [<VAR
1685N/ACLASS="OPTION"
1685N/A>-z</VAR
1552N/A>] {zonefile} [key...]</P
1552N/A></DIV
1552N/A><DIV
1685N/ACLASS="REFSECT1"
940N/A><A
281N/ANAME="AEN66"
281N/A></A
289N/A><H2
1685N/A>DESCRIPTION</H2
1685N/A><P
289N/A> <B
2003N/ACLASS="COMMAND"
281N/A>dnssec-signzone</B
281N/A> signs a zone. It generates
281N/A NSEC and RRSIG records and produces a signed version of the
2205N/A zone. The security status of delegations from the signed zone
2205N/A (that is, whether the child zones are secure or not) is
2205N/A determined by the presence or absence of a
2205N/A <TT
2205N/ACLASS="FILENAME"
2205N/A>keyset</TT
2205N/A> file for each child zone.
281N/A </P
281N/A></DIV
1100N/A><DIV
1100N/ACLASS="REFSECT1"
1100N/A><A
941N/ANAME="AEN71"
281N/A></A
2476N/A><H2
2476N/A>OPTIONS</H2
2476N/A><P
2476N/A></P
2476N/A><DIV
2476N/ACLASS="VARIABLELIST"
2476N/A><DL
2476N/A><DT
2476N/A>-a</DT
2476N/A><DD
2476N/A><P
2476N/A> Verify all generated signatures.
2476N/A </P
2476N/A></DD
2936N/A><DT
2936N/A>-c <VAR
2936N/ACLASS="REPLACEABLE"
2936N/A>class</VAR
2936N/A></DT
2936N/A><DD
2936N/A><P
2936N/A> Specifies the DNS class of the zone.
2936N/A </P
></DD
><DT
>-k <VAR
CLASS="REPLACEABLE"
>key</VAR
></DT
><DD
><P
> Treat specified key as a key signing key ignoring any
key flags. This option may be specified multiple times.
</P
></DD
><DT
>-l <VAR
CLASS="REPLACEABLE"
>domain</VAR
></DT
><DD
><P
> Generate a DLV set in addition to the key (DNSKEY) and DS sets.
The domain is appended to the name of the records.
</P
></DD
><DT
>-d <VAR
CLASS="REPLACEABLE"
>directory</VAR
></DT
><DD
><P
> Look for <TT
CLASS="FILENAME"
>keyset</TT
> files in
<VAR
CLASS="OPTION"
>directory</VAR
> as the directory
</P
></DD
><DT
>-g</DT
><DD
><P
> Generate DS records for child zones from keyset files.
Existing DS records will be removed.
</P
></DD
><DT
>-s <VAR
CLASS="REPLACEABLE"
>start-time</VAR
></DT
><DD
><P
> Specify the date and time when the generated RRSIG records
become valid. This can be either an absolute or relative
time. An absolute start time is indicated by a number
in YYYYMMDDHHMMSS notation; 20000530144500 denotes
14:45:00 UTC on May 30th, 2000. A relative start time is
indicated by +N, which is N seconds from the current time.
If no <VAR
CLASS="OPTION"
>start-time</VAR
> is specified, the current
time minus 1 hour (to allow for clock skew) is used.
</P
></DD
><DT
>-e <VAR
CLASS="REPLACEABLE"
>end-time</VAR
></DT
><DD
><P
> Specify the date and time when the generated RRSIG records
expire. As with <VAR
CLASS="OPTION"
>start-time</VAR
>, an absolute
time is indicated in YYYYMMDDHHMMSS notation. A time relative
to the start time is indicated with +N, which is N seconds from
the start time. A time relative to the current time is
indicated with now+N. If no <VAR
CLASS="OPTION"
>end-time</VAR
> is
specified, 30 days from the start time is used as a default.
</P
></DD
><DT
>-f <VAR
CLASS="REPLACEABLE"
>output-file</VAR
></DT
><DD
><P
> The name of the output file containing the signed zone. The
default is to append <TT
CLASS="FILENAME"
>.signed</TT
> to the
input file.
</P
></DD
><DT
>-h</DT
><DD
><P
> Prints a short summary of the options and arguments to
<B
CLASS="COMMAND"
>dnssec-signzone</B
>.
</P
></DD
><DT
>-i <VAR
CLASS="REPLACEABLE"
>interval</VAR
></DT
><DD
><P
> When a previously signed zone is passed as input, records
may be resigned. The <VAR
CLASS="OPTION"
>interval</VAR
> option
specifies the cycle interval as an offset from the current
time (in seconds). If a RRSIG record expires after the
cycle interval, it is retained. Otherwise, it is considered
to be expiring soon, and it will be replaced.
</P
><P
> The default cycle interval is one quarter of the difference
between the signature end and start times. So if neither
<VAR
CLASS="OPTION"
>end-time</VAR
> or <VAR
CLASS="OPTION"
>start-time</VAR
>
are specified, <B
CLASS="COMMAND"
>dnssec-signzone</B
> generates
signatures that are valid for 30 days, with a cycle
interval of 7.5 days. Therefore, if any existing RRSIG records
are due to expire in less than 7.5 days, they would be
replaced.
</P
></DD
><DT
>-n <VAR
CLASS="REPLACEABLE"
>ncpus</VAR
></DT
><DD
><P
> Specifies the number of threads to use. By default, one
thread is started for each detected CPU.
</P
></DD
><DT
>-o <VAR
CLASS="REPLACEABLE"
>origin</VAR
></DT
><DD
><P
> The zone origin. If not specified, the name of the zone file
is assumed to be the origin.
</P
></DD
><DT
>-p</DT
><DD
><P
> Use pseudo-random data when signing the zone. This is faster,
but less secure, than using real random data. This option
may be useful when signing large zones or when the entropy
source is limited.
</P
></DD
><DT
>-r <VAR
CLASS="REPLACEABLE"
>randomdev</VAR
></DT
><DD
><P
> Specifies the source of randomness. If the operating
system does not provide a <TT
CLASS="FILENAME"
>/dev/random</TT
>
or equivalent device, the default source of randomness
is keyboard input. <TT
CLASS="FILENAME"
>randomdev</TT
> specifies
the name of a character device or file containing random
data to be used instead of the default. The special value
<TT
CLASS="FILENAME"
>keyboard</TT
> indicates that keyboard
input should be used.
</P
></DD
><DT
>-t</DT
><DD
><P
> Print statistics at completion.
</P
></DD
><DT
>-v <VAR
CLASS="REPLACEABLE"
>level</VAR
></DT
><DD
><P
> Sets the debugging level.
</P
></DD
><DT
>-z</DT
><DD
><P
> Ignore KSK flag on key when determining what to sign.
</P
></DD
><DT
>zonefile</DT
><DD
><P
> The file containing the zone to be signed.
Sets the debugging level.
</P
></DD
><DT
>key</DT
><DD
><P
> The keys used to sign the zone. If no keys are specified, the
default all zone keys that have private key files in the
current directory.
</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN181"
></A
><H2
>EXAMPLE</H2
><P
> The following command signs the <KBD
CLASS="USERINPUT"
>example.com</KBD
>
zone with the DSA key generated in the <B
CLASS="COMMAND"
>dnssec-keygen</B
>
man page. The zone's keys must be in the zone. If there are
<TT
CLASS="FILENAME"
>keyset</TT
> files associated with child zones,
they must be in the current directory.
<KBD
CLASS="USERINPUT"
>example.com</KBD
>, the following command would be
issued:
</P
><P
> <KBD
CLASS="USERINPUT"
>dnssec-signzone -o example.com db.example.com Kexample.com.+003+26160</KBD
>
</P
><P
> The command would print a string of the form:
</P
><P
> In this example, <B
CLASS="COMMAND"
>dnssec-signzone</B
> creates
the file <TT
CLASS="FILENAME"
>db.example.com.signed</TT
>. This file
should be referenced in a zone statement in a
<TT
CLASS="FILENAME"
>named.conf</TT
> file.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN195"
></A
><H2
>SEE ALSO</H2
><P
> <SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>dnssec-keygen</SPAN
>(8)</SPAN
>,
<I
CLASS="CITETITLE"
>BIND 9 Administrator Reference Manual</I
>,
<I
CLASS="CITETITLE"
>RFC 2535</I
>.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN203"
></A
><H2
>AUTHOR</H2
><P
> Internet Systems Consortium
</P
></DIV
></BODY
></HTML
>