4 Secretユーザーマクロ

概要

Zabbixでは、ユーザーマクロの値に含まれる機密情報を保護するために、2つのオプションを提供しています。

• シークレットテキスト
• Vaultシークレット

シークレットマクロはトリガー式では使用できません。

シークレットテキスト

シークレットテキストマクロでは、マクロ値はアスタリスクでマスクされます。

マクロ値をシークレットにするには、Value フィールドの末尾にあるボタンをクリックし、Secret text オプションを選択します。

設定を保存すると、その値を表示できなくなります。

マクロ値を変更するには、Value フィールドにカーソルを合わせ、Set new value ボタンをクリックします（ホバー時に表示されます）。

Set new value ボタンをクリックすると（またはマクロ値のタイプを変更すると）、現在の値は消去されます。
元の値は、Value フィールドの末尾にある 矢印をクリックすることで復元できます（新しい設定を保存する前のみ利用可能です）。
元の値を復元しても、その値が表示されることはありません。

Vaultシークレット

Vaultシークレットマクロでは、マクロ値は外部のシークレット管理ソフトウェア（vault）に保存されます。

Vaultシークレットマクロを設定するには、Value フィールドの末尾にあるボタンをクリックし、Vault secret オプションを選択します。

マクロ値はvaultシークレットを指している必要があります。
入力形式はvaultプロバイダーによって異なります。プロバイダー固有の設定例については、以下を参照してください。

• HashiCorp
• CyberArk

Vaultシークレットマクロの値は、設定データが更新されるたびに、Zabbixサーバー（および、Resolve secret vault macros by が 設定 で Zabbix server and proxy に設定されている場合は Zabbixプロキシ）によってvaultから取得され、その後設定キャッシュに保存されます。
ZabbixサーバーとZabbixプロキシは、異なるvaultを使用する場合があります。

Resolve secret vault macros by が 設定 で Zabbix server に設定されている場合、vaultシークレットはサーバーによってのみ取得され、Zabbixプロキシは各設定同期時にZabbixサーバーからVaultシークレットマクロの値を受け取り、それを自身の設定キャッシュに保存します。
これは、Zabbixプロキシが再起動後、Zabbixサーバーから設定更新を受信するまでデータ収集を開始できないことを意味します。

vaultからシークレット値を手動で更新するには、secrets_reload のruntime controlオプション（サーバーのみ）を使用します。

Zabbixサーバーとプロキシ間では暗号化を有効にする必要があります。そうでない場合、サーバーの警告メッセージがログに記録されます。

マスク解除される場所

この一覧は、シークレットマクロの値がマスク解除されるパラメータの場所を示しています。