.TH SQ 1 0.38.0 "Sequoia PGP" "User Commands" .SH NAME sq key approvals \- Manages certification approvals .SH SYNOPSIS .br \fBsq key approvals list\fR [\fIOPTIONS\fR] .br \fBsq key approvals update\fR [\fIOPTIONS\fR] .SH DESCRIPTION Manages certification approvals. .PP Key holders may approve of third\-party certifications associated with their certificate. This subcommand manages the approvals. .PP To prevent certificate flooding attacks, modern key servers prevent uncontrolled distribution of third\-party certifications on certificates. To allow the key holder to control what information is distributed with their certificate, these key servers only distribute third\-party certifications that the key holder has explicitly approved. .PP .SH SUBCOMMANDS .SS "sq key approvals list" Lists third\-party certifications and their approval status. .PP To prevent certificate flooding attacks, modern key servers prevent uncontrolled distribution of third\-party certifications on certificates. To allow the key holder to control what information is distributed with their certificate, these key servers only distribute third\-party certifications that the key holder has explicitly approved. .PP .SS "sq key approvals update" Approves of third\-party certifications allowing for their distribution. .PP To prevent certificate flooding attacks, modern key servers prevent uncontrolled distribution of third\-party certifications on certificates. To allow the key holder to control what information is distributed with their certificate, these key servers only distribute third\-party certifications that the key holder has explicitly approved. .PP By default, all user IDs are considered, but if at least one `\-\-name`, `\-\-email`, or `\-\-userid` argument is given, only the matching user IDs are considered. .PP After the approvals have been changed, the certificate has to be distributed, e.g. by uploading it to a key server. .PP .SH EXAMPLES .SS "sq key approvals list" .PP .PP Lists the approved certifications on all the user IDs. .PP .nf .RS sq key approvals list \-\-cert \\ .RE .RS .RS EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .PP .fi .PP Lists the unapproved certifications on all the user IDs. .PP .nf .RS sq key approvals list \-\-pending \-\-cert \\ .RE .RS .RS EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .PP .fi .PP Lists all unapproved certifications on a given user ID. .PP .nf .RS sq key approvals list \-\-pending \-\-email alice@example.org \\ .RE .RS .RS \-\-cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .fi .PP .SS "sq key approvals update" .PP .PP Approve of all of the certifications on all of Alice's user IDs. .PP .nf .RS sq key approvals update \-\-add\-all \-\-cert \\ .RE .RS .RS EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .PP .fi .PP Approve of all of the certifications on all of Alice's user IDs made by Bob, discarding all prior approvals first. .PP .nf .RS sq key approvals update \-\-remove\-all \-\-add\-by \\ .RE .RS .RS 511257EBBF077B7AEDAE5D093F68CB84CE537C9A \-\-cert \\ .RE .RE .RS .RS EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .PP .fi .PP Approve of all of the certifications on a specific user ID by certifiers that can be authenticated, discarding all prior approvals first. .PP .nf .RS sq key approvals update \-\-remove\-all \-\-add\-authenticated \\ .RE .RS .RS \-\-cert EB28F26E2739A4870ECC47726F0073F60FD0CBF0 \\ .RE .RE .RS .RS \-\-userid "Alice " .RE .RE .PP .fi .PP Remove the approval of Bob's certification on all of Alice's user IDs. .PP .nf .RS sq key approvals update \-\-remove\-by \\ .RE .RS .RS 511257EBBF077B7AEDAE5D093F68CB84CE537C9A \-\-cert \\ .RE .RE .RS .RS EB28F26E2739A4870ECC47726F0073F60FD0CBF0 .RE .RE .fi .SH "SEE ALSO" .nh \fBsq\fR(1), \fBsq\-key\fR(1), \fBsq\-key\-approvals\-list\fR(1), \fBsq\-key\-approvals\-update\fR(1). .hy .PP For the full documentation see . .SH VERSION 0.38.0 (sequoia\-openpgp 1.21.2)