Universal 목록
SWDEV / 가이드 배포자료

SW_DEV Secret 사용 가이드

redtree2379@swdev.co.kr2026. 10. 30.· 2026. 10. 30. 수정
#swdev#secret#비밀번호관리#api토큰#환경변수

secret-01-credentials

Secret은 팀이 같이 쓰는 계정 비밀번호, API 토큰, 환경 변수를 보관하는 App입니다. 값은 암호화해 저장하고 화면에서 열거나 복사할 때만 풉니다. 메신저나 문서에 비밀번호를 붙여 넣어 돌려 보던 일을 한곳으로 모을 수 있습니다.

화면에 나오는 Planet, 계정, 토큰 값은 모두 설명용 예시입니다.

한눈에 보기

메뉴 보관하는 것 예
ID/PW 서비스 계정의 아이디와 비밀번호 사내 위키 관리자, 스테이징 DB
Token API 토큰, 액세스 키 OpenAI 키, GitHub 토큰
KV 프로파일별 Key-Value 스테이징 서버의 환경 변수

Secret은 처음에는 Owner와 Admin만 씁니다. Member에게 열어 주려면 Access의 Authorization에서 Secret의 최소 역할을 바꿉니다.

1. 계정 보관하기 (ID/PW)

목록에는 라벨과 서비스, 소유자, 아이디, 최종 수정 시각이 나오고 비밀번호는 가려져 있습니다. 눈 아이콘을 누르면 잠깐 보입니다. 복사 아이콘은 값을 화면에 띄우지 않고 바로 복사합니다.

추가를 누르고 라벨, 서비스명, 소유자명, 아이디, 비밀번호를 넣습니다.

secret-02-add

  • 라벨은 목록에서 알아보기 쉬운 이름입니다. "운영 DB 관리자"처럼 용도가 드러나게 짓는 편이 좋습니다.
  • 소유자명에는 이 계정을 책임지는 팀이나 사람을 적습니다. 비밀번호를 바꿔야 할 때 누구에게 물어야 하는지 바로 알 수 있습니다.

위쪽 검색창에서는 라벨 · 서비스 · 소유자로 찾습니다.

2. API 토큰 보관하기 (Token)

secret-03-tokens

등록 방법은 ID/PW와 같습니다. 아이디와 비밀번호 대신 토큰 값을 넣습니다.

토큰 목록에는 사용처가 따로 보입니다. Gateway에서 모델을 등록할 때 자격 증명으로 Secret의 토큰을 고르면 그 연결이 사용처에 남습니다. 이렇게 연결해 두면 Secret에서 토큰을 바꾸는 것만으로 Gateway도 새 값으로 모델을 부릅니다. 키를 교체할 때 여러 곳을 고칠 필요가 없습니다.

3. 환경 변수 묶어 두기 (KV)

KV는 서버 하나, 환경 하나에 필요한 값을 프로파일로 묶어 둡니다. 왼쪽에서 프로파일을 고르면 오른쪽에 키와 값이 나옵니다.

secret-04-kv

  • 값 표시를 켜면 가려진 값이 보입니다.
  • 붙여넣기로 .env 형식이나 JSON을 통째로 넣습니다. 기존 값을 두고 겹치는 키만 덮어쓰는 '병합'과, 붙여 넣은 내용만 남기는 '교체' 중에서 고릅니다.
  • 복사는 프로파일 전체를 .env나 JSON으로 복사합니다. 서버 설정 파일에 그대로 붙여 넣으면 됩니다.
  • 키를 하나씩 더하거나 고칠 때는 위쪽 입력 칸과 각 줄의 아이콘을 씁니다.

보관 방식

값은 AES-256-GCM으로 암호화해 저장하고, 열거나 복사할 때만 복호화합니다. 누가 언제 값을 열었는지는 Access의 Flag에서 확인할 수 있습니다.

댓글 0 조회 0

댓글

등록된 댓글이 없습니다.