Telnet

ユーザー提供のKSM設定を許可:

ksm-user-config-enabled

「true」に設定すると、Keeper Connection Managerの各ユーザープロファイルを任意の接続のKeeper Secrets Manager設定に割り当てることができます。詳細は、複数ボルトの連携画面をご参照ください。

ホスト名:

hostname

必須: Guacamoleが接続するtelnetサーバーのホスト名またはIPアドレス。

ポート:

port

telnetサーバーの待ち受けポート。デフォルトでは、telnetの標準ポート23が使用されます。

ユーザー名:

username

認証に使用するユーザー名 (必要に応じて)。指定しない場合、またはtelnetサーバーでサポートされていない場合は、telnetサーバーのログインプロセスでクレデンシャルの入力を求められます。これが機能するためには、telnetサーバーが「NEW-ENVIRON」オプションをサポートする (およびUSER環境変数を監視する) か、または正規表現と照合できるプロンプトを提供する必要があります。ほとんどのtelnetサーバーはこの基準を満たしています。

パスワード:

password

認証を試行するときに使用するパスワード (必要に応じて)。指定すると、パスワードプロンプトが検出されたときに、ユーザーの代わりにパスワードを入力します。

ユーザー名の正規表現:

username-regex

「NEW-ENVIRON」を使用してユーザー名を指定できない場合に、ユーザー名プロンプトを検出するために使用する正規表現。指定しない場合、Guacamoleに組み込まれている適切なデフォルトが使用されます。指定する正規表現は、標準POSIX ERE方言 (egrepで使用される方言) で記述する必要があります。

パスワードの正規表現:

password-regex

パスワードプロンプトを検出するために使用する正規表現。指定しない場合、Guacamoleに組み込まれている適切なデフォルトが使用されます。指定する正規表現は、標準POSIX ERE方言 (egrepで使用される方言) で記述する必要があります。

ログイン成功の正規表現:

login-success-regex

ログインの試行が成功したことを検出する場合に使用する正規表現。指定した場合、この正規表現に一致するテキストがtelnetサーバーから受信されるまで、端末のディスプレイはユーザーに表示されません。指定する正規表現は、標準POSIX ERE方言 (egrepで使用される方言) で記述する必要があります。

ログイン失敗の正規表現:

login-failure-regex

ログインの試行が失敗したことを検出する場合に使用する正規表現。指定した場合、この正規表現に一致するテキストをtelnetサーバーから受信すると、接続はログイン失敗エラーを明示して閉じられます。指定する正規表現は、標準POSIX ERE方言 (egrepで使用される方言) で記述する必要があります。

カラースキーム:

color-scheme

telnet接続で使用されるターミナルエミュレータに使用するカラースキーム。各カラースキームによって、端末のデフォルトの前景色と背景色が決まります。テキストを表示するときに色を指定するプログラムは、これらの既定値を上書きします。適正値は以下のとおりです。

• 「black-white」- 白地に黒色のテキスト

• [gray-black」- 黒地に灰色のテキスト (デフォルト)

• 「green-black」- 黒地に緑色のテキスト

• 「white-black」- 黒地に白色のテキスト

• カスタムカラースキーム (後述)

デフォルトでは、Guacamoleは黒地に灰色でテキストをレンダリングします。

フォント名:

font-name

使用するフォントの名前。指定しない場合は、デフォルトの「monospace」が代わりに使用されます。これは、guacdを実行しているサーバーにインストールされているフォントの名前であることが必要で、等幅フォントでなければなりません。等幅フォント以外を使用すると、個々のグリフが正しく表示されないことがあります。

フォントサイズ:

font-size

使用するフォントのサイズ (ポイント単位)。既定では、レンダリングされるテキストのサイズは12ポイントになります。

最大スクロールバックサイズ:

scrollback

ターミナルスクロールバックバッファ内で許容される最大行数。デフォルトでは、スクロールバックバッファは最大1000行に制限されます。

読み取り専用:

read-only

この接続を読み取り専用にするか否か。「true」に設定すると、接続で入力が一切できなくなります。ユーザーは端末 (または端末内で実行されているアプリケーション) を表示することはできますが、操作はできません。

端末からのコピーを無効化:

disable-copy

「true」に設定すると、telnetセッション内でコピーされたテキストは、Guacamoleセッションのブラウザ側ではユーザーからアクセスできなくなり、リモートデスクトップ内でのみ使用できるようになります。デフォルトでは、ユーザーはコピーしたテキストにアクセスできます。

クライアントからの貼り付けを無効化:

disable-paste

「true」に設定すると、Guacamoleセッションのブラウザ側でコピーされたテキストは、telnetセッション内でアクセスできなくなります。デフォルトでは、ユーザーはtelnetセッション内でブラウザ以外からデータを貼り付けることができます。

Backspaceキー送信:

backspace

バックスペースが押されたときに送信される端末制御コードの整数値。ほとんどの場合、これを調整する必要はないはずです。ただし、バックスペースキーを押したときに、テキストが消去されるのではなく制御文字 (通常、^?または^H) が表示される場合は、このパラメータの調整が必要と考えられます。デフォルトでは、制御コード127 (削除) が送信されます。

端末タイプ:

terminal-type

telnetサーバーに渡す端末タイプの文字列。この値は通常、telnetセッション内でTERM環境変数として開示され、アプリケーションが送信する制御文字に影響します。デフォルトでは、端末タイプ文字列「linux」が使用されます。

タイプスクリプトのパス:

typescript-path

タイプスクリプトファイルを作成するディレクトリ。タイプスクリプトを記録する必要がある場合は、このパラメータが必要です。このパラメータを指定すると、タイプスクリプトの記録が有効になります。このパラメータを省略すると、タイプスクリプトは記録されません。

タイプスクリプト名:

typescript-name

作成されたすべての記録に使用する基本ファイル名。省略すると、基本ファイル名「typescript」が使用されます。

Guacamoleは既存のタイプスクリプトを上書きしません。必要に応じて、「.1」、「.2」、「.3」などの数字のサフィックスを基本ファイル名に付加して、既存の記録が上書きされないようにします。数字のサフィックスを付加しても区別できない場合は、タイプスクリプトは記録されず、エラーがログに記録されます。

このパラメータは、タイプスクリプトの記録が有効になっている場合にのみ機能し、タイプスクリプトのパスを指定することで制御できます。タイプスクリプトのパスが指定されていない場合、タイプスクリプトの記録は有効にならず、このパラメータは無視されます。

タイプスクリプトのパスを自動作成:

create-typescript-path

「true」に設定すると、指定したタイプスクリプトのパスの末尾のディレクトリがまだ存在しない場合、自動的に作成されます。デフォルトでは、タイプスクリプトのパスの一部が自動的に作成されることはなく、存在しないディレクトリを使用しようとすると、タイプスクリプトは記録されず、エラーがログに記録されます。

自動的に作成されるのは、パス内の末尾のディレクトリのみです。パスの末尾以外の先頭の方のディレクトリが存在しない場合、タイプスクリプトは記録されず、エラーがログに記録されます。

このパラメータは、タイプスクリプトの記録が有効になっている場合にのみ機能し、タイプスクリプトのパスを指定することで制御できます。タイプスクリプトのパスが指定されていない場合、タイプスクリプトの記録は有効にならず、このパラメータは無視されます。

記録のパス:

recording-path

画面記録ファイルを作成するディレクトリ。画像記録の作成が必要な場合は、このパラメータが必要です。このパラメータを指定すると、画像による画面記録が有効になります。このパラメータを省略した場合、画像記録は作成されません。

記録名:

recording-name

作成されたすべての記録に使用するファイル名。省略した場合、各記録のファイル名は単に「recording」となります。

Guacamoleは既存の記録を上書きしません。必要に応じて、「.1」、「.2」、「.3」などの数字のサフィックスをファイル名に付加して、既存の記録が上書きされないようにします。数字のサフィックスを付加しても区別できない場合は、セッションは記録されず、エラーがログに記録されます。

このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。

画像/ストリームを除外:

recording-exclude-output

「true」に設定すると、通常サーバーからクライアントにストリーミングされる画像出力やその他のデータが記録から除外され、ユーザー入力イベントのみを含む記録が生成されます。デフォルトでは、画像出力は記録に含まれます。

このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。

マウスを除外:

recording-exclude-mouse

「true」に設定すると、ユーザーのマウスイベントが記録から除外され、マウスカーソルが表示されない記録が作成されます。デフォルトでは、マウスイベントは記録に含まれます。

このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。

キーイベントを記録:

recording-include-keys

「true」に設定すると、ユーザーキーイベントが記録に含まれます。その後、記録をguaclog ユーティリティに渡して、セッション中に押されたキーを人間が判読できるように変換できます。デフォルトでは、プライバシー保護のため、キーイベントは記録に含まれ「ません」。

このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。

記録のパスを自動作成:

create-recording-path

「true」に設定すると、指定した記録のパスの末尾のディレクトリがまだ存在しない場合、自動的に作成されます。デフォルトでは、記録のパスの一部が自動的に作成されることはなく、存在しないディレクトリを使用しようとすると、セッションは記録されず、エラーがログに記録されます。

自動的に作成されるのは、パス内の末尾のディレクトリのみです。パスの末尾以外の先頭の方のディレクトリが存在しない場合、セッションは記録されず、エラーがログに記録されます。

このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。