dnssec-verify Command

Purpose

Verifies the DNSSEC zone.

Syntax

dnssec-verify [-c class] [-E engine] [-I input-format] [-o origin] [-q] [-v level] [-V] [-x] [-z] {zonefile}

Description

The dnssec-verify command verifies that a zone is fully signed for each algorithm found in the DNSKEY resource record set (RRset) for the zone, and that the NSEC/NSEC3 chains are complete.

Flags

-c class

Specifies the DNS class of the zone.

-E engine

Specifies the cryptographic hardware to use, when applicable.

When BIND 9 is built with OpenSSL, this flag needs to be set to the OpenSSL engine identifier that drives the cryptographic accelerator or hardware service module (usually pkcs11). When BIND is built with native PKCS#11 cryptography (--enable-native-pkcs11), it defaults to the path of the PKCS#11 provider library specified via --with-pkcs11.

-I input-format

Sets the format of the input zone file. Possible formats are text (the default) and raw. This option is primarily intended to be used for dynamic signed zones, so that the dumped zone file that contains updates in a non-text format can be verified independently. This option is not useful for non-dynamic zones.

-o origin

Indicates the zone origin. If this flag is not specified, the name of the zone file is assumed to be the origin.

-v level

Sets the debugging level.

-V

Prints version information.

-q

Sets quiet mode, which suppresses output. Without this option, when the dnssec-verify command is run, it prints to standard output: the number of keys in use, information about whether the algorithms used to verify the zone was signed correctly, and other status information. With this option, all non-error output is suppressed, and only the exit code indicates success.

-x

Verifies that the DNSKEY RRset is signed with key-signing keys (KSK). Without this flag, it is assumed that the DNSKEY RRset is signed by all active keys. When this flag is set, it is not an error if the DNSKEY RRset is not signed by zone-signing keys. This corresponds to the -x option in the dnssec-signzone command.

-z

Indicates that the KSK flag in all active keys should be ignored when determining whether the zone is correctly signed. Without the -z flag, it is assumed that a non-revoked, self-signed DNSKEY in which the KSK flag is set is available for each algorithm, and that RRsets other than DNSKEY RRset are signed with a different DNSKEY in which the KSK flag is not set.

With this flag set, BIND 9 requires at least one non-revoked, self-signed DNSKEY for each algorithm, regardless of the KSK flag state, and that other RRsets must be signed by a non-revoked key for the same algorithm that includes the self-signed key. The same key can be used for both purposes. This corresponds to the -z option in the dnssec-signzone command.

Parameter

zonefile

Indicates the file containing the zone to be signed.