暗号化されたJSONの設定プロパティ

暗号化されたJSON認証の詳細設定プロパティ

ここに記載したプロパティは、暗号化されたJSON認証を使用している場合にのみ適用されます。暗号化されたJSON認証への対応は、kcm-guacamole-auth-json パッケージを使用してインストールします。keeper/guacamoleのDockerイメージを使用する場合、暗号化されたJSON認証への対応は、環境変数を使用して設定します。

JSON共有秘密鍵

共有秘密鍵は、JSONデータを生成するシステムによるJSONの暗号化と署名、およびGuacamoleサーバーによる受信データの検証と復号化に使用されます。この鍵は128ビットで、32桁の16進数で指定する必要があります。

プロパティ名	説明
json-secret-key	認証のためにGuacamoleに送信されるJSONの暗号化と署名に使用される128ビットの秘密鍵 (32桁の16進数形式)。受信したJSONは、この鍵を使用して暗号化および署名されていない限り受け入れられません

この鍵は、予測不能である限り、基本的に何でも指定できます。このような鍵を生成する簡単な方法は、パスフレーズを echo し、md5sum ユーティリティに渡すことです。これは、OpenSSL自体がパスフレーズから128ビット鍵を生成する際に用いている手法です。以下は、その例です。

$ echo -n "ThisIsATest" | md5sum
4c0b569e4c96df157eee1b65dd0e4d41 -
$

送信元ネットワークの制限

デフォルトでは、受信した暗号化されたJSONは、有効で、秘密鍵による正しい署名がある限り受け入れられます。さらに、信頼できるIPアドレスやCIDRサブネットのコンマ区切りリストに一致するマシンからのみ、暗号化されたJSONを受け入れるよう制限することもできます。

プロパティ名	説明
json-trusted-networks	暗号化されたJSONを使用した認証を許可するIPアドレスやCIDRサブネットのコンマ区切りリスト。デフォルトでは、暗号化されたJSONはどのアドレスやサブネットからでも制限なく受け入れられます