ssh-add(1)

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

ssh-add [−lLdDxXc] [−t 生存時間] [file ...]

ssh-add −s リーダ

ssh-add −e リーダ

解説

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

ssh-add がうまく動くためには、認証エージェントが動いていて、環境変数 SSH_AUTH_SOCK がそのソケットの名前を持っている必要があります。

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

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

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

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

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

−x
エージェントをパスワードでロックします。

−X
エージェントのロックをはずします。

−t 生存時間
エージェントに鍵を追加するさい、その鍵の最大生存時間を指定しま す。生存時間は秒数、あるいは sshd_config(5) で使われている形式で 指定できます。

−c
追加された鍵を、認証に使う前に確認するよう指定します。この確認 は、以下で説明する SSH_ASKPASS プログラムによっておこなわれます。 確認の成功は、 SSH_ASKPASS プログラムに入力された文字列ではなく、 これが終了状態として 0 を返したかどうかによって決定されます。

−s リーダ
スマートカード reader に鍵を追加します。

−e リーダ
スマートカード reader から鍵を削除します。

環境変数

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

SSH_AUTH_SOCK
エージェントと通信するための unix ドメインソケットへのパス名が 入っています。

関連ファイル

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

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

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

秘密鍵の入ったファイルは本人以外の誰にも読まれてはいけません。他人から読 めるようになっていると、 ssh-add はこのファイルを無視します。

診断

ssh-add は、成功すると終了状態として 0 を、指定されたコマンドが失敗すると 1 を、認証エージェントと通信できない場合は 2 を返します。

ssh(1), ssh-agent(1), ssh-keygen(1), sshd(8)

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 の貢献によるものです。

新山 祐介 (yusuke at cs . nyu . edu) 2002/6/21 (for 3.3 p1)

当マニュアルページは氏のご好意により FreeBSD 向けに修正を加えて FreeBSD 日本語マニュアルに収録させていただいています。翻訳についてのご意見、ご指 摘がありましたら FreeBSD jpman プロジェクト ⟨man-jp@jp.FreeBSD.org⟩ また は新山氏 (yusuke at cs . nyu . edu) までお送りください。

FreeBSD 10.0 September 25, 1999 FreeBSD 10.0