SSH(1)

名前
ssh - OpenSSH SSH クライアント (リモート ログイン プログラム)

書式
ssh [-1246AaCfgkMNnqsTtVvXxY] [-b bindするアドレス] [-c 暗号方式] [-D [bindするアドレス:] ポート] [-e エスケープ文字] [-F 設定ファイル] [-i identityファイル] [-L [bindするアドレス:] ポート:ホスト:ホスト側ポート] [-l ログイン名] [-m MAC指定] [-O 制御コマンド] [-o オプション] [-p ポート] [-R [bindするアドレス:] ポート:ホスト:ホスト側ポート] [-S 制御用パス名] [-w ローカルtun [:リモートtun]] [ユーザ@]ホスト名 [コマンド]

説明
ssh (SSH クライアント) はリモートマシンにログインしたり、 リモートマシン上でコマンドを実行するためのプログラムです。 これは rlogin と rsh を置き換えるためのもので、 安全でないネットワーク上にある 2 つの信頼されていないホスト間で、 暗号化された安全な通信を提供します。X11 接続や 任意の TCP ポートなども安全な通信路を通して転送できます。

ssh は指定された ホスト名 に接続し、 (オプションが指定された場合はその ユーザ で) ログインします。 ユーザはリモートマシンに対して、 本人であることを証明する必要があります。 プロトコルのバージョンに応じて、これには いくつかある方法からひとつを使います (下記参照) :

コマンド が指定された場合、リモートホスト上では ログインシェルのかわりにそのコマンドが実行されます。

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

-1  ssh がプロトコル バージョン 1 のみを使うよう強制します。

-2  ssh がプロトコル バージョン 2 のみを使うよう強制します。

-4  ssh が IPv4 アドレスのみを使うよう強制します。

-6  ssh が IPv6 アドレスのみを使うよう強制します。

-A  認証エージェントの転送を許可します。 これは設定ファイルによってホストごとに指定することも可能です。

    認証エージェントの転送には注意が必要です。 リモートホスト上で (エージェントの UNIX ドメインソケットに対する) ファイルアクセス権限を無視できてしまうユーザがいる場合は、 転送された接続を介してローカル側の 認証エージェントにアクセスできてしまうことになります。 攻撃側は認証エージェントから鍵そのものを盗むことはできませんが、 認証エージェントがもっている鍵に認証をおこなわせることはできます。

-a  認証エージェントの転送を禁止します。

-b bindするアドレス
    接続のソース側のインターフェイスとして、 bindするアドレス を使います。 これが有用なのは、複数の IP アドレスをもつマシン上のみです。

-C  すべてのデータを圧縮するよう指示します (標準入力、標準出力、 標準エラー出力、転送された X11 や TCP 接続を含む)。圧縮に 使われるアルゴリズムは gzip(1) と同じもので、プロトコル バージョン 1 の場合 “レベル” が CompressionLevel 設定項目によって変更できます。 圧縮は、モデムその他の遅い接続においては必要ですが、高速な ネットワークでは速度が低下するだけです。このデフォルト値は ホスト間ごとに設定ファイルに書くことができます。 Compression 設定項目を参照してください。

-c 暗号方式
    このセッションで使われる暗号の方式を指定します。

    プロトコル バージョン 1 の場合、指定できる方式はひとつで “3des 、” “blowfish” および “des” がサポートされています。 3des (トリプル des) は 3 つの異なる鍵を使って 暗号化-復号化-暗号化をおこないます。 これは安全であると考えられているためです。 blowfish は高速なブロック暗号方式で、かなり安全であり、 3des よりもずっと高速です。 des は、 3des 暗号をサポートしていない、もはや古くなったプロトコル 1 の実装と 相互運用するためにのみサポートされています。 des 暗号は弱いため、このオプションを使用することはおすすめできません。 デフォルトは “3des” です。

    プロトコル バージョン 2 では、 cipher_spec はカンマで区切られたリストになっており、 暗号方式の優先順位を指定できます。 現在サポートされている暗号方式は以下のとおりです: 3des-cbc , aes128-cbc , aes192-cbc , aes256-cbc , aes128-ctr , aes192-ctr , aes256-ctr , arcfour128 , arcfour256 , arcfour , blowfish-cbc , そして cast128-cbc 。 デフォルトでは

        aes128-cbc,3des-cbc,blowfish-cbc,cast128-cbc,arcfour128,
        arcfour256,arcfour,aes192-cbc,aes256-cbc,aes128-ctr,
        aes192-ctr,aes256-ctr

    になっています。

-D  [bindするアドレス:] ポート ローカルホスト側における、アプリケーションレベルの “動的な” ポート転送を指定します。 これは次のように実現しています。まずローカル側で ポート を listen するソケットを割り当てます。 bindするアドレス が与えられた場合はそのアドレスで listen します。 このポートに向けて接続が張られると、 その接続はつねに安全な通信路に転送されるように なります。そして、ここでアプリケーションプロトコルが使われ、 そのリモートマシンからどこに接続するかを決めることができます。 今のところ SOCKS4 および SOCKS5 プロトコルが使われており、 ssh は SOCKS サーバのようにふるまいます。 特権ポートを転送できるのはスーパーユーザだけです。 動的ポート転送は設定ファイルでも指定できます。

    IPv6 アドレスはこれとは別の形式で指定できます: [bindするアドレス/] ポート あるいは、アドレスを角カッコ [ ] で囲んでください。 特権ポートを転送できるのはスーパーユーザだけです。 デフォルトでは、ローカル側のポートは GatewayPorts の設定に従って bind されますが、 bindするアドレス を明示的に使うことで特定のアドレスに 接続を bind することもできます。 bindするアドレス が “localhost” になっている場合、そのポートはローカルホストのみが 使用可能であることを示します。いっぽう、空のアドレスや ‘*’ を指定すると、そのポートは すべてのインターフェイスに対して使用可能になります。

-e エスケープ文字
    仮想端末を使うセッションにおけるエスケープ文字を指定します (デフォルトは ‘~’ )。エスケープ文字は行頭に来たときのみ認識されます。 エスケープ文字のあとにドット ‘’. がきた場合その接続は閉じられ、control-Z がきた場合には その接続はサスペンドされます。 このエスケープ文字自身が続いたときには、この文字が 1 回だけ送られます。 エスケープ文字を “none” に指定するとあらゆるエスケープ機能が禁止され、 セッションは完全に透過になります。

-F 設定ファイル
    ユーザ毎の設定ファイルに別のファイルを指定します。 設定ファイルがコマンドラインから与えられた場合、 システム全体の設定ファイル (/etc/ssh/ssh_config) は無視されます。デフォルトでは、ユーザ毎の設定ファイルは ~/.ssh/config になっています。

-f  ssh がコマンドを実行する直前に、 バックグラウンドに移行するよう指示します。これは ssh にパスワードあるいはパスフレーズを入力する必要はあるものの、 そのコマンド自体はバックグラウンドで実行させたいときに便利です。 これは -n オプションも含んでいます。 リモートサイトで X11 プログラムを起動させる場合には、 ssh -f host xterm などとやるのがおすすめです。

-g  リモートホストが転送されたローカルなポートに接続することを許可します。

-I スマートカードデバイス
    ssh がユーザの RSA 秘密鍵を格納するスマートカードと 通信するのに使うデバイスを指定します。 このオプションはスマートカード・デバイスのサポートを 有効にしてコンパイルされているときだけ有効です (デフォルトではサポートされていません)。

-i identityファイル
    RSA 認証 あるいは DSA 認証の際に identity (秘密鍵) を読むファイルを指定します。 デフォルトは、プロトコル バージョン 1 の場合 ユーザのホームディレクトリにある ~/.ssh/identity 、プロトコル バージョン 2 の場合は ~/.ssh/id_rsa および ~/.ssh/id_dsa になっています。identity ファイルは設定ファイルによって、 ホストごとに指定することもできます。複数の -i オプションを指定することも可能です。 (設定ファイルで複数の鍵を指定することもできます。)

-k  GSSAPI 証明書 (credential) をサーバに転送 (委譲、delegation) することを禁止します。

-L  [bindするアドレス:] ポート:ホスト:ホスト側ポート 与えられたローカル (クライアント) ホスト上のポートが、 与えられたリモートホスト上のポートに転送されるよう指定します (ローカル→リモートのポート転送)。 これはローカル側で ポート に listen (接続受け付け) 用の ソケットを割り当てることによりおこなわれます。さらに bindするアドレス が与えられている場合は、ソケットはこのアドレスに bind されます。 このポートに向けておこなわれた接続はつねに 安全な通信路を経由してリモートマシン上に到達し、そこから ホスト のポート ホスト側ポート に接続されるようになります。 ポート転送は設定ファイルによっても指定できます。 IPv6 アドレスの場合は、指定する形式が異なります: [bindするアドレス/] ポート/ホスト/ ホスト側ポート またはアドレスを角カッコ [ ] で囲んでください。 特権ポートを転送できるのはスーパーユーザ だけです。 デフォルトでは、ローカル側のポートは GatewayPorts の設定に従って bind されますが、 bindするアドレス を明示的に指定することで、特定のアドレスに接続をふり向けることができます。 bindするアドレス として “localhost” を指定すると、ポートを listen するのはローカルな使用のみに限ることになります。 いっぽう、空のアドレスまたは ‘*’ を指定すると、そのポートはすべてのインターフェイスに対して使用可能になります。

-l ログイン名
    リモートマシン上でログインするユーザ名を指定します。 これは設定ファイルによって、ホストごとに指定することもできます。

-M  ssh を、接続を共有するための “master” モードにします。 -M オプションを複数個つけると ssh は “master” モードになり、slave 接続を受けつける前に確認を求めます。 詳細については ssh_config(5) の ControlMaster の項を参照してください。

-m MAC指定
    プロトコル バージョン 2 では、カンマで区切ったリストにより、 使用する MAC (message authentication code、 メッセージ認証コード) を優先順位を つけて指定することができます。 MAC についての詳しい情報は MACs の項をご覧ください。

-N  リモートコマンドを実行しません。これはポート転送のみを おこないたい場合に便利です (プロトコル バージョン 2 のみ)。

-n  標準入力を /dev/null からリダイレクトするように (つまり標準入力からの読み込みを禁止した状態に) します。 ssh をバックグラウンドで走らせるときには、このオプションが不可欠です。 よくある手としては、リモートマシン上で X11 のプログラムを 走らせるときにこれを使うことです。たとえば、 ssh -n shadows.cs.hut.fi emacs & で emacs を立ち上げると、X11 接続は暗号化された経路を 介して自動的に転送されます。 ssh プログラムはこの後バックグラウンドに移行するでしょう。 (これは ssh がパスワードあるいはパスフレーズを訊いてくるときには使えません。 -f オプションを参照してください。)

-O 制御コマンド
    マスタープロセスから分岐した現在使用中の接続を制御します。 -O オプションが指定されている場合、 制御コマンド の指令はマスタープロセスに渡されます。 使用可能なコマンドは以下のとおりです: “check” (マスタープロセスが走っているかどうかチェックする) および “exit” (マスタープロセスを終了するよう指示する)

-o オプション
    設定ファイルと同じ形式でオプションを与えたいときに使用します。 これはコマンドラインオプションでは指定できないオプションを 指定したいときに便利です。 以下のオプションの詳細と、これらがとりうる値については ssh_config(5) を参照してください。

    AddressFamily
    BatchMode
    BindAddress
    ChallengeResponseAuthentication
    CheckHostIP
    Cipher
    Ciphers
    ClearAllForwardings
    Compression
    CompressionLevel
    ConnectionAttempts
    ConnectTimeout
    ControlMaster
    ControlPath
    DynamicForward
    EscapeChar
    ExitOnForwardFailure
    ForwardAgent
    ForwardX11
    ForwardX11Trusted
    GatewayPorts
    GlobalKnownHostsFile
    GSSAPIAuthentication
    GSSAPIDelegateCredentials
    HashKnownHosts
    Host
    HostbasedAuthentication
    HostKeyAlgorithms
    HostKeyAlias
    HostName
    IdentityFile
    IdentitiesOnly
    KbdInteractiveDevices
    LocalCommand
    LocalForward
    LogLevel
    MACs
    NoHostAuthenticationForLocalhost
    NumberOfPasswordPrompts
    PasswordAuthentication
    PermitLocalCommand
    Port
    PreferredAuthentications
    Protocol
    ProxyCommand
    PubkeyAuthentication
    RekeyLimit
    RemoteForward
    RhostsRSAAuthentication
    RSAAuthentication
    SendEnv
    ServerAliveInterval
    ServerAliveCountMax
    SmartcardDevice
    StrictHostKeyChecking
    TCPKeepAlive
    Tunnel
    TunnelDevice
    UsePrivilegedPort
    User
    UserKnownHostsFile
    VerifyHostKeyDNS
    XAuthLocation

-p ポート
    リモートホストに接続するポートを指定します。 これは設定ファイルによって、ホストごとに指定することもできます。

-q  静かなモード。すべての警告メッセージや診断メッセージは抑制されます。

-R  [bindするアドレス:] ポート:ホスト:ホスト側ポート 与えられたリモート (サーバ) ホスト上のポートが、 与えられたローカルホスト上のポートに転送されるよう指定します (リモート→ローカルのポート転送)。 これはリモート側で ポート に listen (接続受け付け) 用の ソケットを割り当てることによりおこなわれます。 このポートに向けておこなわれた接続はつねに 安全な通信路を経由してローカルマシン上に到達し、ここから ホスト のポート ホスト側ポート に接続されるようになります。

    ポート転送は設定ファイルによっても指定できます。特権ポートを 転送できるのは、リモートマシン上に root としてログインしているときだけです。 IPv6 アドレスの場合はアドレスを角カッコ [ ] の中に入れるか、 別の形式で指定します: [bindするアドレス/] ホスト/ポート/ ホスト側ポート

    デフォルトでは、サーバ側で listen するソケットは ループバックインターフェイスのみに bind されます。 これは bindするアドレス を指定することによって上書きすることができます。 空の bindするアドレス または ‘*’ をアドレスとして指定すると、サーバ側のソケットは すべてのインターフェイスに対して listen するようになります。 bindするアドレス にループバック以外の値が指定できるのは、 GatewayPorts オプションが許可されているときのみです ( sshd_config(5) を参照してください)。

-S 制御用パス名
    接続を共有する際の制御用ソケットの位置を指定します。 詳細については ssh_config(5) の ControlMaster および ControlPath の項を参照してください。

-s  リモート側でサブシステムの実行を要求するときに使われます。 サブシステムは SSH2 プロトコルで実現された機能であり、 これを使うと SSH を他のアプリケーション ( sftp(1) など) への安全な通信路として利用することができます。この場合、 サブシステム名はリモートコマンドとして指定します。

-T  仮想端末の割り当てを禁止します。

-t  強制的に仮想端末を割り当てます。これはリモートマシン上で 任意の画面ベースのプログラムを実行するとき (たとえば、メニューサービスを実装するときなど) に非常に便利です。 複数の -t をつけると、たとえ ssh がローカル側での端末を持っていない場合でも 強制的に仮想端末を割り当てます。

-V  バージョン番号を表示して終了します。

-v  冗長表示モード。 ssh が進行中のデバッグメッセージを表示するようにします。 これは接続や認証、設定の問題をデバッグするときに助けとなります。 複数の -v オプションをつけると出力が増えます。最大は 3 個です。

-w  ローカルtun[:リモートtun] クライアント側の ローカルtun と、サーバ側の リモートtun の tun(4) デバイスを使ったトンネリングを要求します。 これらのデバイスは数値か、あるいはキーワード “any” によって指定します。このキーワードを指定すると、 現在の次に使用可能なトンネルデバイスが使われます。 If リモートtun が指定されない場合は、デフォルトで “any” になります。 ssh_config(5) の TunnelDevice 項目も参照してください。 Tunnel 項目が指定されていない場合、トンネルモードは デフォルトの “point-to-point” になります。

-X  X11 の転送を許可します。 これは設定ファイルによって、ホストごとに指定することもできます。

    X11 の転送には注意が必要です。 リモートホスト上で (そのユーザの X 認証のための) ファイルアクセス権限を 無視できてしまうユーザがいる場合は、転送された接続を介してローカル側の X11 ディスプレイにアクセスできてしまうことになります。 すると攻撃側はキーストロークを盗み見るなどの行為が可能になってしまうかも しれません。

    このため、デフォルトでは X11 転送は X11 SECURITY 拡張機能の制約を うけるようになっています。詳しくは、 ssh の -Y オプション、および ssh_config(5) の ForwardX11Trusted 項目を参照してください。

-x  X11 の転送を禁止します。

-Y  信頼された X11 転送を許可します。 信頼された X11 転送は、X11 SECURITY 拡張機能の制約をうけることはありません。

さらに ssh は、設定情報をユーザごとの設定ファイルおよび、 システム全体にわたる設定ファイルから取得します。 このファイルの形式と設定項目は ssh_config(5) で説明されています。

ssh はリモートで実行されたコマンドの終了状態か、 もしエラーが発生した場合は 255 を終了状態として返します。

認証
OpenSSH SSH クライアントは SSH プロトコル バージョン 1 と プロトコル バージョン 2 をサポートしています。 デフォルトはプロトコル バージョン 2 です。 これがサポートされていない場合、 ssh はプロトコル バージョン 1 に戻ります。 この設定は ssh_config(5) の Protocol 設定項目で変更するか、あるいは -1 または -2 オプション (上記参照) によって強制的に指定できます。 どちらのプロトコルも類似の認証機構を サポートしていますが、プロトコル バージョン 2 は より強力な秘匿性 (通信は AES、 3DES、 Blowfish、 CAST128 または Arcfour で 暗号化されます) および正真性 (hmac-md5, hmac-sha1, hmac-ripemd160) を提供しているため、 こちらのほうが好まれます。 プロトコル バージョン 1 は接続の正真性を保証する (訳注: 内容の改ざんを防ぐ) 強力な機構が用意されていません。

認証方式として使用可能なのは、 GSSAPIベースの認証 (GSSAPI-based authentication)、 ホストベースド認証 (host-based authentication)、 公開鍵認証 (public key authentication)、 チャレンジ・レスポンス認証 (challenge-response authentication) およびパスワード認証 (password authentication) です。 認証方式はここに示した順序で使用されます。 ただしプロトコル バージョン 2 では PreferredAuthentications 設定項目によりこのデフォルトの順序を変更することもできます。

ホストベースド認証 (hostbased authentication) は 以下のように動作します: ユーザが ssh を実行するマシンが、リモートマシン側の /etc/hosts.equiv あるいは /etc/shosts.equiv に記載されており、さらにそのユーザ名が 双方で同じか、あるいはリモートマシン上の そのユーザのホームディレクトリに ~/.rhosts あるいは ~/.shosts が存在して、クライアントマシンの名前と そのマシン上でのそのユーザ名が記載されている場合、 そのユーザのログインが考慮されます。 サーバはさらに、このクライアントのホスト鍵 (以下の /etc/ssh/ssh_known_hosts と ~/.ssh/known_hosts を参照) が 必ず 正しいことを要求します。 これが正しければログインが許可されます。 この認証方式により IP 詐称、DNS 詐称やルーティング詐称などの 攻撃が迂回できます。 [管理者のかたに注意: 一般的にいって、 /etc/hosts.equiv 、 ~/.rhosts および rlogin/rsh プロトコルは本質的に危険であり、 セキュリティを考慮するのであれば禁止すべきです。]

公開鍵認証 (public key authentication) は 以下のようにして動作します: このやりかたは公開鍵暗号技術に基づいており、 暗号化と復号をそれぞれ別の鍵を使っておこなう ことができ、さらに復号用の鍵から暗号化用の鍵を 推測することは現実的にできないような暗号方式を使っています。 このアイデアは、まず各ユーザが認証のための 「秘密鍵」と「公開鍵」とよばれる鍵の対をつくります。 サーバは公開鍵を知っていますが、 秘密鍵のほうはユーザだけが知っているものとします。 ssh は公開鍵認証を実装しており、RSA あるいは DSA 方式を 使用しています。プロトコル バージョン 1 が使えるのは RSA 方式だけですが、プロトコル バージョン 2 では どちらも使うことができます。 ssl(8) の 歴史 セクションでは、 これら 2つの方式について簡単に説明しています。

~/.ssh/authorized_keys ファイルには、ログインが許可されている 公開鍵の一覧が書かれています。ユーザがログインする際、 ssh プログラムは、そのユーザがどの鍵の対を使って 認証しようとしているかをサーバに伝えます。 クライアントは自分が秘密鍵にアクセスできることを サーバに対して証明し、サーバはそれに対応する公開鍵が そのアカウントを受け入れる権限をもっているかどうかを 調べます。

ユーザは ssh-keygen(1) を使って自分の鍵の対をつくります。 このプログラムは、秘密鍵をユーザのホームディレクトリ内の ~/.ssh/identity (プロトコル バージョン 1)、 ~/.ssh/id_dsa (プロトコル バージョン 2、DSA 方式) あるいは ~/.ssh/id_rsa (プロトコル バージョン 2、RSA 方式) に格納し、 公開鍵を ~/.ssh/identity.pub (プロトコル バージョン 1)、 ~/.ssh/id_dsa.pub (プロトコル バージョン 2、DSA 方式) あるいは ~/.ssh/id_rsa.pub (プロトコル バージョン 2、RSA 方式) に格納します。 ユーザはこの公開鍵をリモートマシン上の 自分のホームディレクトリにある ~/.ssh/authorized_keys ファイルにコピーする必要があります。 authorized_keys ファイルは従来の ~/.rhosts ファイルに相当し、1 行ごとにひとつの鍵を格納します。 各行はかなり長くなることもあります)。 この後、ユーザはパスワードなしでログインすることができます。

公開鍵認証を使う際にいちばん便利なのは 「認証エージェント」と呼ばれるものを使うことでしょう。 詳しくは ssh-agent(1) のマニュアルページをごらんください。

チャレンジ・レスポンス認証は以下のようにして動作します: サーバは任意の "チャレンジ" 文字列を送り、応答 (レスポンス) を求めます。 プロトコル バージョン 2 では複数のチャレンジとレスポンスを 許可しています。 プロトコル バージョン 1 で使えるチャレンジとレスポンスは 1 つだけです。 チャレンジ・レスポンス認証の例としては、 BSD 認証 ( login.conf(5) を参照) や PAM (OpenBSD 以外のいくつかのシステム) などが あります。

もし他の認証方法が失敗した場合、 ssh はユーザにパスワードを要求します。 このパスワードは検査のためリモートホストに送られますが、 すべての通信は暗号化されているため、 ネットワークを盗聴している何者かに よってパスワードが見られてしまうようなことはありません。

ssh はこれまでに使った鍵すべてが入っているデータベースを 自動的に保持し、検査します。これらのうち、ホスト鍵はユーザの ホームディレクトリにある ~/.ssh/known_hosts に格納されます。これらに加え、 /etc/ssh/ssh_known_hosts も既知のホストとして自動的に検査されます。 新しいホストは、ユーザ側のファイルに自動的に追加されていきます。 もしあるホストの鍵がこれまでと変わっていた場合、 ssh は警告を発してパスワード認証を禁止します。 これはサーバの詐称やなりすまし攻撃を防ぐためです。 StrictHostKeyChecking 設定項目はホスト鍵が知られていなかったり、 それが変更されていた場合のログインを防ぐために使われます。

そのユーザが本人であることが確認できると、 サーバは与えられたコマンドを実行するか、あるいはユーザを そのマシンにログインさせてリモートマシンでの 標準的なシェルを与えます。 リモートのシェルやコマンドにおけるすべての通信は 自動的に暗号化されます。

仮想端末が割り当てられている場合 (通常のログインセッション時)、ユーザは 以下のエスケープ文字を使うことができます。

仮想端末が割り当てられていない場合、 そのセッションは透過になります。そのため、 バイナリデータでも確実に転送できます。 ほとんどのシステムでは、 たとえ仮想端末が割り当てられている場合でもエスケープ文字に “none” を設定することによって、 そのセッションを透過にすることができます。

セッションは、リモートマシン上のコマンドやシェルが完了し、 すべての X11 や TCP 接続が閉じられると終了します。

エスケープ文字
仮想端末が割り当てられている場合、 ssh ではエスケープ文字を使った機能が いくつかサポートされています。

チルダ記号そのものを 1 回入力するには ~~ を押すか、上で述べられている以外の文字をチルダに続けます。 エスケープ文字は、つねに改行の直後に来なければ特別な文字とは 見なされません。エスケープ文字は、設定ファイルの EscapeChar 設定項目あるいはコマンドラインの -e オプションで変更できます。

現在サポートされているエスケープ機能 (エスケープ文字はデフォルトの ‘~’ と仮定します) :

~.  接続を切断します。

~^Z sshをバックグラウンドに移行させます。

~#  いま転送されている接続の一覧を表示します。

~&  ssh をバックグラウンドに移行させ、転送された接続あるいは X11 の セッションが終了するのを待ってログアウトします。

~?  エスケープ文字の一覧を表示します。

~B  リモートホストに BREAK 信号を送信します (SSH プロトコル バージョン 2 で相手もそれを サポートしている場合にのみ有効)。

~C  コマンドラインをオープンします。 現在これは -L や -R オプション (上記参照) を使っていて、 ポート転送を追加したい場合に有効です。 また、これは -KR[bindするアドレス:]ポート を使うことによって、すでに有効になっている リモート側のポート転送を中止することも可能です。 !command を使うと、 ssh_config(5) の PermitLocalCommand 設定項目が許可されている場合、ユーザは ローカルなコマンドを実行することができます。 基本的なヘルプは -h オプションを使ってください。

~R  その接続の rekeying を要求します (SSH プロトコル バージョン 2 で、 なおかつ相手がこれをサポートしているときのみ有効)。

TCP 転送
安全な通信路を使った任意の TCP/IP 接続への転送は、 コマンドラインあるいは設定ファイルで指定します。 TCP 転送の応用として、メールサーバへの安全な 接続が考えられます。ほかにもファイヤーウォールを またいで通信するなどの使いみちがあるでしょう。

以下の例では、IRC クライアントとサーバの通信を 暗号化する方法を紹介します。たとえ IRC サーバが 暗号化を直接サポートしていなくても、 通信を暗号化することができます。 これは以下のようにして動作します: まず、ユーザがリモートホストに ssh で接続し、リモートのサーバに接続を転送するために使う ポート番号を指定します。このあと、クライアントマシン上で 暗号化のサービスを開始し、ローカルな同じポートに接続すると、 ssh はその接続を暗号化して転送します。

以下の例では IRC のセッションを クライアントマシン “127.0.0.1” (localhost) からリモートのサーバ “server.example.com” へとトンネリングします:

    $ ssh -f -L 1234:localhost:6667 server.example.com sleep 10
    $ irc -c '#users' -p 1234 pinky 127.0.0.1

これはポート 1234 を使って IRC サーバ “server.example.com” への接続をトンネリングし、ニックネーム “pinky” で “#users” チャンネルに join します。 ポート番号は、1024 以上であり (特権ポートを使用できるのは root だけです)、 他のポートとかち合わなければどこでもかまいません。 この接続はリモートサーバ上のポート 6667 に転送されます。 これが IRC サービスの標準的なポート番号だからです。

-f オプションは ssh をバックグラウンド化させるために利用し、 リモートコマンド “sleep 10” はトンネリングするサービスが開始されるまでに 一定の時間 (この例では 10 秒) を与えています。 もしここで指定された時間内に接続が行われない場合、 ssh は終了するでしょう。

X11 転送
ForwardX11 項目が “yes” に設定されており (または上記の -X および -x オプションを参照してください)、 ユーザが X11 を使っている (環境変数 DISPLAY が設定されている) 場合、X11 ディスプレイへの接続は 自動的にリモート側に転送されます。つまり、 シェル (あるいはコマンド) から起動された X11 プログラムはみな 暗号化された通信路を通り、本来の X サーバへの接続は ローカルマシン上からなされるようになります。 ユーザは DISPLAY を手動で設定すべきではありません。 X11 接続の転送はコマンドラインあるいは 設定ファイルによって設定できます。

ssh によって設定された DISPLAY の値はサーバマシン上を指すようになっていますが、 ディスプレイ番号は 0 より大きい値になっているでしょう。 これは正常な状態です。 ssh は暗号化された通信路を介して接続を転送します。 そのため、サーバマシン上に X サーバの “プロキシ” をつくるのでこうなるのです。

また、 ssh はサーバマシン上で Xauthority 情報を自動的に用意します。 ssh はこのためにランダムな認証クッキーを生成し、サーバ側の Xauthority に格納し、接続が転送されるときは すべてこのクッキーを持たせるようにします。 そして接続が開かれるときに、これが本物のクッキーと置き換わる ようにするのです。本物の認証クッキーがサーバ側に 送られることは決してありません (し、暗号化されないままでクッキーが送られることもありません)。

ForwardAgent 設定項目が “yes” になっていて、ユーザが認証エージェントを使っている場合、 認証エージェントに対する接続は 自動的にリモート側に転送されます。 (以下で説明する -A and -a オプションも参照のこと)。

ホスト鍵の検証
あるサーバに最初に接続したとき、( StrictHostKeyChecking 設定項目で禁止されていない限り) ユーザにはそのサーバの公開鍵の指紋 (fingerprint) が 提示されます。指紋は ssh-keygen(1) コマンドによって得ることができます:

    $ ssh-keygen -l -f /etc/ssh/ssh_host_rsa_key

もしこの指紋がすでにわかっており、 それが正しいと検証できた場合には この公開鍵を追加することができます。 指紋がまだわかっていない場合、別の方法として、 SSH の指紋を DNS によって検証することができます。 追加の資源レコード (RR) である SSHFP を zone ファイルに 追加し、接続するクライアントが提示された公開鍵とその指紋を 照合することができます。

以下の例では、あるクライアントがサーバ “host.example.com” に接続するものとします。まず SSHFP 資源レコードを host.example.com の zone ファイルに 追加する必要があります:

    $ ssh-keygen -r host.example.com.

ここで出力された行を zone ファイルに追加します。 このゾーンが指紋の問い合わせに応答するかどうかは、 以下のようにしてチェックできます。

    $ dig -t SSHFP host.example.com

最後に、クライアントが以下のようにして接続します:

    $ ssh -o "VerifyHostKeyDNS ask" host.example.com
    [...]
    Matching host key fingerprint found in DNS.
    Are you sure you want to continue connecting (yes/no)?

詳しくは ssh_config(5) の VerifyHostKeyDNS 設定項目を参照してください。

SSHを使った仮想プライベートネットワーク (VPN)
ssh は、仮想ネットワークデバイスである tun(4) を使った、仮想プライベートネットワーク (VPN) の トンネリングをサポートしています。 これにより、異なる 2 つのネットワークを 安全に結合することができます。 sshd_config(5) ファイルにある PermitTunnel 設定項目は、 サーバがこの機能をサポートするかどうか、 およびサポートするレベル (レイヤ 2 あるいはレイヤ 3) を指定します。

以下の例では、SSH サーバがリモートのネットワークの ゲートウェイとして 192.168.1.15 で動いていると仮定した場合に クライアント側のネットワーク 10.0.50.0/24 と、 リモート側のネットワーク 10.0.99.0/24 とを、 10.1.1.1 から 10.1.1.2 への point-to-point 接続を使って結合します。 このときリモート側ネットワークのゲートウェイでは 192.168.1.15 で SSH サーバが走っており、この接続を許可しているものとします。

クライアント側:

    # ssh -f -w 0:1 192.168.1.15 true
    # ifconfig tun0 10.1.1.1 10.1.1.2 netmask 255.255.255.252
    # route add 10.0.99.0/24 10.1.1.2

サーバ側:

    # ifconfig tun1 10.1.1.2 10.1.1.1 netmask 255.255.255.252
    # route add 10.0.50.0/24 10.1.1.1

クライアントのアクセス権限はサーバ側の /root/.ssh/authorized_keys ファイル (下記参照)、およびサーバの PermitRootLogin 設定項目でより細かく制御できます。 以下のエントリは、 PermitRootLogin 項目が “forced-commands-only” に設定されている場合のもので、ユーザ jane に対しては tun(4) デバイス 1番 への接続を許可し、 ユーザ john に対しては tun デバイス 2 番 への接続を許可します:

    tunnel="1",command="sh /etc/netstart tun1" ssh-rsa ... jane
    tunnel="2",command="sh /etc/netstart tun2" ssh-rsa ... john

SSH 経由の VPN は大きなオーバーヘッドをともなうため、 これはワイヤレス VPN などの、 一時的な設定にのみ使うのが望ましいでしょう。 より長期的な VPN 接続は、 ipsecctl(8) や isakmpd(8) といったツールを使うほうが優れています。

環境変数
ssh はふつう以下の環境変数を設定します:

DISPLAY
    環境変数 DISPLAY は X11 サーバの場所を示しています。これは ssh によって、 “hostname:n” という形の値が自動的に設定されます。 ここで “hostname” の部分はシェルが走っているホストを表しており、 ‘n’ は n 1 の整数です。 ssh は X11 接続を安全な通信路で転送するために、この特別な値を使います。 X11 の接続が安全でなくなってしまうため、ユーザは環境変数 DISPLAY を自分で設定すべきではありません (また、それをやってしまうとユーザは認証に必要なクッキーを手で コピーしなければならなくなります)。

HOME
    ユーザのホームディレクトリのパス名が設定されます。

LOGNAME
    環境変数 USER と同じです。 これは、この変数を使うシステムで互換性を保つために設定されます。

MAIL
    ユーザのメールボックスのパス名が設定されます。

PATH
    デフォルトの PATH です。これは ssh のコンパイル時に指定されます。

SSH_ASKPASS
    パスフレーズを入力する際、 ssh が端末から起動されていると ssh はパスフレーズをその端末から要求します。 ssh が制御できる端末を持っておらず、環境変数 DISPLAY および SSH_ASKPASS が設定されている場合、 ssh は SSH_ASKPASS によって指定されるプログラムを起動し、X11 ウインドウを使って パスフレーズを要求します。 これは ssh を .xsession やそれに類するスクリプトから呼び出す際にとくに役に立ちます。 (マシンによっては、これがうまく動くためには 標準入力を /dev/null にリダイレクトする必要があるかもしれません)

SSH_AUTH_SOCK
    認証エージェントと通信するのに使われる UNIX ドメインソケットの パスを表しています。

SSH_CONNECTION
    接続の両端にあるクライアントとサーバの識別子です。 この変数にはスペースで区切られた 4 つの値が入っています: クライアントの IP アドレス、クライアントのポート、 サーバの IP アドレス および サーバのポートです。

SSH_ORIGINAL_COMMAND
    強制コマンドが実行されると、この変数には、 元々指定されていたコマンドラインの値が入ります。 ここから本来の引数を取り出すことができます。

SSH_TTY
    現在のシェルあるいはコマンドに割り当てられている tty の名前 (端末装置へのパス) に設定されます。現在のセッションが端末を 持たない場合、この変数は設定されません。

TZ  デーモンが起動したとき、現在の時間帯を表すタイムゾーン変数が 設定されていると、それがここに入ります (つまりデーモンは その値を新規の接続に渡します)。

USER
    ログインしているユーザ名に設定されます。

これらに加えて、 ssh は ~/.ssh/environment ファイルが存在してユーザがその変更を許可されていればそれを読み込み、 “VARNAME=value” という形式の行を環境変数に追加します。 より詳しい情報については、 sshd_config(5) の PermitUserEnvironment 設定項目を参照してください。

関連ファイル
~/.rhosts
    このファイルはホストベースド認証 (host-based authentication、上記参照) で使われます。 ユーザのホームディレクトリが NFS パーティション上にあるような マシンでは、このファイルは誰にでも読み込み 可能でなければなりません。なぜなら sshd(8) はこれを root として読むからです。 また、このファイルはそのユーザの所有でなければならず、 他の人が書き込み可能であってはいけません。 ほとんどのマシンにおける推奨されるパーミッションは、 所有者は読み書き可能であるが、 他の人はアクセス不可能というものです。

~/.shosts
    このファイルは .rhosts とまったく同じように扱われます。 このファイルを使うと、rlogin や rsh では ログインできないようにしつつ、 ホストベースド認証を許可することができます。

~/.ssh/authorized_keys
    このユーザのログインに使われる公開鍵 (RSA/DSA) の一覧です。 この形式は sshd(8) のマニュアルで説明されています。 これは特に見られてまずいというものではないのですが、 できれば所有者からは読み/書きが可能で、 他人からはアクセス不可能なパーミッションに 設定しておくのがよいでしょう。

~/.ssh/config
    ユーザごとの個人用設定ファイルです。 このファイルの形式と設定項目は ssh_config(5) で説明されています。 このファイルは潜在的に悪用される危険性があるため、 パーミッションは厳しくしておくのがいいでしょう。 所有者のみが読み書き可能で、 他からはアクセスできないようにしておくべきです。

~/.ssh/environment
    環境変数の追加定義を格納します。上の 環境変数 の節を見てください。

~/.ssh/identity
~/.ssh/id_dsa
~/.ssh/id_rsa
    認証のための秘密鍵が格納されています。 これらのファイルには他人に見られてはいけないデータが 入っているため、そのユーザには読めても、 他人からはアクセスできないようにしてください (読み込み/書き込み/実行属性ともに)。 ssh は、他人にアクセスできるようになっている 秘密鍵ファイルは無視するので注意してください。 鍵を作成するときにパスフレーズを指定することも可能です。この パスフレーズはファイル中の見られるべきでない部分を、 3DES を使って暗号化するのに用いられます。

~/.ssh/identity.pub
~/.ssh/id_dsa.pub
~/.ssh/id_rsa.pub
    認証のための公開鍵が格納されています。 これらのファイルは見られてもよいため、他人が読めるように しておいてもかまいません (が、別にそうする必要はありません)。

~/.ssh/known_hosts
    にはユーザがこれまでにログインしたホスト鍵のうち、 システム全体の known_hosts 一覧にないものが格納されます。 このファイルの形式に関する詳しい情報は sshd(8) を参照してください。

~/.ssh/rc
    このファイルのコマンドは、ユーザがログインしてシェル (あるいはコマンド) が開始する直前に ssh によって実行されます。 より詳しい情報については sshd(8) のマニュアルを見てください。

/etc/hosts.equiv
    このファイルはホストベースド認証 (host-based authentication、上記参照) で使われます。 このファイルは root だけが書き込めるようにしておくべきです。

/etc/shosts.equiv
    このファイルは /etc/hosts.equiv とまったく同じように扱われます。 このファイルを使うと、rlogin や rsh では ログインできないようにしつつ、 ホストベースド認証を許可することができます。

/etc/ssh/ssh_config
    システム全体にわたる設定ファイルです。 このファイルの形式と設定項目は ssh_config(5) で説明されています。

/etc/ssh/ssh_host_key
/etc/ssh/ssh_host_dsa_key
/etc/ssh/ssh_host_rsa_key
    これら 3 つのファイルにはホスト秘密鍵が格納されています。 これらは、ホストベースの認証に使われます。 プロトコル バージョン 1 を使う場合、 ホスト鍵は root にしか読めないので ssh を setuid root しておく必要があります。 プロトコル バージョン 2 の場合、 ssh はホスト鍵のアクセスに ssh-keysign(8) を使用します。 これにより、ホストベースの認証方法を使うときも ssh を setuid root しておく必要がなくなります。 デフォルトでは ssh は setuid root されていません。

/etc/ssh/ssh_known_hosts
    システム全体の known_hosts ファイルです。 このファイルはシステム管理者によって用意され、 その組織内で使われるすべてのマシン用の公開ホスト鍵を 格納するようになっているべきです。 このファイルは誰でも読めるようになっている必要があります。 このファイルの詳しい形式は sshd(8) のマニュアルで説明されています。

/etc/ssh/sshrc
    このファイル中のコマンドは、ユーザがログインしたあと、 そのユーザのシェル (あるいはコマンド) が開始する直前に ssh によって実行されます。 より詳しい情報については sshd(8) のマニュアルを見てください。

関連項目
scp(1), sftp(1), ssh-add(1), ssh-agent(1), ssh-keygen(1), ssh-keyscan(1), tun(4), hosts.equiv(5), ssh_config(5), ssh-keysign(8,) sshd(8) RFC 4250, The Secure Shell (SSH) Protocol Assigned Numbers, 2006. RFC 4251, The Secure Shell (SSH) Protocol Architecture, 2006. RFC 4252, The Secure Shell (SSH) Authentication Protocol, 2006. RFC 4253, The Secure Shell (SSH) Transport Layer Protocol, 2006. RFC 4254, The Secure Shell (SSH) Connection Protocol, 2006. RFC 4255, Using DNS to Securely Publish Secure Shell (SSH) Key Fingerprints, 2006. RFC 4256, Generic Message Exchange Authentication for the Secure Shell Protocol (SSH), 2006. RFC 4335, The Secure Shell (SSH) Session Channel Break Extension, 2006. RFC 4344, The Secure Shell (SSH) Transport Layer Encryption Modes, 2006. RFC 4345, Improved Arcfour Modes for the Secure Shell (SSH) Transport Layer Protocol, 2006. RFC 4419, Diffie-Hellman Group Exchange for the Secure Shell (SSH) Transport Layer Protocol, 2006.

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