sq-network-dane - Man Page

Retrieve and publishes certificates via DANE

Synopsis

sq network dane fetch [OPTIONS] ADDRESS
sq network dane generate [OPTIONS] FQDN CERT-RING

Description

Retrieve and publishes certificates via DANE.

DNS-Based Authentication of Named Entities (DANE) is a method for publishing and retrieving certificates in DNS as specified in RFC 7929.

Subcommands

sq network dane fetch

Retrieve certificates using DANE.

By default, any returned certificates are stored in the local certificate store.  This can be overridden by using `--output` option.

When a certificate is retrieved using DANE, and imported into the local certificate store, any User IDs with the email address that was looked up are certificated with a local DANE-specific key.  That proxy certificate is in turn certified as a minimally trusted CA (trust amount: 1 of 120) by the local trust root.  How much the DANE proxy CA is trusted can be tuned using `sq pki link add` or `sq pki link retract` in the usual way.

sq network dane generate

Generate DANE records for the given domain and certs.

The certificates are minimized, and one record per email address is emitted.  If multiple user IDs map to one email address, then all matching user IDs are included in the emitted certificates.

By default, OPENPGPKEY resource records are emitted.  If your DNS server doesn't understand those, use `--generic` to emit generic records instead.

Examples

sq network dane generate

Generate DANE records from juliet.pgp for example.org.

    sq network dane generate example.org juliet.pgp

See Also

sq(1), sq-network(1), sq-network-dane-fetch(1), sq-network-dane-generate(1).

For the full documentation see <https://book.sequoia-pgp.org>.

Version

0.38.0 (sequoia-openpgp 1.21.2)

Referenced By

sq-network(1), sq-network-dane-fetch(1), sq-network-dane-generate(1).

0.38.0 Sequoia PGP