---

---

---

ssh-import-id

Section: ssh-import (1)
Updated: 23 Feb 2010
Index Return to Main Contents

---

 

NAME

ssh-import-id - retrieve one or more public keys from a public keyserver (Launchpad.net by default) and append them to the current user's authorized_keys file (or some other specified file)

 

SYNOPSIS

ssh-import-id [options] USER_ID_1 [USER_ID_2] ... [USER_ID_n]

 

OPTIONS

 -h | --help            usage

 -e | --environment  use the current environment (by default, all environment variables are cleaned before importing ids)
 -o | --output F        write output to file 'F' (default ~/.ssh/authorized_keys, use "-" for standard out)

 

DESCRIPTION

This utility will securely contact a public keyserver (https://launchpad.net by default) and retrieve one or more user's public keys, and append these to the current user's ~/.ssh/authorized_keys file.

The system administrator can change the source URL used by ssh-import-id(1) by editing the configuration file, /etc/ssh/ssh_import_id, which is sourced to obtain the value of URL. By default, URL="https://launchpad.net/~%s/+sshkeys". Note that this url really MUST be a secure, https url with a valid, signed certificate or else your system will be vulnerable to man-in-the-middle attacks! The "%s" will be populated by ssh-import-id(1) with the value(s) of USER_ID_1 [USER_ID_2] ... [USER_ID_n].

The -e option will be necessary if you need to use a proxy defined in $https_proxy, for instance.

 

SEE ALSO

ssh(1)

 

FILES

/etc/ssh/ssh_import_id

 

AUTHOR

This manpage and the utility was written by Dustin Kirkland <kirkland@canonical.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.

---

 

Index

NAME

SYNOPSIS

OPTIONS

DESCRIPTION

SEE ALSO

FILES

AUTHOR

---

---

---