4 Secretユーザーマクロ

概要

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

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

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

シークレットテキスト

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

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

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

マクロ値を変更するには、値フィールドにカーソルを合わせ、新しい値を設定ボタン（ホバー時に表示）をクリックします。

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

Vaultシークレット

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

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

マクロの値は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 ランタイム制御 オプション（サーバーのみ）を使用します。

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

マスク解除される場所

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