html/setup/teraterm-ssh.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">
<HTML>
<HEAD>
<meta http-equiv="Content-Type" content="text/html; charset=Shift_JIS">
<TITLE>TTSSH (Tera Term 設定ファイル)</TITLE>
<META http-equiv="Content-Style-Type" content="text/css">
<link rel="stylesheet" href="../style.css" type="text/css">
</HEAD>
<BODY>

<h1><a name="AuthBanner">認証バナーの表示方法</a></h1>

<p>
SSH 認証時、サーバから SSH_MSG_USERAUTH_BANNER メッセージが送られて来る事があります。<br />
標準ではこのメッセージの内容を VT ウィンドウで表示します。表示方法を変更する場合は設定ファイルの [TTSSH] セクションの AuthBanner 行を、以下のように変更して下さい。
</p>

<pre>
AuthBanner=&lt;表示方法&gt;
</pre>

<p>
表示方法には 0 〜 3 が指定できます。それぞれの値の意味は以下のとおりです。
</p>

<table>
<thead>
  <tr> <th>値</th> <th>動作</th> </tr>
</thead>
<tbody>
  <tr> <td>0</td>  <td>表示しない</td> </tr>
  <tr> <td>1</td>  <td>VT ウィンドウ内に表示する</td> </tr>
  <tr> <td>2</td>  <td>ポップアップで表示する</td> </tr>
  <tr> <td>3</td>  <td>バルーンチップで表示する</td> </tr>
</tbody>
</table>

<pre>
省略時:
AuthBanner=1
</pre>


<h1><a name="DisablePopupMessage">メッセージボックスの抑止</a></h1>

<p>
マクロや非ログオン状態での自動実行時にエラーや警告となる状態が発生した場合、メッセージボックスが表示されユーザの操作待ちになると次の手順に進まなくなります。<br />
このような場合のため、エラーや警告があった場合にメッセージボックスを表示させないようにできます。
</p>

<pre>
DisablePopupMessage=&lt;表示方法&gt;
</pre>

<p>
表示方法には 0 か 1 が指定できます。それぞれの値の意味は以下のとおりです。
</p>

<table>
<thead>
  <tr> <th>値</th> <th>動作</th> </tr>
</thead>
<tbody>
  <tr> <td>0</td>  <td>ポップアップを抑止しない</td> </tr>
  <tr> <td>1</td>  <td>ポップアップを抑止する</td> </tr>
</tbody>
</table>

<pre>
省略時:
DisablePopupMessage=0
</pre>


<!--h1><a name="EnableRsaShortKeyServer">768bit 未満の RSA サーバホスト鍵を持つサーバへの接続を許す</a></h1>

<p>
SSH サーバホスト鍵は RSA の場合に最低 768bit の長さを必要とするが、768bit 未満のサーバホスト鍵を持つ機器も存在する。<br />
通常 TTSSH はサーバホストの鍵が短すぎる場合に接続を切るが、この設定をすることで例外的に接続を許すことができる。
</p>

<pre>
EnableRsaShortKeyServer=&lt;設定値&gt;
</pre>

<p>
設定値には 0 か 1 が指定できます。それぞれの値の意味は以下のとおりです。
</p>

<table>
<thead>
  <tr> <th>値</th> <th>動作</th> </tr>
</thead>
<tbody>
  <tr> <td>0</td>  <td>接続を許さない</td> </tr>
  <tr> <td>1</td>  <td>接続を許す</td> </tr>
</tbody>
</table>

<pre>
省略時:
EnableRsaShortKeyServer=0
</pre-->


<h1><a name="GexMinimalGroupSize">Diffie-Hellman 群交換方式鍵交換での群の最小サイズ</a></h1>

<p>
SSH の鍵交換方式として "Diffie-Hellman 群交換" (diffie-hellman-group-exchange-sha*) を使用する場合、SSH クライアントは鍵交換に使用する群の「最小サイズ」「提案サイズ」「最大サイズ」の要求をサーバに送信します。<br />
後述のように現在の TTSSH は標準で 2048 を最小サイズとして送ります。サーバから送られて来た群のサイズがこの最小値より小さい場合、TTSSH は接続を続行していいか確認するダイアログを表示します。
</p>

<p>
設定ファイルの [TTSSH] セクションの GexMinimalGroupSize 行を以下のように変更することによって、サーバに要求する群の最小サイズを変更できます。
</p>

<pre>
GexMinimalGroupSize=&lt;群の最小サイズ&gt;
</pre>

<p>
群の最小サイズには 0 および 1024 〜 8192 が指定できます。<br />
0 を指定した時は TTSSH が最適と判断した値を使います。現在のバージョンの TTSSH では <a href="https://tools.ietf.org/html/rfc8270">RFC 8270</a> に従い 2048 が送られます。将来のバージョンではこの値が変更される可能性があります。<br />
1024 〜 8192 の間の値を指定した場合はその値が使われます。
</p>

<pre>
省略時:
GexMinimalGroupSize=0
</pre>


<h1><a name="LogLevel">ログレベル</a></h1>

<p>
TTSSH が TTSSH.LOG に記録するログのレベルを設定します。
</p>

<pre>
LogLevel=&lt;設定値&gt;
</pre>

<table>
<thead>
  <tr> <th>値</th> <th>動作</th> </tr>
</thead>
<tbody>
  <tr> <td>0</td>  <td>無効</td> </tr>
  <tr> <td>5</td>  <td>FATAL</td> </tr>
  <tr> <td>10</td> <td>ERROR</td> </tr>
  <tr> <td>30</td> <td>WARNING</td> </tr>
  <tr> <td>50</td> <td>NOTICE</td> </tr>
  <tr> <td>80</td> <td>INFO</td> </tr>
  <tr> <td>100</td><td>VERBOSE</td> </tr>
  <tr> <td>200</td><td>SSHDUMP</td> </tr>
</tbody>
</table>

<pre>
省略時:
LogLevel=0
</pre>


<h1><a name="X11Display">X11転送での転送先ディスプレイ指定</a></h1>

<p>
X11 転送での転送先ディスプレイを指定するには、設定ファイルの [TTSSH] セクションの X11Display 行を以下のように変更して下さい。
</p>

<pre>
X11Display=&lt;ディスプレイ指定&gt;
</pre>

<p>
ディスプレイ指定には X11 の通常のディスプレイ指定形式([&lt;ホスト&gt;]:[&lt;ディスプレイ番号&gt;[.&lt;スクリーン番号&gt;]) が使えます。X11Display になにも指定しなかった(空文字列を指定した)場合、環境変数 DISPLAY が設定されていればその値が、設定されていなかった場合は localhost:0.0 が使われます。
</p>

<p>
この設定は <a href="../commandline/ttssh.html#ssh-x">/ssh-X コマンドラインオプション</a> で上書きされます。設定の優先順位は以下の順番となっています。
</p>

<ol>
  <li><a href="../commandline/ttssh.html#ssh-x">/ssh-X コマンドラインオプション</a></li>
  <li>設定ファイルの [TTSSH] セクションの X11Display 設定</li>
  <li>環境変数 DISPLAY の値</li>
  <li>localhost:0.0</li>
</ol>

<pre>
省略時:
X11Display=
</pre>


</BODY>
</HTML>