# ssh-import-id(1) - man - phpMan

[ssh-import-id(1)](https://www.chedong.com/phpMan.php/man/ssh-import-id/1/markdown)                             ssh-import                             [ssh-import-id(1)](https://www.chedong.com/phpMan.php/man/ssh-import-id/1/markdown)



## NAME
       **ssh-import-id**  -  retrieve one or more public keys from a public keyserver and append them to
       the current user's authorized_keys file (or some other specified file)


## SYNOPSIS
       **ssh-import-id** **[options]** **USER**___**ID**___**1** **[gh:USER**___**ID**___**2]** **...** **[lp:USER**___**ID**___**n]**

       **ssh-import-id-lp** **USER**___**ID**___**1** **[USER**___**ID**___**2]** **...** **[USER**___**ID**___**n]**

       **ssh-import-id-gh** **USER**___**ID**___**1** **[USER**___**ID**___**2]** **...** **[USER**___**ID**___**n]**


## OPTIONS
        -h | --help        usage
        -o | --output F    write output to file 'F' (default  ~/.ssh/authorized_keys,  use  "-"  for
       standard out)
        -r | --remove      remove keys from authorized keys file 'F'
        -u | --useragent U append U to the user agent string
        PROTO:USER_ID      Protocol can be 'lp' for Launchpad.net, or 'gh' for Github.com


## DESCRIPTION
       This  utility will securely contact a public keyserver and retrieve one or more user's public
       keys, and append these to the current user's _~/.ssh/authorized_keys_ file, standard output  or
       any other specified output file.

       User IDs can be prepended by a protocol:

        - **lp:** to use _<https://launchpad.net/~%s/>+sshkeys_
        - **gh:** to use _<https://api.github.com/users/%s/keys_>

       If  the  protocol  is  not  explicitly specified, then **ssh-import-id** will read a URL variable
       string from _/etc/ssh/ssh_import_id_ as installed by your package  manager  and  configured  by
       your system administrator.  You can override this locally by exporting the string you want in
       a URL environment variable.  If all of these are empty, then the protocol is  assumed  to  be
       "lp:", which was the original target implementation of this tool.

       Any  keys  added  will  be "labled" with a trailing comment, "# ssh-import-id PROTO:USER_ID".
       Revoking keys will first look for lines in the authorized keys file ending with that label.


## SEE ALSO
       [_ssh_(1)](https://www.chedong.com/phpMan.php/man/ssh/1/markdown)


## FILES
       _/etc/ssh/ssh_import_id_


## AUTHOR
       This manpage and the utility was written by Dustin Kirkland  <<dustin.kirkland@gmail.com>>  for
       Ubuntu systems (but may be used by others).  Permission is granted to copy, distribute and/or
       modify this document under the terms of the GNU General Public License, Version  3  published
       by the Free Software Foundation.

       On  Debian  systems,  the  complete  text  of  the GNU General Public License can be found in
       /usr/share/common-licenses/GPL.



ssh-import                                   4 Feb 2013                             [ssh-import-id(1)](https://www.chedong.com/phpMan.php/man/ssh-import-id/1/markdown)