高度な機能

Keeperボルト連携の高度な機能

設定パラメータの保護

Keeperボルトを利用して、通常は guacamole.properties ファイルまたは Docker Composeファイルにハードコードされる設定シークレットを保護および保存できます。

Dockerの自動インストールメソッド

Docker自動インストールメソッドを使用してKeeperコネクションマネージャーをインストールした場合、設定シークレットは自動生成されたDocker Composeファイル内で保護されます。

root として、/etc/kcm-setup/docker-compose.yml ファイルを編集します。

保護したい各設定シークレットについて、そのエントリをKeeperボルトの直接検索に置き換えることができます。例えば、ハードコードされたMySQLデータベースのパスワードをボルトのレコードに置き換えます。

変更前

MYSQL_HOSTNAME: "db"
MYSQL_DATABASE: "guacamole_db"
MYSQL_USERNAME: "guacamole_user"
MYSQL_PASSWORD: "your_mysql_database_password"

変更後

MYSQL_HOSTNAME: "db"
MYSQL_DATABASE: "guacamole_db"
MYSQL_USERNAME: "guacamole_user"
MYSQL_PASSWORD_KSM_SECRET: keeper://2ZlOFQAYi4DubJWBtSbRxw/field/password

トークンの構文には、Keeper表記法を使用しています。パラメータの名前は、 *_KSM_SECRET の形式に従います。この例では、MySQLデータベースのパスワードが共有フォルダ内のKeeperのレコードから直接取得されます。

Keeperボルトに設定を保管

それぞれの *_KSM_SECRET 変数の値は、必要な設定値を取得するために使用するシークレットのKeeper表記法です。たとえば、SOME_VARIABLE_KSM_SECRET が有効なKeeper表記法に設定された場合、SOME_VARIABLE に通常関連付けられているGuacamoleプロパティの値は、KSMのそのシークレットから取得されます。

ファイルの変更を保存した後、コンテナを更新します。

$ sudo ./kcm-setup.run upgrade

Docker Composeのインストールメソッド

docker-compose.yml ファイルを編集します。

保護したい各設定シークレットについて、そのエントリをKeeperボルトの直接検索に置き換えることができます。例えば、ハードコードされたMySQLデータベースのパスワードをボルトのレコードに置き換えます。

MYSQL_HOSTNAME: "db"
MYSQL_DATABASE: "guacamole_db"
MYSQL_USERNAME: "guacamole_user"
MYSQL_PASSWORD_KSM_SECRET: keeper://2ZlOFQAYi4DubJWBtSbRxw/field/password

トークンの構文には、Keeper表記法を使用しています。この例では、以下のようにMySQLデータベースのパスワードが共有フォルダ内のKeeperのレコードから直接取得されます。

Keeperボルトに設定を保管

それぞれの *_KSM_SECRET 変数の値は、必要な設定値を取得するために使用するシークレットのKeeper表記法です。たとえば、SOME_VARIABLE_KSM_SECRET が有効なKeeper表記法に設定された場合、SOME_VARIABLE に通常関連付けられているGuacamoleプロパティの値は、KSMのそのシークレットから取得されます。

ファイルの変更を保存した後、コンテナを更新します。

sudo su
docker-compose up -d

その他の設定オプション

dockerインストールでは、ADDITIONAL_GUACAMOLE_PROPERTIES_KSM パラメータを使用して、guacamole.properties ファイルから guacamole.properties.ksm にパラメータを移動できます。