activate-zone-key *ZONE* *KEY-ID*
: Activate a key with id *KEY-ID* within a zone called *ZONE*.
-add-zone-key *ZONE* {**KSK**,**ZSK**} [**active**,**passive**] *KEYBITS* *ALGORITHM*
+add-zone-key *ZONE* {**KSK**,**ZSK**} [**active**,**inactive**] *KEYBITS* *ALGORITHM*
: Create a new key for zone *ZONE*, and make it a KSK or a ZSK, with the
- specified algorithm. The key is passive by default, set it to **active** to
+ specified algorithm. The key is inactive by default, set it to **active** to
immediately use it to sign *ZONE*.
create-bind-db *FILE*
# Records, Keys, signatures, hashes within PowerDNSSEC in online signing mode
Within PowerDNSSEC live signing, keys are stored separately from the zone records. Zone data are only combined with signatures and keys when requests come in over the internet.
-Each zone can have a number of keys associated with it, with varying key lengths. Typically 1 or at most 2 of these keys are employed as actual Zone Signing Keys (ZSKs). During normal operations, this means that only 1 ZSK is 'active', and the other is passive.
+Each zone can have a number of keys associated with it, with varying key lengths. Typically 1 or at most 2 of these keys are employed as actual Zone Signing Keys (ZSKs). During normal operations, this means that only 1 ZSK is 'active', and the other is inactive.
Should it be desired to 'roll over' to a new key, both keys can temporarily be active (and used for signing), and after a while the old key can be inactivated. Subsequently it can be removed.
We assume the zone name is example.com and is already DNSSEC signed.
-Start by adding a new KSK to the zone: `pdnsutil add-zone-key example.com ksk 2048 passive`.
-The "passive" means that the key is not used to sign any ZSK records. This limits
+Start by adding a new KSK to the zone: `pdnsutil add-zone-key example.com ksk 2048 inactive`.
+The "inactive" means that the key is not used to sign any ZSK records. This limits
the size of `ANY` and DNSKEY responses.
Publish the CDS records: `pdnsutil set-publish-cds example.com`, these records
cerr<<"activate-tsig-key ZONE NAME {master|slave}"<<endl;
cerr<<" Enable TSIG key for a zone"<<endl;
cerr<<"activate-zone-key ZONE KEY-ID Activate the key with key id KEY-ID in ZONE"<<endl;
- cerr<<"add-zone-key ZONE {zsk|ksk} [BITS] [active|passive]"<<endl;
+ cerr<<"add-zone-key ZONE {zsk|ksk} [BITS] [active|inactive]"<<endl;
cerr<<" [rsasha1|rsasha256|rsasha512|gost|ecdsa256|ecdsa384";
#ifdef HAVE_LIBSODIUM
cerr<<"|experimental-ed25519";
cerr<<"increase-serial ZONE Increases the SOA-serial by 1. Uses SOA-EDIT"<<endl;
cerr<<"import-tsig-key NAME ALGORITHM KEY Import TSIG key"<<endl;
cerr<<"import-zone-key ZONE FILE Import from a file a private key, ZSK or KSK"<<endl;
- cerr<<" [active|passive] [ksk|zsk] Defaults to KSK and active"<<endl;
+ cerr<<" [active|inactive] [ksk|zsk] Defaults to KSK and active"<<endl;
cerr<<"load-zone ZONE FILE Load ZONE from FILE, possibly creating zone or atomically"<<endl;
cerr<<" replacing contents"<<endl;
cerr<<"list-keys [ZONE] List DNSSEC keys for ZONE. When ZONE is unset or \"all\", display all keys for all zones"<<endl;
algorithm = tmp_algo;
} else if(pdns_iequals(cmds[n], "active")) {
active=true;
- } else if(pdns_iequals(cmds[n], "inactive") || pdns_iequals(cmds[n], "passive")) {
+ } else if(pdns_iequals(cmds[n], "inactive") || pdns_iequals(cmds[n], "passive")) { // 'passive' eventually needs to be removed
active=false;
} else if(atoi(cmds[n].c_str())) {
bits = atoi(cmds[n].c_str());
}
else if(cmds[0]=="import-zone-key") {
if(cmds.size() < 3) {
- cerr<<"Syntax: pdnsutil import-zone-key ZONE FILE [ksk|zsk] [active|passive]"<<endl;
+ cerr<<"Syntax: pdnsutil import-zone-key ZONE FILE [ksk|zsk] [active|inactive]"<<endl;
exit(1);
}
string zone=cmds[1];
dpk.d_flags = 257;
else if(pdns_iequals(cmds[n], "active"))
active = 1;
- else if(pdns_iequals(cmds[n], "passive") || pdns_iequals(cmds[n], "inactive"))
+ else if(pdns_iequals(cmds[n], "passive") || pdns_iequals(cmds[n], "inactive")) // passive eventually needs to be removed
active = 0;
else {
cerr<<"Unknown key flag '"<<cmds[n]<<"'"<<endl;