4 Secretユーザーマクロ

概要

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

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

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

シークレットテキスト

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

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

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

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

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

Vaultシークレット

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

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

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

• HashiCorp
• CyberArk

Vaultシークレットマクロの値は、Zabbixサーバー（およびシークレットVaultマクロの解決方法がZabbixサーバーとプロキシに設定されている場合はZabbixプロキシ）によって、構成データのリフレッシュごとにVaultから取得され、その後構成キャッシュに保存されます。 ZabbixサーバーとZabbixプロキシは異なるVaultを使用することができます。

シークレットVaultマクロの解決方法がZabbixサーバーに設定されている場合、Vaultシークレットはサーバーのみが取得し、Zabbixプロキシは各構成同期時にZabbixサーバーからVaultシークレットマクロの値を受け取り、自身の構成キャッシュに保存します。 つまり、Zabbixプロキシは、Zabbixサーバーから構成の更新を受け取るまで、再起動後にデータ収集を開始できません。

Vaultからシークレット値を手動でリフレッシュするには、secrets_reload ランタイムコントロールオプション（サーバーのみ）を使用します。

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

マスク解除される場所

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