table of contents
SQ(1) | User Commands | SQ(1) |
NAME¶
sq cert - Manages certificates
SYNOPSIS¶
sq cert import [OPTIONS] FILE
sq cert export [OPTIONS]
DESCRIPTION¶
Manages certificates.
We use the term "certificate", or "cert" for short, to refer to OpenPGP keys that do not contain secrets. This subcommand provides primitives to generate and otherwise manipulate certs.
Conversely, we use the term "key" to refer to OpenPGP keys that do contain secrets. See `sq key` for operations on keys.
SUBCOMMANDS¶
sq cert import¶
Imports certificates into the local certificate store.
sq cert export¶
Exports certificates from the local certificate store.
If multiple predicates are specified a certificate is returned if at least one of them matches.
This does not check the authenticity of the certificates in anyway. Before using the certificates, be sure to validate and authenticate them.
When matching on subkeys or User IDs, the component must have a valid self signature according to the policy. This is not the case when matching the certificate's key handle using `--cert` or when exporting all certificates.
Fails if search criteria are specified and none of them matches any certificates. Note: this means if the certificate store is empty and no search criteria are specified, then this will return success.
EXAMPLES¶
sq cert import¶
Imports a certificate.
sq cert import < juliet.pgp
sq cert export¶
Exports all certificates.
sq cert export > all.pgp
Exports certificates with a matching User ID packet. The binding signatures are checked, but the User IDs are not authenticated. Note: this check is case sensitive.
sq cert export --userid 'Alice <alice@example.org>'
Exports certificates with a User ID containing the email address. The binding signatures are checked, but the User IDs are not authenticated. Note: this check is case insensitive.
sq cert export --email 'alice@example.org'
Exports certificates where the certificate (i.e., the primary key) has the specified Key ID.
sq cert export --cert 1234567812345678
Exports certificates where the primary key or a subkey matches the specified Key ID.
sq cert export --key 1234567812345678
Exports certificates that contain a User ID with *either* (not both!) email address. Note: this check is case insensitive.
sq cert export --email alice@example.org --email bob@example.org
SEE ALSO¶
sq(1), sq-cert-import(1), sq-cert-export(1).
For the full documentation see <https://book.sequoia-pgp.org>.
VERSION¶
0.33.0 (sequoia-openpgp 1.17.0)
0.33.0 | Sequoia-PGP |