먼저 간단한 테스트를 위해 개발자 모드로 실행한 후 CLI와 UI에서 활용하는 방법을 알아보겠습니다.
Vault 서버 실행 및 환경 설정
[서버 실행]
[root@DESKTOP-36OPSVG /]# vault server -dev -dev-root-token-id="root"&
& 은 백그라운드에서 실행한다는 옵션입니다.
-dev 모드는 사용자의 편의를 위해 설계된 인 메모리모드입니다. 다음과 같은 이유로 실제 운영 환경에서는 절대 사용을 권장하지 않습니다.
데이터 휘발성 모든 데이터가 메모리에 저장됩니다. 서버가 재시작되거나 꺼지면 모든 설정과 시크릿 데이터가 즉시 삭제됩니다.
봉인 해제(Unseal) 생략 본래 Vault는 시작 시 암호화된 상태를 푸는 'Unseal' 과정이 필요하지만, 개발 모드에서는 이 보안 절차를 자동으로 건너뛰고 루트 토큰을 노출합니다.
보안 취약성 기본적으로 HTTP(비암호화) 통신을 사용하며, 클러스터링이나 고가용성(HA) 설정이 적용되지 않아 보안과 안정성 면에서 매우 취약합니다.
Vault를 사용하기 위해서는 서버 주소와 토큰 등 환경변수 등록이 필요합니다.
등록 후 status 명령어로 서버 상태를 확인할 수 있습니다.
[root@DESKTOP-36OPSVG /]# export VAULT_ADDR='http://127.0.0.1:8200'
[root@DESKTOP-36OPSVG /]# export VAULT_TOKEN='root'
[root@DESKTOP-36OPSVG run]# vault status
Key Value
--- -----
Seal Type shamir
Initialized true
Sealed false
Total Shares 1
Threshold 1
Version 1.21.3
Build Date 2026-02-03T14:56:30Z
Storage Type inmem
Cluster Name vault-cluster-bbdb11c4
Cluster ID c1637150-8d7e-1f76-19f1-c6c78fe640ae
HA Enabled fals
시크릿 엔진을 이용한 DB접근
이제 실제로 DB에 접근하기 위한 엔진을 활성화하고 규칙을 작성해 보겠습니다.
# DB 시크릿 엔진 활성화
[root@DESKTOP-36OPSVG /]# vault secrets enable database# DB config 및 role 설정
[root@DESKTOP-36OPSVG /]# vault write database/config/zabbix-db \
plugin_name=mysql-database-plugin \
connection_url="{{username}}:{{password}}@tcp(127.0.0.1:3306)/" \
allowed_roles="admin-role" \
username="root" \
password="비밀번호"
Success! Data written to: database/config/zabbix-db
[root@DESKTOP-36OPSVG /]# vault write database/roles/admin-role \
db_name=zabbix-db \
creation_statements="CREATE USER '{{name}}'@'localhost' IDENTIFIED BY '{{password}}'; CREATE USER '{{name}}'@'%' IDENTIFIED BY '{{password}}'; GRANT ALL ON zabbix.* TO '{{name}}'@'localhost'; GRANT ALL ON zabbix.* TO '{{name}}'@'%';" \
default_ttl="1h" \ ==> 기본 사용시간 : 1시간
max_ttl="8h" ==> 최대 연장 가능 시간 : 8시간
Success! Data written to: database/roles/admin-role
db 시크릿 엔진 활성화 : Vault에서 DB 엔진을 사용 가능하도록 설정합니다.
db config & rloe 작성 : 연결할 DB 정보와 권한 규칙을 정의합니다.
위와같이 시크릿 비밀번호 발급이 정상적으로 이뤄지고 있습니다.
생성된 비밀번호를 통해 실제 데이터베이스 및 허용된 경로에 정상적으로 접근 가능한 것을 확인할 수 있습니다.
UI 접속 방법
Vault는 CLI 환경보다 직관적인 관리가 가능한 Web UI를 제공합니다.
접속 방법: CLI에서 설정한 경로(127.0.0.1:8200)를 웹 브라우저 주소창에 그대로 입력하여 접속합니다.
로그인: Method를 'Token'으로 선택한 후, 서버 실행 시 발급된 root을 입력하여 Sign-in 합니다.
UI는 CLI보다 서버 상태를 한눈에 파악하기 좋으며, 관리가 매우 편리하다는 장점이 있습니다.
Vault 대시보드는 로그인 시 가장 먼저 보이는 페이지로, 활성화된 시크릿 엔진과 서버 구성 세부 정보(클러스터 정보 등)를 제공합니다.
Secrets Engines: CLI에서 설정한 값들을 시각적으로 확인할 수 있습니다.
Database 연결: Create connection을 통해 신규 데이터베이스를 손쉽게 연결할 수 있습니다.
실시간 확인: database -> zabbix-db -> admin-role -> generate credentials 경로에서 암호화된 정보를 실시간 확인 가능하며, 해당 정보로 즉시 로그인도 가능합니다.
서버 상태: 아래 사진과 같은 경로로 접근하여 현재 서버의 헬스 체크 상태를 확인할 수 있습니다.
Tools 섹션에서는 워크플로 테스트나 데이터 공유에 유용한 다양한 기능을 제공합니다.
Wrapping: 데이터를 일회용 토큰으로 토큰화하며, 기본 유효 기간(TTL)은 30분입니다.
Lookup: 데이터를 압축 해제하지 않고도 토큰에 대한 유효성 정보를 확인할 수 있습니다.
Unwrapping: 래핑된 토큰을 풀어 실제 데이터를 노출합니다.
Rewrap: 사용되지 않은 토큰을 다시 래핑하여 새 토큰 값을 생성하고 TTL을 갱신합니다.
Random Byte Generator: 요청한 바이트 수에 따라 Base64 또는 16진수 형식의 임의 문자열을 생성합니다.
Hash Tool: 데이터를 입력받아 Base64 인코딩 후, 원하는 알고리즘으로 해시값을 생성합니다.
API Explorer: 로컬 API 문서에 액세스하고 브라우저에서 직접 API 호출을 테스트할 수 있어 매우 유용합니다.
정책 및 사용자 관리
고급 활용: 정책(Policies) 및 사용자 관리
DB 접근 외에도 정책을 설정하여 정교하게 사용자를 관리할 수 있습니다.
[ACL 정책 생성] Policies -> ACL Policies -> Create에서 정책을 생성합니다.