Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OPENPGP2SSH(1)		     General Commands Manual		  OPENPGP2SSH(1)

NAME
     openpgp2ssh -- translate OpenPGP keys to SSH keys

SYNOPSIS
     openpgp2ssh < mykey.gpg

     gpg --export $KEYID | openpgp2ssh $KEYID

     gpg --export $KEYID | openpgp2pem $KEYID

     gpg --export $KEYID | openpgp2spki $KEYID

     gpg --export-secret-key $KEYID | openpgp2ssh $KEYID

DESCRIPTION
     takes  an	OpenPGP-formatted primary key and associated subkeys on standard
     input, and spits out the requested equivalent  SSH-style  (or  PEM-encoded)
     key on standard output.

     If  the  data on standard input contains no subkeys, you can invoke without
     arguments.  If the data on standard input contains multiple  keys	(e.g.  a
     primary  key  and	associated subkeys), you must specify a specific OpenPGP
     key identifier as the first argument to indicate which key to export.   The
     key  ID is normally the 40 hex digit OpenPGP fingerprint of the key or sub-
     key desired, but will accept as few as the last 8 digits of the fingerprint
     as a key ID.

     If the input contains an OpenPGP RSA public key, it will  be  converted  to
     the  OpenSSH-style  single-line  keystring,  prefixed  with  the  key  type
     (`ssh-rsa').  This format is suitable (with minor alterations)  for  inser-
     tion  into  known_hosts  files  and  authorized_keys  files.  If invoked as
     `openpgp2pem', a PEM-encoded public key will be emitted instead.

     If invoked as `openpgp2spki', a PEM-encoded  subjectPublicKeyInfo	(as  de-
     fined in the X.509 standard) will be emitted instead.

     If  the  input  contains an OpenPGP RSA secret key, it will be converted to
     the equivalent PEM-encoded private key.

     is part of the monkeysphere(7) framework for providing a PKI for SSH.

CAVEATS
     The keys produced by this process are stripped of all identifying	informa-
     tion, including certifications, self-signatures, etc.  This is intentional,
     since ssh attaches no inherent significance to these features.

     will  produce  output  for  any requested RSA key.  This means, among other
     things, that it will happily export revoked keys,	unverifiable  keys,  ex-
     pired  keys,  etc.   Make	sure you do your own key validation before using
     this tool!

EXAMPLES
     gpg --export-secret-key $KEYID | openpgp2ssh $KEYID | ssh-add -c /dev/stdin

     This pushes the secret key into the active  ssh-agent(1).	 Tools	such  as
     ssh(1) which know how to talk to the ssh-agent(1) can now rely on the key.

AUTHOR
     and  this	man  page  were  written by Daniel Kahn Gillmor <dkg@fifthhorse-
     man.net>.

BUGS
     only works with RSA keys.	DSA keys are the only other key  type  available
     in  both  OpenPGP and SSH, but they are currently unsupported by this util-
     ity.

     only accepts raw OpenPGP packets on standard input.   It  does  not  accept
     ASCII-armored  input.   Currently	only  exports  into  formats used by the
     OpenSSH.  It should support other key output formats, such as those used by
     lsh(1) and putty(1).

     Secret key output is currently not passphrase-protected.

     currently cannot handle passphrase-protected secret keys on input.

SEE ALSO
     pem2openpgp(1), monkeysphere(1), monkeysphere(7), ssh(1),	monkeysphere-au-
     thentication(8), monkeysphere-host(8)

FreeBSD ports 15.quarterly	January 18,, 2013		  OPENPGP2SSH(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=openpgp2spki&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help