SSHD_CONFIG(5)

名前
sshd_config - OpenSSH SSH デーモン 設定ファイル

書式
/etc/ssh/sshd_config

説明
sshd は /etc/ssh/sshd_config (あるいはコマンドラインから -f オプションで指定したファイル) から設定を読み込みます。 このファイルの各行は “キーワード 引数” の形式になっており、空行あるいは ‘#’ で始まる行はコメントとみなされます。

使用できるキーワードとその説明は以下の通りです (キーワードでは大文字小文字は区別されませんが、引数では区別されることに 注意してください):

AllowGroups (許可するグループ)
    このキーワードにはいくつかのグループ名パターンをスペースで区切って 指定します。これが指定されると、ユーザの基本グループが そのパターンのどれかにマッチするグループであるようなユーザだけが ログインを許可されます。パターン中では ‘*’ および ‘’? がワイルドカードとして使えます。有効なのはグループの「名前」だけで、 数字で表されたグループ ID は認識されません。デフォルトでは、 ログインはすべてのグループに許可されています。

AllowTcpForwarding (TCP 転送の許可)
    TCP 転送を許可するかどうか指定します。デフォルトは “yes” です。TCP 転送を禁止しても、ユーザにシェルのアクセスを禁止しない かぎりセキュリティの向上にはならないことに注意してください。 なぜならユーザはいつでも自前の転送プログラムをインストールして 使うことができるからです。

AllowUsers (許可するユーザ)
    このキーワードにはいくつかのユーザ名パターンをスペースで区切って 指定します。これが指定されると、そのパターンのどれかにマッチする ユーザだけがログインを許可されます。パターン中では ‘*’ および ‘’? がワイルドカードとして使えます。有効なのはユーザの「名前」だけで、 数字で表されたユーザ ID は認識されません。デフォルトでは、 ログインはすべてのユーザに許可されています。 もしこのパターンが USER@HOST という形をとっている時は、 ユーザ名 USER と ホスト名 HOST を別々にチェックでき、 特定のホストからの特定のユーザのログインを制限することができます。

AuthorizedKeysFile (authorized_keys ファイル)
    ユーザ認証のさいに使われる公開鍵を格納しているファイル名を 指定します。 AuthorizedKeysFile のファイル名中に %T が含まれている場合、その部分は接続の間 別のものに置換されます。%% は「%」1文字に置換されます。 %h は認証しようとしているユーザのホームディレクトリに置換され、 %u はそのユーザのユーザ名に置換されます。この後、 その絶対パスあるいはユーザのホームディレクトリからの相対パスが AuthorizedKeysFile に渡されます。デフォルトでの値は “.ssh/authorized_keys” となっています。

Banner (バナー)
    司法管区によっては、法的な保護を受けるためには 認証の前に警告メッセージを送ったほうがよい場合があります。 ここで指定されたファイルの内容は、認証が許可される前に リモートユーザに提示されます。 このオプションは プロトコル バージョン 2 でのみサポートされています。 デフォルトでは、バナーは表示されません。

ChallengeResponseAuthentication (チャレンジ・レスポンス認証)
    チャレンジ・レスポンス認証を許可するかどうか指定します。 login.conf(5) に記されているすべての認証形式が使えます。 デフォルトは “yes” です。

Ciphers (SSH2の暗号化アルゴリズム)
    プロトコル バージョン 2 で許可される暗号化アルゴリズムを 指定します。複数のアルゴリズムを指定する場合は、 カンマで区切ってください。 デフォルトは

          ``aes128-cbc,3des-cbc,blowfish-cbc,cast128-cbc,arcfour,
            aes192-cbc,aes256-cbc,aes128-ctr,aes192-ctr,aes256-ctr''

    です。

ClientAliveInterval (クライアントの生存チェック間隔)
    sshd は一定時間ごとに、 暗号化された通信路を経由してクライアントに応答を要求するメッセージ (client alive message) を送ります。 その際、何もデータが送られてこなかったらタイムアウトする 時間を秒数で指定します。デフォルトの値は 0 で、 これはメッセージを送らないことを意味します。 このオプションは プロトコル バージョン 2 でのみサポートされています。

ClientAliveCountMax (クライアントの生存チェック最大カウント数)
    sshd が無反応のクライアントに対して client alive message (上記参照) を送ってみる最大数を指定します。 client alive message に対する応答が連続してこの回数だけなかった場合、 sshd は接続を切り、セッションを終了します。 client alive message は、 TCPKeepAlive (下記) とはまったく違うことに注意してください。 client alive message は暗号化された経路を介して送られるので、 偽造されることはありません。 TCPKeepAlive によって設定される TCP の keepalive オプションは 偽造される可能性があります。client alive のメカニズムは クライアントあるいはサーバが、いつ接続が切れたのかを 知りたいときに役立ちます。

    デフォルトの値は 3 です。もし ClientAliveInterval (上記) が 15 に設定され、 ClientAliveCountMax がデフォルトのままである場合、これに反応できない ssh クライアントは およそ 45秒後に接続が切られます。

Compression
    圧縮を許可するかどうかを指定します。 この引数がとりうる値は “yes” または “no” です。デフォルトでは “yes (圧縮を許可する)” になっています。

DenyGroups (拒否するグループ)
    このキーワードにはいくつかのグループ名パターンをスペースで区切って指定します。 ユーザの基本グループがこのパターンのどれかに マッチするユーザはログインを禁止されます。パターン中では ‘*’ および ‘’? がワイルドカードとして使えます。有効なのは グループの「名前」だけで、数字で表されたグループ ID は 認識されません。デフォルトでは、 ログインはすべてのグループに許可されています。

DenyUsers (拒否するユーザ)
    このキーワードにはいくつかのユーザ名パターンをスペースで区切って 指定します。これが指定されると、 このパターンのどれかにマッチするユーザはログインを禁止されます。 ‘*’ および ‘’? がワイルドカードとして使えます。 有効なのはグループの「名前」だけで、数字で表されたグループ ID は 認識されません。デフォルトでは、ログインはすべてのユーザに許可されています。 もしこのパターンが USER@HOST という形をとっている時は、 ユーザ名 USER と ホスト名 HOST を別々にチェックでき、 特定のホストからの特定のユーザのログインを制限することができます。

GatewayPorts (ポート中継の許可)
    リモートホストがクライアント側に転送されたポートに接続することを 許可するかどうか指定します。デフォルトでは、 sshd はリモート転送ポートをループバックアドレスに bind します。 これは他のリモートホストが、転送されたポートに接続してしまうのを 防いでいます。 GatewayPorts は sshd にリモート転送ポートをワイルドカードアドレスに bind させるときに使います。 これによってリモートホストが転送されたポートに接続できるようになります。 この引数の値は “yes” あるいは “no” です。デフォルトは “no” になっています。

GSSAPIAuthentication (GSSAPI 認証)
    GSSAPI ベースのユーザ認証を使用するかどうかを指定します。 これはデフォルトでは “no” になっています。 注意: このオプションはプロトコル バージョン 2 のみに適用されます。

GSSAPICleanupCredentials (GSSAPI 証明書の消去)
    ユーザがログアウトするときに、その証明書 (credential) キャッシュを 自動的に消去するかどうかを指定します。 デフォルトでは “yes” です。 注意: このオプションはプロトコル バージョン 2 のみに適用されます。

HostbasedAuthentication (ホストベース認証の許可)
    公開鍵ホスト認証が成功したときに、 rhosts あるいは /etc/hosts.equiv 認証を許可するかどうか 指定します (ホストベース認証)。 このオプションは RhostsRSAAuthentication (RhostsRSA 認証の許可) に似ており、プロトコル バージョン 2 のみに作用します。 デフォルトの値は “no” になっています。

HostKey (ホスト鍵)
    SSH で使われる、ホスト秘密鍵が格納されているファイルを指定します。 デフォルトでは、プロトコル バージョン 1 用の鍵が /etc/ssh/ssh_host_key であり、プロトコル バージョン 2 用の鍵が /etc/ssh/ssh_host_rsa_key および /etc/ssh/ssh_host_dsa_key です。 このファイルがグループあるいは他人からアクセス可能になっていると、 sshd はその使用を拒絶するので注意してください。 複数のホスト鍵を使うことも可能です。 “rsa1” 鍵はバージョン 1 に使われ、 “dsa” または “rsa” はバージョン 2 の SSH プロトコルに使われます。

IgnoreRhosts (rhosts の無視)
    RhostsRSAAuthentication または HostbasedAuthentication の各認証で、 .rhosts および .shosts ファイルを使わないようにします。

    この状態でも、 /etc/hosts.equiv および /etc/shosts.equiv は依然として有効です。デフォルトでは “yes” になっています。

IgnoreUserKnownHosts (ユーザ用 known_hosts の無視)
    RhostsRSAAuthentication または HostbasedAuthentication の各認証で、ユーザの $HOME/.ssh/known_hosts ファイルを使わないようにします。 デフォルトは “no” です。

KerberosAuthentication (Kerberos 認証)
    ユーザが PasswordAuthentication で入力したパスワードを Kerberos KDC 経由で批准するかどうか指定します。 このオプションを使うためには、サーバに KDC のアイデンティティを 批准するための Kerberos servtab が必要です。 デフォルトでは “no” になっています。

KerberosGetAFSToken (Kerberos で AFS トークンを取得する)
    AFS がアクティブで、そのユーザが Kerberos 5 TGT を持っている場合、 そのユーザのホームディレクトリにアクセスする前に AFS トークンを取得しようとします。 デフォルトは “no” です。

KerberosOrLocalPasswd (Kerberosあるいはローカルパスワード)
    これが指定されている場合、Kerberos 経由のパスワード認証が 失敗すると、そのパスワードは /etc/passwd などの別のローカルな機構によって確認されます。デフォルトは “yes” です。

KerberosTicketCleanup (Kerberos チケット自動除去)
    ユーザのチケット用キャッシュをログアウト時に自動的に消去するかどうか 指定します。デフォルトは “yes” です。

KeyRegenerationInterval (鍵の再生成間隔)
    プロトコル バージョン 1 では、サーバ鍵は (一度でも使われると) ここで 指定された間隔ごとに自動的に再生成されます。このように鍵を再生成する 目的は、あとでそのマシンに侵入して盗聴したセッションを解読されたり、 鍵を盗まれたりするのを防ぐためです。この鍵はどこにも格納されません。 値としてゼロを指定すると、鍵はまったく再生成されなくなります。 デフォルトでは 3600 (秒) になっています。

ListenAddress (接続受付アドレス)
    sshd が接続を受けつける (listen する) ローカルアドレスを指定します。 ここでは以下の形式が使えます:

    ListenAddress host|IPv4_addr|IPv6_addr
    ListenAddress host|IPv4_addr:port
    ListenAddress [ host|IPv6_addr]:port

    port が指定されていないときは、 sshd はそのアドレスで、それまでの Port オプションで指定されたすべてのポートで接続を受けつけます。 デフォルトではすべてのローカルアドレスに対して 接続を受けつけるようになっています。 ListenAddress 項目は複数指定してもかまいません。また Port オプションは、ポートつきでないアドレス指定に対しては このオプションよりも前に指定しておく必要があります。

LoginGraceTime (ログイン猶予時間)
    ユーザがここで指定された時間内にログインできないと、 サーバは接続を切ります。この値をゼロにすると、時間制限はなくなります。 デフォルトの値は 120 (秒) です。

LogLevel (ログレベル)
    sshd が出力するログメッセージの冗長性レベルを指定します。 とりうる値は次のとおりです: QUIET, FATAL, ERROR, INFO, VERBOSE, DEBUG, DEBUG1, DEBUG2 および DEBUG3。 デフォルトでは INFO です。DEBUG と DEBUG1 は等価です。 DEBUG2、DEBUG3 はそれぞれさらに冗長なログになります。 DEBUG レベル以上のログはユーザのプライバシーを侵害するので、 勧められるものではありません。

MACs (メッセージ認証コード)
    使用する MAC (メッセージ認証コード) アルゴリズムの優先順位を指定します。 MAC アルゴリズムはプロトコル バージョン 2 で使われる、 データの改竄を防ぐ機構 (data integrity protection) です。 複数のアルゴリズムをカンマで区切って指定します。 デフォルトは “hmac-md5,hmac-sha1,hmac-ripemd160,hmac-sha1-96,hmac-md5-96” の順になっています。

MaxStartups (最大起動数)
    認証されていない段階の接続を sshd デーモンが最大でどれだけ受けつけるかを指定します。 この値を超えた (認証されていない段階の) 接続は捨てられます。 この状態は (すでに接続したクライアントの) 認証が成功するか、その LoginGraceTime (ログイン猶予時間) が切れるまで続きます。 デフォルトではこの数は 10 です。

    もうひとつの方法は、早いうちからランダムに接続を拒否するよう 指定することです。これはこのオプションにコロンで区切った 3つの値を 与えることによりおこないます。この値は “start:rate:full” (``開始時:確率:最大数'') の形をとります (例: "10:30:60" など)。 sshd は認証されていない段階の接続が “start” (この例では 10) 個を超えると、これ以後の接続要求を “rate/100” (この例では 30%) の確率で拒否しはじめます。この確率は “full” (この例では 60) 個の接続が来るまで線形に増えつづけ、 最大数に達した時点でそれ以降すべての接続を拒否するようになります。

PasswordAuthentication (パスワード認証)
    パスワード認証を許可するかどうか指定します。デフォルトでは “yes” になっています。

PermitEmptyPasswords (空のパスワードを許可)
    パスワード認証が許可されているとき、パスワード文字列が空の アカウントに対してサーバがログインを許可するかどうか指定します。 デフォルトは “no” です。

PermitRootLogin (root ログイン許可)
    ssh(1) を使って、root がログインできるかどうか指定します。この引数の値は “yes” 、 “without-password” (パスワード認証なし)、 “forced-commands-only” (強制コマンドのみ)、あるいは “no” のいずれかです。 のいずれかになります。デフォルトは “yes” です。このオプションを “without-password” にすると、root だけパスワード認証ではログインできなくなります。 注意: これ以外の認証方法 (keyboard-interactive/PAM など) を使用している場合は、 まだパスワードを使った root ログインが可能である場合があります。

    このオプションを “forced-commands-only” にすると、root は公開鍵認証を使ってログインできますが、その鍵に command オプションが指定されている場合にかぎります (これは通常の root ログインを許可していなくても、 リモートバックアップをとりたいときなどに有用です)。 root に対してはこれ以外の認証方法はすべて禁止になります。

    このオプションを “no” にすると、root のログインは許可されません。

PermitUserEnvironment (ユーザの環境変数変更を許可する)
    sshd が ~/.ssh/environment ファイルおよび ~/.ssh/authorized_keys における environment= オプションを処理すべきかどうかを指定します。 デフォルトでは “no” です。 環境変数の変更は、ユーザに LD_PRELOAD などの設定を使った ある種のアクセス制限を回避させてしまう可能性があります。

PidFile (pid ファイル)
    sshd デーモンのプロセス ID を格納するファイルを指定します。 デフォルトでは /var/run/sshd.pid になっています。

Port (ポート番号)
    sshd が接続を受けつける (listen する) ポート番号を指定します。 デフォルトは 22 です。複数指定することも可能です。 ListenAddress の項も参照してください。

PrintLastLog (LastLog の表示)
    ユーザが対話的にログインしたとき、 そのユーザが前回ログインした日付と時刻を表示するかどうか指定します。 デフォルトでは “yes” になっています。

PrintMotd (motd の表示)
    ユーザが対話的にログインしたとき、 /etc/motd (今日のお知らせ) ファイルの内容を表示するかどうか指定します。 (システムによっては、これはシェルや /etc/profile に相当するものが表示します)。デフォルトは “yes” です。

Protocol (プロトコル)
    サポートするプロトコルのバージョンを指定します。 とりうる値は “1” と “2” です。複数のバージョンをカンマで区切って指定することもできます。 デフォルトは “2,1” です。 ここでのプロトコルの順番は、優先度を指定するものではないことに 注意してください。なぜなら複数のプロトコルがサーバで使用可能な場合、 選択するのはクライアント側だからです。よって “2,1” という指定は、 “1,2” と同じです。

PubkeyAuthentication (公開鍵認証)
    公開鍵認証を許可するかどうか指定します。 デフォルトは “yes” です。 このオプションは プロトコル バージョン 2 にのみ適用されることに 注意してください。

RhostsRSAAuthentication (rhosts-RSA 認証)
    RSA ホスト間認証が成功しているとき、rhosts や /etc/hosts.equiv を使った認証をおこなってよいかどうか指定します。デフォルトは “no” です。 このオプションはプロトコル バージョン 1 にのみ 適用されることに注意してください。

RSAAuthentication (RSA 認証)
    純粋な RSA 認証を許可するかどうかを指定します。デフォルトは “yes” になっています。このオプションはプロトコル バージョン 1 にのみ 適用されることに注意してください。

ServerKeyBits (サーバ鍵のビット数)
    プロトコル バージョン 1 で短期的に使われるサーバ鍵の ビット数を指定します。 最小値は 512 で、デフォルトは 768 です。

StrictModes (厳格なモード)
    sshd がログインを許可する前に、ユーザのファイルおよび ホームディレクトリの所有権とパーミッションをチェックすべきか どうかを指定します。これはふつう初心者が、しばしば自分の ディレクトリを誰でも書き込めるようにしてしまう事故を防ぐために 有効です。デフォルトでは “yes” になっています。

Subsystem (サブシステム)
    外部サブシステム (ファイル転送デーモンなど) を設定します。 このオプションへの引数にはサブシステム名と、そのサブシステムに 要求があったとき実行されるコマンドを与えます。 sftp-server(8) はファイル転送サブシステム “sftp” を実装したものです。デフォルトではサブシステムは 何も定義されていません。このオプションは プロトコル バージョン 2 にのみ適用されることに注意してください。

SyslogFacility (syslog 分類コード)
    sshd が出力するログメッセージで使われるログの分類コード (facility) を指定します。とりうる値は次のとおりです: DAEMON, USER, AUTH, LOCAL0, LOCAL1, LOCAL2, LOCAL3, LOCAL4, LOCAL5, LOCAL6, LOCAL7。デフォルトは AUTH です。

TCPKeepAlive (TCP接続を生かしておく)
    システムが相手のマシンに TCP keepalive メッセージを送るかどうか 指定します。これが送られると、接続の異常終了や相手マシンの クラッシュが正しく通知されるようになります。 しかしこれを使うと、たとえ経路が一時的にダウンしていても 接続が死んでいるということになってしまい、これが邪魔になる場合もあります。 その一方で、もし TCP keepalive が送られないとすると、セッションは サーバ上で永久に残ってしまことがあり、 “幽霊” ユーザを居座らせてサーバ資源を消費することがあります。

    デフォルトは “yes” (TCP keepalive メッセージを送る) です。そのため クライアントはネットワークがダウンするか、 リモートホストがクラッシュすると通知してきます。 これは永久に残るセッションを防ぎます。

    TCP Keepalive を禁止するには、この値を “no” にする必要があります。

UseDNS (リモートホスト名の確認)
    sshd が IP アドレスからリモートホスト名を逆引き検索して得た名前を 正引きして、同じ IP アドレスになるかどうか確認します。 デフォルトでは “yes” になっています。

UseLogin (login の使用)
    対話的ログインセッションのさい、 login(1) プログラムを使うかどうかを指定します。 デフォルトでは “no” になっています。 対話的でないリモートコマンド実行のときに login(1) が使われることは決してありません。また、これが許可されていると X11Forwarding (X11 転送) は許可されなくなるということに注意してください。 なぜなら、 login(1) は xauth(1) クッキーの扱いを知らないからです。

UsePAM (PAM の使用)
    (チャレンジ・レスポンスを経由した) PAM 認証とセッションの確立を 許可するかどうかを指定します。これを許可した場合にはおそらく PasswordAuthentication を禁止する必要があるでしょう。 を許可した sshd を root 以外の一般ユーザで走らせることはできません。 デフォルトは “no” です。 UsePrivilegeSeparation が指定されている場合は、認証のあとで禁止されます。

UsePrivilegeSeparation (root権限を分離)
    sshd が、受けつけるネットワークトラフィックを処理するために root 権限を分離するかどうかを指定します。 これは root 権限をもたない子プロセスをつくることによって おこなわれます。認証が成功すると、そのユーザの権限をもつ 別のプロセスが新たに作られます。これの目的は、まずそうな部分を root 権限をもたないプロセスのみに限定することによって、 root 権限による被害の拡大を防ぐためです。 デフォルトでは “yes (root権限を分離する)” になっています。

X11DisplayOffset (X11 ディスプレイ番号のオフセット値)
    sshd が X11 転送をするときに最初に使われるディスプレイ番号を指定します。 これは sshd が X11 転送で使うディスプレイ番号が、 本物の X サーバのディスプレイ番号と衝突してしまうのを防ぐためです。 デフォルトの値は 10 です。

X11Forwarding (X11 転送)
    X11 転送を許可するかどうかを指定します。 この引数の値は “yes” あるいは “no” で、デフォルトは “no” です。

    X11 転送が許可されており、転送された sshd のディスプレイが任意のアドレス (下の X11UseLocalhost 参照) からの接続を受けつけるように設定されていると、 サーバやクライアントのディスプレイは余計な危険に さらされることになります。なので、デフォルトではそうなっていません。 また、認証におけるなりすまし、認証データの確認や差し替えなどが クライアント側で起こります。X11 転送を使うセキュリティ上のリスクは、 ssh クライアントが転送を要求したときに、クライアント上の X11 サーバが 攻撃にさらされるかもしれないということです ( ssh_config(5) の ForwardX11 注意書きを参照)。 システム管理者はクライアントがうっかり X11 を転送して、 余計な危険性を増すことのないように、これをかならず “no” に設定させるような立場をとることもできます。

    注意: X11 転送機能を禁止しても、ユーザが X11 の通信を転送できなくなる というわけではありません。なぜならユーザはいつでも自前の転送プログラムを インストールして使うことができるからです。 UseLogin が許可されていると、X11 転送は自動的に禁止されます。

X11UseLocalhost (X11 で localhost のみを許可)
    sshd が転送された X11 サーバをループバックアドレス (localhost) に bind するかどうかを指定します。デフォルトでは、 sshd は転送された X11 をループバックアドレスに bind し、環境変数 DISPLAY のホスト名の部分を “localhost” に設定します。 こうすると、(訳注: SSHサーバ以外の) リモートホストから 転送された Xサーバに接続することはできなくなります。 しかし、ふるい X11 クライアントだと、 この設定では動作しないことがあります。 そのようなときは X11UseLocalhost を “no” に設定して、転送された X サーバがワイルドカードアドレスに bind されるようにできます。 このオプションの引数は “yes” あるいは “no” です。デフォルトでは、これは “yes (localhost にしか bind しない)” になっています。

XAuthLocation (xauth の位置)
    xauth(1) プログラムのフルパス名を指定します。デフォルトでは /usr/X11R6/bin/xauth になっています。

  時間の表現
sshd のコマンドライン引数や設定ファイルオプションで 時間を指定する場合、次の構文を並べた書式を使うことができます: time[qualifier]

ここで time は正の整数であり、 qualifier は次のうちのどれかです:

<なし>
    seconds (秒)
s | S
    seconds (秒)
m | M
    minutes (分)
h | H
    hours (時間)
d | D
    days (日)
w | W
    weeks (週)

これらの形式を組み合わせることもでき、 その場合は各形式の時間が合計されます。

時間表現の例:

600 600 秒 (10 分)
10m 10 分
1h30m
    1 時間 30 分 (90 分)

関連ファイル

/etc/ssh/sshd_config
    sshd の設定ファイルです。このファイルに書き込めるのは root だけでなくてはいけませんが、読むのは誰でもできるように しておいたほうがよいでしょう (必須ではありませんが)。

関連項目
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 の貢献によるものです。 Niels Provos および Markus Friedl が root特権分離のサポートに 貢献しました。

日本語訳
新山 祐介 (yusuke @ cs . nyu . edu) 2004/4/20 (for 3.8.1p1)