必須:VNCサーバーの待ち受けTCPポート。
この値は通常、5900または5900+ディスプレイ番号です。たとえば、VNCサーバーがディスプレイ番号1 (「:1」と表記される場合もある) にサービスを提供している場合、ポート番号は5901になります。
| ### 認証パラメータ VNC標準ではパスワードベースの認証のみが定義されており、その他の認証メカニズムは非標準または独自のものです。Keeper Connection Managerは現在、パスワード方式のみをサポートしています。
VNCのクリップボードで想定されるエンコーディング。デフォルトでは、標準エンコーディングのISO 8859-1が使用されます。このパラメータを使用するのは、VNCサーバーが非標準の別のエンコーディングを想定していることが確実な場合のみにしてください。
設定できる値は以下のとおりです。
ISO8859-1」- VNC標準で必須のクリップボードのエンコード。UTF-8"UTF-16"CP1252」- コードページ1252、ほとんどがISO 8859-1のスーパーセットであるWindows固有のラテン文字用エンコード。
作成されたすべての記録に使用するファイル名。省略した場合、各記録のファイル名は単に「recording」となります。
Guacamoleは既存の記録を上書きしません。必要に応じて、「.1」、「.2」、「.3」などの数字のサフィックスをファイル名に付加して、既存の記録が上書きされないようにします。数字のサフィックスを付加しても区別できない場合は、セッションは記録されず、エラーがログに記録されます。
このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。
| | 画像/ストリームを除外: | `recording-exclude-output` |「true」に設定すると、通常サーバーからクライアントにストリーミングされる画像出力やその他のデータが記録から除外され、ユーザー入力イベントのみを含む記録が生成されます。デフォルトでは、画像出力は記録に含まれます。
このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。
| | マウスを除外: | `recording-exclude-mouse` |「true」に設定すると、ユーザーのマウスイベントが記録から除外され、マウスカーソルが表示されない記録が作成されます。デフォルトでは、マウスイベントは記録に含まれます。
このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。
| | キーイベントを記録: | `recording-include-keys` |「true」に設定すると、ユーザーキーイベントが記録に含まれます。その後、記録をguaclog ユーティリティに渡して、セッション中に押されたキーを人間が判読できるように変換できます。デフォルトでは、プライバシー保護のため、キーイベントは記録に含まれ「ません」。
このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。
| | 記録のパスを自動作成: | `create-recording-path` |「true」に設定すると、指定した記録のパスの末尾のディレクトリがまだ存在しない場合、自動的に作成されます。デフォルトでは、記録のパスの一部が自動的に作成されることはなく、存在しないディレクトリを使用しようとすると、セッションは記録されず、エラーがログに記録されます。
自動的に作成されるのは、パス内の末尾のディレクトリのみです。パスの末尾以外の先頭の方のディレクトリが存在しない場合、セッションは記録されず、エラーがログに記録されます。
このパラメータは、画像の記録が有効になっている場合にのみ機能し、記録のパスを指定することで制御できます。記録のパスが指定されていない場合、セッションの画像による記録は有効にならず、このパラメータは無視されます。
| ### SFTPパラメータ（ファイル転送） VNCは通常、ファイル転送をサポートしていませんが、リモートデスクトップが通常ならSSHではなくVNC経由でアクセスされている場合でも、Guacamoleではファイル転送にSFTPを使用できます。
接続先のPulseAudioサーバーの名前。これは、ご利用の接続にPulseAudio経由でオーディオを送信するコンピュータのホスト名またはアドレスで、ほとんどの場合、VNCサーバーのホスト名/アドレスと同じです。
このパラメータを省略すると、デフォルトのPulseAudioデバイスが使用されます。これは、guacdと同じマシンで実行されているPulseAudioサーバーになります。
| #### TCP接続を受け入れるPulseAudioを設定 PulseAudioがネットワーク接続を受け入れるには、TCPモジュールがロードされている必要があります。TCPモジュールは通常、デフォルトではロードされず、PulseAudio設定ファイル（通常、`/etc/pulse/default.pa`）内に行を追加し、手動でロードする必要があります。モジュールに指定したオプションによって、許可される接続元を正確に指定し、一定のセキュリティを確保します。たとえば、サブネット`10.0.0.0/8`からの接続のみを許可する設定は、以下のとおりです。 ``` load-module module-native-protocol-tcp auth-ip-acl=10.0.0.0/8 auth-anonymous=1 ``` また、全面的にどこからの接続でも許可することもできますが、ネットワークの特質上、不正アクセスが起きない場合にのみ許可する必要があることにご注意ください。 ``` load-module module-native-protocol-tcp auth-anonymous=1 ``` PulseAudioの設定ファイルを正しく変更したら、PulseAudioサービスを再起動します。すると、PulseAudioはポート4713（PulseAudioのデフォルトポート）でTCP接続の着信の待ち受けを開始します。これは`netstat`などのユーティリティを使用して確認できます。 ``` $ netstat -ln | grep 4713 tcp 0 0 0.0.0.0:4713 0.0.0.0:* LISTEN tcp6 0 0 :::4713 :::* LISTEN $ ``` {% hint style="danger" %} いずれにせよ、**`auth-anonymous=1`パラメータは必須です**。Guacamoleは現在、PulseAudioが非匿名接続に使用するクッキーベースの認証をサポートしていません。このパラメータを省略すると、GuacamoleはPulseAudioに接続できなくなります。 {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.keeper.io/jp/keeper-connection-manager/supported-protocols/vnc.md?ask=