[comment]: # translation:outdated

[comment]: # ({72ab9926-72ab9926})
# 13 secrets の保存

[comment]: # ({/72ab9926-72ab9926})

[comment]: # ({753be55f-753be55f})
#### 概要

HashiCorp Vault KV Secrets Engine - Version 2では、いくつかの機密情報を秘密裏に保存することが可能です。<br>
シークレットは、以下の目的で保存することができます:

-   ユーザーマクロの値
-   データベースアクセスクレデンシャル

Zabbix は Vault 内のシークレットを他の人が管理していると仮定して、読み取り専用アクセスを提供します。

[comment]: # ({/753be55f-753be55f})

[comment]: # ({6c5ad307-6c5ad307})
#### ユーザーマクロ値

ユーザーマクロの値をVaultに秘密裏に保存することが可能です。

"[Vault secret](/manual/config/macros/user_macros#configuration)" というユーザーマクロの値には
参照パス ('path:key', 例えば "secret/zabbix:password") が含まれます。

以下のコマンドを使用すると、例で述べたパスの値を設定することができます。

    # Enable "secret/" mount point if not already enabled, note that "kv-v2" must be used
    $ vault secrets enable -path=secret/ kv-v2

    # Put new secret with key password under mount point "secret/" and path "secret/zabbix"
    $ vault kv put secret/zabbix password=<password>

    # Test that secret is successfully added
    $ vault kv get secret/zabbix

    # Finally test with Curl, note that "data" need to be manually added after mount point and "/v1" before the mount point, also see --capath parameter
    $ curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix

秘密値は設定データを更新するたびに Zabbix server によって取得され、設定キャッシュに保存されます。<br>
参照パスに読み取り専用でアクセスするための認証トークンをサーバ設定( 'VaultToken' パラメータ)で指定する必要があります。<br>
マクロの値が正常に取得できない場合、その値を使用する対応する項目はサポートされなくなります。

また、Vaultから秘密の値を更新することも可能です。<br>
'secrets\_reload'コマンドライン[option](/manual/concepts/server#runtime_control)を使用することで、Vaultのシークレット値を更新することも可能です。<br>

Zabbix proxy は Vault と通信を行い、データベース認証情報以外のシークレットを取得することはありません。<br>
Zabbix proxy のシークレット値は、設定変更のたびに Zabbix server から取得され、Zabbix server と同じように<br>
設定キャッシュに保存されます。

つまり、Zabbix proxy は再起動後、Zabbix server から初めて設定データの更新を受け取るまでデータ収集を開始することが<br>
できません。Zabbix server と proxy 間の暗号化を有効にする必要があり、有効にしない場合、サーバ警告メッセージが<br>
記録されます。

[comment]: # ({/6c5ad307-6c5ad307})

[comment]: # ({0397a06f-0397a06f})
#### データベースクレデンシャル

Zabbix server、proxy、フロントエンドで使用するデータベースのクレデンシャルをVaultに密かに保存することが<br>
サポートされています:

- データベース認証情報を取得するための Vault 関連パラメータは、
フロントエンドの[installation wizard](/manual/installation/frontend)で任意に入力することができます。

Vault から取得したデータベース証明書は、フロントエンドでキャッシュされます。ファイルシステムの一時ファイル<br>
ディレクトリが、フロントエンドでのデータベースクレデンシャルのキャッシュに使われることに注意してください。<br>
ZBX\_DATA\_CACHE\_TTL [constant](/manual/web_interface/definitions) を使用して、データキャッシュの更新/無効化の<br>
頻度を制御することができます。

-   server / proxy の場合、VaultDBPath 設定パラメータを使用して、キー 'password' と 'username' によるデータベースの
    認証情報を取得するパスを指定できます(例: secret/zabbix/database)。

例で述べたパスの値を設定するために、次のコマンドを使用することができます:

    # Enable "secret/" mount point if not already enabled, note that "kv-v2" must be used
    $ vault secrets enable -path=secret/ kv-v2

    # Put new secrets with keys username and password under mount point "secret/" and path "secret/zabbix/database"
    $ vault kv put secret/zabbix/database username=zabbix password=<password>

    # Test that secret is successfully added
    $ vault kv get secret/zabbix/database

    # Finally test with Curl, note that "data" need to be manually added after mount point and "/v1" before the mount point, also see --capath parameter
    $ curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix/database

[comment]: # ({/0397a06f-0397a06f})

[comment]: # ({afa61aff-afa61aff})
#### 設定パラメータ

Zabbix server / proxy に、Vault認証とデータベース認証情報の取得のための新しい設定パラメータが追加されました。:

-   VaultToken - Vault認証トークン(詳細はZabbix [server](/manual/appendix/config/zabbix_server) / [proxy](/manual/appendix/config/zabbix_proxy) 設定ファイルを参照してください)
-   VaultURL - Vault サーバの HTTP\[S\] URL
-   VaultDBPath - データベースの認証情報を取得するための Vault のパス(例: secret/zabbix/database)

Zabbix server とZabbix proxy は、起動時に zabbix\_server.conf と zabbix\_proxy.conf から Vaul t関連の設定パラメータを<br>
読み取ります。

Zabbix server と Zabbix proxy は、起動時に VAULT_TOKEN 環境変数を読み込み、フォークされたスクリプトで<br>
使用できないように設定を解除します。

::: noteclassic
フォワードスラッシュとコロンは予約済みシンボルです。フォワードスラッシュは、マウントポイントとパスの区切りにのみ<br>
使用できます(例: secret/zabbix はマウントポイントが secret、zabbix がパス)<br>
Vault マクロの場合、パスとキーの区切りにはコロンのみを使用できます。マウントポイントをフォワードスラッシュで<br>
区切った名前で作成する必要がある場合(例:マウントポイントが "foo/bar"、パスが "zabbix" の場合は "foo%2Fbar/zabbix" )、
マウントポイント名またはパスにコロンが必要な場合は "/" ":" をURLエンコードすることが可能です。
:::

[comment]: # ({/afa61aff-afa61aff})

[comment]: # ({71d9c0a5-71d9c0a5})
#### TLSの設定

証明機関（CA）によって署名された証明書は、デフォルトのCAストアに追加する必要があります。または、<br>
SSLCALocation 構成パラメータを使用して、カスタム CA ストアの場所を指定することもできます。<br>
この場合、証明書ディレクトリは openssl c\_rehash ユーティリティを使用して準備する必要があります。<br>
例えば、SSLCALocation を設定し、そのディレクトリ内に "ca.pem" をコピーして、次のコマンドを実行します。<br>

    $ c_rehash .

[comment]: # ({/71d9c0a5-71d9c0a5})