SSH-ADD(1)

名称
ssh-add - 認証エージェントに RSA あるいは DSA 秘密鍵を追加する

書式
ssh-add [-lLdD] [file ...]

解説
ssh-add は認証エージェントである ssh-agent(1). に、 RSA あるいは DSA の認証鍵を追加します。 引数なしで実行された場合、これは $HOME/.ssh/identity ファイルを追加します。コマンドラインから別の ファイル名を与えることもできます。パスフレーズが必要な場合、 ssh-add はユーザにそれを尋ねます。 このパスフレーズはユーザの端末から読み込まれます。 複数の identity ファイルが指定された場合、 ssh-add は最後に入力されたパスフレーズをくり返し使います。

ssh-add がうまく動くためには、認証エージェントが動いていて、 しかもしれが現在のプロセスの先祖になっている必要があります。

オプションは以下のとおりです:

-l  現在、エージェントによって保持されているすべての鍵の指紋 (fingerprint) を表示します。

-L  現在、エージェントによって保持されているすべての公開鍵の 情報を表示します。

-d  鍵を追加するのではなく、エージェントから鍵を取り除きます。

-D  エージェントからすべての鍵を取り除きます。

関連ファイル

$HOME/.ssh/identity
    そのユーザがプロトコル バージョン 1 で使用する RSA 認証用の秘密鍵が 入っています。 ファイルは本人以外の誰にも読まれてはいけません。他人から 読めるようになっていると、 ssh-add はこのファイルを無視します。 鍵を作成するときにパスフレーズが指定されることもあります。 パスフレーズはこのファイルの秘匿された部分を暗号化するのに使われます。 ssh-add に他のファイル名をなにも指定しないとき、 このファイルがデフォルトとして使われます。

$HOME/.ssh/id_dsa
    そのユーザがプロトコル バージョン 2 で使用する DSA 認証用の秘密鍵が入っています。

$HOME/.ssh/id_rsa
    そのユーザがプロトコル バージョン 2 で使用する RSA 認証用の秘密鍵が入っています。

環境変数

DISPLAY and SSH_ASKPASS
    ssh-add は端末で走っている場合、パスフレーズが必要になると その端末からパスフレーズを読み込みます。 ssh-add の使える端末がないときでも、環境変数 DISPLAY と SSH_ASKPASS が設定されていれば、 ssh-add は SSH_ASKPASS で指定されたプログラムを立ち上げ、パスフレーズを読むための X11 ウインドウを開きます。これは特に ssh-add を .Xsession などのスクリプトから走らせるときに有効です (機種によっては、これがうまく動作するためには入力を /dev/null にリダイレクトしておく必要があるかもしれません)。

作者
OpenSSH は Tatu Ylonen による、フリーな オリジナル版 ssh 1.2.12 リリースから派生したものです。 Aaron Campbell、 Bob Beck、 Markus Friedl、 Niels Provos、 Theo de Raadt および Dug Song が多くのバグをとり除き、 新しい機能をふたたび追加して OpenSSH をつくりました。 SSH プロトコル バージョン 1.5 および 2.0 のサポートは Markus Friedl の貢献によるものです。

日本語訳
新山 祐介 (euske@cl.cs.titech.ac.jp) 2001/5/24

当マニュアルページは氏のご好意により FreeBSD 日本語マニュアルに収録させていただいています。 翻訳についてのご意見、ご指摘がありましたら新山氏 <euske@cl.cs.titech.ac.jp>、および FreeBSD jpman プロジェクト <man-jp@jp.FreeBSD.org> までお送りください。

関連項目
ssh(1), ssh-agent(1), ssh-keygen(1), sshd(8)