4 시크릿 사용자 매크로

개요

Zabbix는 사용자 매크로 값의 민감한 정보를 보호하기 위해 두 가지 옵션을 제공합니다:

  • 시크릿 텍스트
  • 볼트 시크릿

시크릿 매크로의 값은 숨겨져 있지만, 아이템에서 사용될 때 노출될 수 있습니다. 예를 들어, 외부 스크립트에서 시크릿 매크로를 참조하는 echo 문이 매크로 값을 프론트엔드에 노출시킬 수 있습니다. 이는 Zabbix 서버가 실제 매크로 값에 액세스할 수 있기 때문입니다. 시크릿 매크로 값이 마스킹 해제되는 위치를 참조하세요.

시크릿 매크로는 트리거 표현식에서 사용할 수 없습니다.

시크릿 텍스트

시크릿 텍스트 매크로를 사용하면, 매크로 값이 별표로 마스킹됩니다.

매크로 값을 시크릿으로 만들려면, Value 필드 끝의 버튼을 클릭하고 Secret text 옵션을 선택합니다:

설정이 저장되면, 더 이상 값을 볼 수 없게 됩니다.

매크로 값을 변경하려면, Value 필드 위에 마우스를 올리고 Set new value 버튼을 클릭합니다(마우스 오버 시 나타남):

Set new value 버튼을 클릭하거나 매크로 값 타입을 변경하면, 현재 값이 삭제됩니다. Value 필드 끝의 화살표를 클릭하여 원래 값을 복원할 수 있습니다(새 설정을 저장하기 전에만 사용 가능). 원래 값을 복원해도 값이 노출되지는 않습니다.

시크릿 매크로가 포함된 URL은 작동하지 않습니다. 매크로가 "******"로 해석되기 때문입니다.

볼트 시크릿

볼트 시크릿 매크로를 사용하면, 매크로 값이 외부 시크릿 관리 소프트웨어(볼트)에 저장됩니다.

볼트 시크릿 매크로를 설정하려면, Value 필드 끝의 버튼을 클릭하고 Vault secret 옵션을 선택합니다:

매크로 값은 볼트 시크릿을 가리켜야 합니다. 입력 형식은 볼트 제공업체에 따라 다릅니다. 제공업체별 설정 예제는 다음을 참조하세요:

볼트 시크릿 매크로 값은 Zabbix 서버가 설정 데이터를 새로 고칠 때마다 볼트에서 검색되어 설정 캐시에 저장됩니다.

Zabbix 프록시는 각 설정 동기화 시 Zabbix 서버로부터 볼트 시크릿 매크로 값을 받아서 자체 설정 캐시에 저장합니다. 프록시는 볼트에서 직접 매크로 값을 검색하지 않습니다. 이는 Zabbix 프록시가 재시작 후 Zabbix 서버로부터 설정 업데이트를 받을 때까지 데이터 수집을 시작할 수 없음을 의미합니다.

볼트에서 시크릿 값을 수동으로 새로 고치려면, secrets_reload 런타임 제어 옵션을 사용합니다.

Zabbix 서버와 프록시 간에 암호화가 활성화되어야 합니다. 그렇지 않으면 서버 경고 메시지가 기록됩니다.

매크로 값을 성공적으로 검색할 수 없는 경우, 해당 값을 사용하는 아이템이 지원되지 않음으로 변경됩니다.

마스킹 해제된 위치

이 목록은 시크릿 매크로 값이 마스킹 해제되는 매개변수의 위치를 제공합니다.

Zabbix 7.0.13부터, 간접적으로 참조되는 경우 아래 위치에서 시크릿 매크로 값이 마스킹된 상태로 유지됩니다. 예를 들어, 미디어 타입(스크립트 또는 웹훅 매개변수)에서 사용되는 {ITEM.KEY}, {ITEM.KEY<1-9>}, {LLDRULE.KEY} 내장 매크로net.tcp.port[192.0.2.1,80] 대신 net.tcp.port[******,******]와 같이 마스킹된 시크릿 매크로가 포함된 아이템 키로 해석됩니다.

컨텍스트 매개변수
아이템, 아이템 프로토타입, LLD 규칙
아이템 아이템 키 매개변수
아이템 프로토타입 아이템 프로토타입 키 매개변수
로우레벨 디스커버리 규칙 디스커버리 아이템 키 매개변수
SNMP 에이전트 SNMP 커뮤니티
컨텍스트 이름 (SNMPv3)
보안 이름 (SNMPv3)
인증 암호구문 (SNMPv3)
프라이버시 암호구문 (SNMPv3)
HTTP 에이전트 URL
쿼리 필드
요청 본문
헤더
사용자명
암호
SSL 키 암호
스크립트 매개변수
스크립트
브라우저 매개변수
스크립트
데이터베이스 모니터 SQL 쿼리
TELNET 에이전트 스크립트
사용자명
암호
SSH 에이전트 스크립트
사용자명
암호
단순 체크 사용자명
암호
JMX 에이전트 사용자명
암호
아이템 값 전처리
JavaScript 전처리 단계 스크립트
웹 시나리오
웹 시나리오 변수 값
헤더 값
URL
쿼리 필드 값
Post 필드 값
Raw post
웹 시나리오 인증 사용자
암호
SSL 키 암호
커넥터
커넥터 URL
사용자명
암호
토큰
HTTP 프록시
SSL 인증서 파일
SSL 키 파일
SSL 키 암호
네트워크 디스커버리
SNMP SNMP 커뮤니티
컨텍스트 이름 (SNMPv3)
보안 이름 (SNMPv3)
인증 암호구문 (SNMPv3)
프라이버시 암호구문 (SNMPv3)
글로벌 스크립트
웹훅 JavaScript 스크립트
JavaScript 스크립트 매개변수 값
Telnet 사용자명
암호
SSH 사용자명
암호
스크립트 스크립트
미디어 타입
스크립트 스크립트 매개변수
웹훅 매개변수
IPMI 관리
호스트 사용자명
암호