man.dnssec-keyfromlabel.html revision 1879ff49326b49a9e4eadaca193c631409bf8575
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - Copyright (C) 2004-2015 Internet Systems Consortium, Inc. ("ISC")
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - Copyright (C) 2000-2003 Internet Software Consortium.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - Permission to use, copy, modify, and/or distribute this software for any
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - purpose with or without fee is hereby granted, provided that the above
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - copyright notice and this permission notice appear in all copies.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync - PERFORMANCE OF THIS SOFTWARE.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<!-- $Id$ -->
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<meta name="generator" content="DocBook XSL Stylesheets V1.71.1">
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<link rel="start" href="Bv9ARM.html" title="BIND 9 Administrator Reference Manual">
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<link rel="up" href="Bv9ARM.ch13.html" title="Manual pages">
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<link rel="prev" href="man.dnssec-importkey.html" title="dnssec-importkey">
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<link rel="next" href="man.dnssec-keygen.html" title="dnssec-keygen">
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<tr><th colspan="3" align="center"><span class="application">dnssec-keyfromlabel</span></th></tr>
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<a accesskey="p" href="man.dnssec-importkey.html">Prev</a>�</td>
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<td width="20%" align="right">�<a accesskey="n" href="man.dnssec-keygen.html">Next</a>
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<a name="man.dnssec-keyfromlabel"></a><div class="titlepage"></div>
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<p><span class="application">dnssec-keyfromlabel</span> — DNSSEC key generation tool</p>
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<div class="cmdsynopsis"><p><code class="command">dnssec-keyfromlabel</code> {-l <em class="replaceable"><code>label</code></em>} [<code class="option">-3</code>] [<code class="option">-a <em class="replaceable"><code>algorithm</code></em></code>] [<code class="option">-A <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-c <em class="replaceable"><code>class</code></em></code>] [<code class="option">-D <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-E <em class="replaceable"><code>engine</code></em></code>] [<code class="option">-f <em class="replaceable"><code>flag</code></em></code>] [<code class="option">-G</code>] [<code class="option">-I <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-i <em class="replaceable"><code>interval</code></em></code>] [<code class="option">-k</code>] [<code class="option">-K <em class="replaceable"><code>directory</code></em></code>] [<code class="option">-L <em class="replaceable"><code>ttl</code></em></code>] [<code class="option">-n <em class="replaceable"><code>nametype</code></em></code>] [<code class="option">-P <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-p <em class="replaceable"><code>protocol</code></em></code>] [<code class="option">-R <em class="replaceable"><code>date/offset</code></em></code>] [<code class="option">-S <em class="replaceable"><code>key</code></em></code>] [<code class="option">-t <em class="replaceable"><code>type</code></em></code>] [<code class="option">-v <em class="replaceable"><code>level</code></em></code>] [<code class="option">-V</code>] [<code class="option">-y</code>] {name}</p></div>
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<p><span><strong class="command">dnssec-keyfromlabel</strong></span>
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync generates a key pair of files that referencing a key object stored
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync in a cryptographic hardware service module (HSM). The private key
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync file can be used for DNSSEC signing of zone data as if it were a
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync conventional signing key created by <span><strong class="command">dnssec-keygen</strong></span>,
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync but the key material is stored within the HSM, and the actual signing
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync takes place there.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync The <code class="option">name</code> of the key is specified on the command
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync line. This must match the name of the zone for which the key is
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync being generated.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<dt><span class="term">-a <em class="replaceable"><code>algorithm</code></em></span></dt>
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync Selects the cryptographic algorithm. The value of
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync <code class="option">algorithm</code> must be one of RSAMD5, RSASHA1,
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync DSA, NSEC3RSASHA1, NSEC3DSA, RSASHA256, RSASHA512, ECCGOST,
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync ECDSAP256SHA256 or ECDSAP384SHA384.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync These values are case insensitive.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync If no algorithm is specified, then RSASHA1 will be used by
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync default, unless the <code class="option">-3</code> option is specified,
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync in which case NSEC3RSASHA1 will be used instead. (If
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync <code class="option">-3</code> is used and an algorithm is specified,
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync that algorithm will be checked for compatibility with NSEC3.)
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync Note 1: that for DNSSEC, RSASHA1 is a mandatory to implement
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync algorithm, and DSA is recommended.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync Note 2: DH automatically sets the -k flag.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync Use an NSEC3-capable algorithm to generate a DNSSEC key.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync If this option is used and no algorithm is explicitly
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync set on the command line, NSEC3RSASHA1 will be used by
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync<dt><span class="term">-E <em class="replaceable"><code>engine</code></em></span></dt>
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync Specifies the cryptographic hardware to use.
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync When BIND is built with OpenSSL PKCS#11 support, this defaults
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync to the string "pkcs11", which identifies an OpenSSL engine
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync that can drive a cryptographic accelerator or hardware service
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync module. When BIND is built with native PKCS#11 cryptography
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync (--enable-native-pkcs11), it defaults to the path of the PKCS#11
b8e299dddd091ae24e0c08c45d91b8f937bd14d2vboxsync provider library specified via "--with-pkcs11".