시크릿 관리

안전한 자격 증명 저장

애플리케이션이 외부 서비스에 연결해야 할 때 — SendGrid를 통한 이메일 발송, Stripe를 사용한 결제 처리, AI 기능을 위한 OpenAI 사용 등 — API 키와 자격 증명을 안전하게 저장해야 합니다. Kliv의 시크릿 관리 시스템이 이를 자동으로 처리합니다.

시크릿이 안전한 이유:

  • 데이터베이스에 암호화되어 저장됩니다.
  • 저장한 후에는 전체 값이 절대 표시되지 않습니다.
  • 필요할 때 Edge Function에 자동으로 주입됩니다.
  • 계정 전체에서 공유되므로 각 키를 한 번만 저장하면 됩니다.
  • 시크릿이 생성되거나 업데이트된 시점을 추적하는 감사 추적이 남습니다.

시크릿 작동 방식

외부 서비스와 통합하고 싶다고 AI에게 알리면 AI가 필요한 자격 증명을 요청합니다. API 키를 제공하면 AI는 이를 OPENAI_API_KEY나 STRIPE_SECRET_KEY 같은 설명적인 이름으로 안전하게 저장합니다. 그 이후로는 해당 자격 증명이 필요한 모든 Edge Function이 자동으로 접근할 수 있습니다.

마스킹 표시: 시크릿을 저장한 후에는 관리 UI에 부분적으로 마스킹된 값만 표시됩니다. 예를 들어 sk-proj-abc123xyz789는 sk-p****9789로 표시됩니다. 전체 값을 노출하지 않고도 어떤 키가 어떤 것인지 확인할 수 있습니다.

자동 주입: Edge Function이 실행되면 그 함수가 참조하는 시크릿이 해당 실행에 안전하게 주입됩니다. AI는 플랫폼의 시크릿 인터페이스를 통해 시크릿을 읽도록 함수를 작성하고, 플랫폼이 런타임에 실제 값을 공급합니다. 따라서 키를 교체하면 함수의 다음 실행부터 적용됩니다.

시크릿 관리하기

관리 인터페이스를 통해 다음을 수행할 수 있습니다.

  • 모든 시크릿 보기(값은 마스킹됨)
  • 새 시크릿 추가 또는 기존 시크릿 업데이트
  • 더 이상 필요 없는 시크릿 삭제
  • 각 시크릿이 생성되거나 마지막으로 업데이트된 시점 확인

구축하려는 통합을 설명하면 AI가 시크릿을 대신 생성하고 업데이트할 수도 있습니다.

시크릿의 일반적인 용도

  • 이메일 서비스: SendGrid, Mailgun 또는 SMTP 자격 증명
  • 결제 처리: Stripe, PayPal 또는 기타 결제 API 키
  • AI 서비스: OpenAI, Anthropic 또는 Google API 키
  • SMS/통화: Twilio 인증 토큰
  • 외부 API: 앱이 통합하는 모든 타사 서비스
  • 웹훅: 수신 웹훅 검증을 위한 서명 시크릿
  • 데이터베이스 연결: 외부 데이터베이스의 연결 문자열

모범 사례

✅ 설명적인 이름 사용 - key1이나 secret이 아니라 SENDGRID_API_KEY처럼 명확하게 이름을 지정하세요.

✅ 정기적인 교체 - 특히 중요한 서비스의 경우 시크릿을 주기적으로 업데이트하세요.

✅ 끝나면 삭제 - 더 이상 사용하지 않는 서비스의 시크릿은 제거하세요.

❌ 시크릿을 공유하지 마십시오 - 각 환경(테스트, 프로덕션)은 서로 다른 API 키를 사용해야 합니다.

❌ 코드에 커밋하지 마십시오 - 시크릿을 코드와 별도로 저장하는 데는 이유가 있습니다. API 키를 소스 파일에 직접 넣지 마세요.


관련 문서: