Bug 3028 - Discrepancy with URL man pages.
Summary: Discrepancy with URL man pages.
Status: CLOSED WORKSFORME
Alias: None
Product: Portable OpenSSH
Classification: Unclassified
Component: ssh-keygen (show other bugs)
Version: 7.4p1
Hardware: ix86 Linux
: P5 trivial
Assignee: Assigned to nobody
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2019-07-02 04:56 AEST by donald.p.richards1
Modified: 2021-03-04 09:54 AEDT (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description donald.p.richards1 2019-07-02 04:56:58 AEST
For the man pages under the URL, https://man.openbsd.org/ssh-keygen, the option -U states:

-U    When used in combination with -s, this option indicates that a CA key resides in a ssh-agent(1). See the CERTIFICATES section for more information.

Under the CERTIFICATES section, https://man.openbsd.org/ssh-keygen#CERTIFICATES, it states:

Similarly, it is possible for the CA key to be hosted in a ssh-agent(1). This is indicated by the -U flag and, again, the CA key must be identified by its public half.

$ ssh-keygen -Us ca_key.pub -I key_id user_key.pub

In all cases, key_id is a "key identifier" that is logged by the server when the certificate is used for authentication.

I have a use case in which having a Certificates Authority's private key loaded in the ssh-agent would be very beneficial (i.e. not having the private key unsecured), and then using it to sign ssh host certificates using 

    "ssh-keygen -Us ca_key.pub -h -I key_id host_key.pub"
Comment 1 donald.p.richards1 2019-07-02 05:34:06 AEST
I believe I found that ssh-keygen was updated to include -U at version 7.6/7.6p1.

* ssh-keygen(1): allow ssh-keygen to use a key held in ssh-agent as
   a CA when signing certificates. bz#2377
Comment 2 Damien Miller 2019-07-12 14:24:39 AEST
If I'm reading this correctly, you've figured this out already and were trying to use a feature added in a newer release of OpenSSH than the one you had at hand. 

As such, I'll close this bug. If I've misread the situation then please feel free to reopen.
Comment 3 Damien Miller 2021-03-04 09:54:00 AEDT
close bugs that were resolved in OpenSSH 8.5 release cycle