바이브 코딩 →

시크릿(비밀키)Secrets

시크릿(Secrets)은 은행 금고에 맡겨 둔 열쇠 같은 것 — API 키·토큰·비밀번호처럼 노출되면 안 되는 값을 코드 밖의 안전한 보관소에 따로 저장해 두고 프로그램이 실행될 때만 꺼내 쓰게 하는 방식이에요.

시크릿은 현관 열쇠를 문 앞 화분 밑이 아니라 은행 금고에 맡겨 두는 것과 비슷해요. 프로그램이 외부 서비스에 접속하려면 API 키나 토큰 같은 열쇠가 필요한데, 이걸 코드에 그대로 적어 두면 코드를 본 누구나 열쇠를 가져갈 수 있어요. 그래서 열쇠는 별도의 보관소에 이름을 붙여 넣어 두고, 코드에는 '그 이름의 값을 꺼내 써'라는 말만 남겨요.

강의에서는 여러 곳에서 시크릿을 등록해요. Codex 클라우드나 Claude 클라우드 환경을 만들 때 일반 환경 변수 칸과 시크릿 칸이 따로 있어서, API 키나 구글 서비스 계정 JSON, Claude·Codex 토큰 같은 민감한 값은 시크릿 칸에 넣어요. 사이트 작업에서는 OpenAI·Vimeo API 키를 코드에 넣지 않고 Supabase 시크릿에 이름을 붙여 저장한 뒤 엣지 함수에서 불러 써요. 마지막으로 Codex 보안 리뷰를 돌려 저장소 전체에서 키가 코드에 노출된 곳이 없는지 프런트엔드부터 데이터베이스까지 점검해요.

환경 변수와 시크릿은 둘 다 코드 밖에 값을 두는 방식이지만, 시크릿은 저장한 뒤 화면에 다시 보이지 않거나 로그에서 가려지는 등 더 엄격하게 다뤄져요. 공개돼도 괜찮은 설정값은 환경 변수, 새면 안 되는 열쇠는 시크릿에 넣는다고 기억하면 쉬워요. 깃허브에 키가 올라갔는지 걱정되면 AI에게 저장소 전체 검사를 맡기고, 이미 올라갔다면 파일만 지우지 말고 키를 바로 재발급해야 해요. 커밋 기록에 그대로 남아 있기 때문이에요.

💡 대표 예시

  • 클라우드 환경 설정 — Claude·Codex 토큰을 일반 변수 말고 시크릿 칸에 넣는다
  • 사이트 연동 — OpenAI·Vimeo API 키를 Supabase 시크릿에 이름 붙여 저장한다
  • 보안 점검 — Codex 보안 리뷰로 저장소에 키가 노출된 곳이 있는지 찾는다
  • 키 유출 대응 — 깃허브에 올라간 키를 즉시 폐기하고 새 키로 재발급한다
  • 서비스 계정 연결 — 구글 서비스 계정 JSON 내용을 시크릿으로 등록한다

🔗 관련 용어

API 키

API 키 (API Key)는 건물 출입용 사원증 같은 것 — 내 프로그램이 AI나 외부 서비스를 쓸 때 '누가 쓰는지'를 증명하는 비밀 문자열로, 사용량과 요금도 이 키 기준으로 기록돼요.

엣지 함수(Edge Function)

엣지 함수(Edge Function)는 창고 안에 상주하는 작업자 같은 것 — Supabase 같은 서비스 안에서 내가 짠 코드를 대신 실행해 주는 작은 서버 프로그램으로, 별도 서버 없이 필요한 기능을 돌릴 수 있어요.

환경변수

환경변수는 금고 열쇠를 별도 서랍에 보관하는 것 — 비밀번호·API 키 같은 민감 정보를 코드 안에 직접 쓰지 않고 별도 파일에 분리해서 관리하는 방식.

.gitignore(깃이그노어)

.gitignore(깃이그노어)는 이삿짐에서 빼놓을 물건 목록 같은 것 — Git이 기록하거나 GitHub에 올리지 않을 파일과 폴더를 적어 두는 설정 파일이에요.

보안 취약점 점검(보안 감사)

보안 취약점 점검(Security Audit)은 이사 전에 집의 문단속과 창문을 하나하나 확인하는 것 같은 것 — 사이트나 프로그램에서 공격자가 파고들 수 있는 약한 곳을 찾아 고치는 검사예요.

수파베이스

수파베이스(Supabase)는 엑셀 표와 출입 명부를 한데 묶은 창고 같은 것 — 사이트의 회원·주문·상품 데이터를 저장하는 데이터베이스와 로그인 기능을 함께 제공하는 클라우드 백엔드 서비스예요.

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.