
10월 17일 아침, Google Cloud에서 “프로젝트가 정지되었습니다”라는 메일을 받았습니다. 학원 관리 앱 MindSprout에서 쓰던 Gemini API 키가 누군가에게 도용돼, 키가 속한 Google Cloud 프로젝트가 악성 활동으로 정지된 것입니다. 이 글은 1인 개발자로서 겪은 사고의 타임라인과 대응 과정, 그리고 Gemini API 키를 발급한 뒤 바로 해야 할 보안 설정을 정리한 개발일지입니다.
※ 보안을 위해 프로젝트 ID, 키 일부, 결제 계정 정보는 모두 지우고 작성했습니다.
- 학원 관리 앱 MindSprout의 Gemini API 키가 제3자에게 도용돼, 연결된 Google Cloud 프로젝트가 정지됐습니다.
- 하루 1천 원 미만이던 지출이 나흘 동안 최대 1만 4천 원대까지 치솟았지만, 정지 메일을 받기 전까지 몰랐습니다.
- 키를 삭제하자 다른 서비스(온유리본)도 같은 키를 쓰고 있어 함께 멈췄습니다. 진짜 문제는 키 하나를 여러 서비스가 공유한 구조였습니다.
- 재검토 요청 3일 만에 정지가 풀렸고, 이후 서비스별 프로젝트·키·결제 계정을 분리했습니다.
01사고 타임라인
| 날짜 | 일어난 일 |
|---|---|
| ~10/13 | 하루 Gemini 지출 1천 원 미만 (평소 수준) |
| 10/14~10/17 | 지출 급증: 약 1.9천 원 → 1.4만 원 → 3.3천 원 → 5천 원 |
| 10/17 오전 | Google Cloud 정지 통보. 콘솔 화면이 모두 재검토 요청 양식으로 이동 |
| 10/17 오후 | 코드 점검, 키 삭제, 재검토 요청 제출 |
| 10/18 | 같은 키를 쓰던 온유리본 장애 발견, 새 프로젝트의 새 키로 교체 |
| 10/20 | 재검토 결과 정지 해제, 결제 계정 분리 |
28일 동안 지출은 약 3만 5천 원으로 큰돈은 아니었습니다. 하지만 금액보다 무서웠던 것은 프로젝트 정지였습니다. 정지되는 순간 그 프로젝트의 AI 기능이 전부 멈추기 때문입니다.
02놓친 신호: 요금 그래프는 미리 알려주고 있었다
돌아보면 신호는 정지 3일 전부터 있었습니다. MindSprout는 하루 한 번 도는 예약 작업과 Discord 봇 정도만 AI를 쓰기 때문에 지출이 거의 일정합니다. 10월 10일 이후로는 코드 변경도 없었습니다. 그런데 10월 14일부터 지출이 몇 배로 뛰었습니다.
문제는 이 그래프를 아무도 보고 있지 않았다는 것입니다. 예산 알림이 없었기 때문에, 첫 연락은 Google의 정지 통보였습니다. Google Cloud의 예산 및 예산 알림 기능을 걸어두었다면 이틀은 먼저 알았을 겁니다.
03유출 경로 찾기: 코드에는 없었다
가장 먼저 의심한 곳은 코드 저장소였습니다. 그래서 다음을 하나씩 확인했습니다.
- 키는
.env.local에만 있었고,.env파일은 Git에서 제외돼 한 번도 커밋되지 않았습니다. - Git 전체 이력에서 Google API 키 형식의 문자열을 검색했지만 나오지 않았습니다.
- 키는 서버 코드에서만 읽고, 브라우저로 내려가는 빌드 결과물에는 들어 있지 않았습니다.
- 브라우저에 노출되는 별도 접근 키도 있었지만, 실제 운영 서버에서는 그 키로 AI 기능을 호출할 수 없다는 것을 직접 요청을 보내 확인했습니다.
결국 코드에서는 유출 경로를 찾지 못했습니다. 남은 가능성은 키를 AI 도구나 메신저, 다른 서버 설정에 붙여넣은 기록 같은 “코드 밖”의 경로였습니다. 코드만 깨끗하다고 Gemini API 키가 안전한 것은 아니라는 점을 배웠습니다. 서버 쪽 인증 설계는 Next.js 보안 세션과 RBAC 구축기에서 다뤘습니다.
04키를 지웠더니 다른 서비스가 멈췄다
도용된 키를 바로 삭제했습니다. 그런데 다음 날, 영어 변형문제 생성기 온유리본의 문제 생성이 실패하고 있다는 것을 알게 됐습니다. 확인해보니 온유리본 운영 서버도 같은 MindSprout 키를 쓰고 있었습니다. 개발 초기에 편하게 키 하나를 복사해 쓴 것이 그대로 남아 있었던 겁니다.
이번 사고에서 가장 큰 교훈은 여기였습니다. 키 하나가 도용되면 그 키를 쓰는 모든 서비스가 같이 위험해집니다. 온유리본은 온유리본 전용 프로젝트에서 새 키를 발급해 교체했습니다. 서비스가 멈추지 않게 새 키를 먼저 적용하고, 정상 작동을 확인한 뒤 예전 키를 지우는 순서로 진행했습니다.
05정지된 프로젝트는 결제 설정도 못 바꾼다
두 프로젝트는 같은 결제 계정에 묶여 있었습니다. 정지된 프로젝트를 결제 계정에서 떼어내려 했지만, 정지 상태에서는 결제 설정 변경 자체가 막혀 있었습니다. 결제 계정이 제한되면 정상인 온유리본까지 영향을 받을 수 있는 상황이었습니다.
정지가 풀릴 때까지는 결제 계정에 월 5만 원 예산 알림을 걸어 이상 지출을 바로 알 수 있게 했고, 정지가 해제된 뒤 MindSprout 프로젝트를 결제 계정에서 분리했습니다.
06재검토 요청과 복구
재검토 요청에는 사실만 간단히 적었습니다. 평소에는 하루 한 번 도는 예약 작업과 Discord 봇만 사용했다는 것, 10월 10일 이후 코드 변경이 없었다는 것, 키는 서버에만 보관했고 사고 당일 삭제했다는 것, 그리고 해당 사용량은 제3자의 도용이라는 것입니다. 요청 3일 뒤인 10월 20일, 정지 해제 연락을 받았습니다.
07Gemini API 키 발급 후 바로 해야 할 5가지
이번 사고 이후 모든 프로젝트에 적용한 체크리스트입니다. 처음 Gemini API 키를 발급하는 분들도 그대로 따라 하면 됩니다. 공식 설명은 Google의 Gemini API 키 사용 안내와 API 키 관리 문서에 있습니다.
- 서비스마다 프로젝트와 키를 따로 만들기: 키 하나가 도용돼도 다른 서비스는 멈추지 않습니다.
- 키 사용 범위 제한하기: 키가 Gemini API(Generative Language API)만 호출할 수 있도록 제한하고, 가능하면 서버 IP로 사용처도 제한합니다.
- 예산 알림 걸기: 평소 지출의 몇 배 수준으로 월 예산 알림을 설정합니다. 정지 메일보다 먼저 이상을 알 수 있습니다.
- 결제 계정 분리하기: 중요한 서비스는 다른 결제 계정에 두어, 한 프로젝트 문제가 결제 전체로 번지지 않게 합니다.
- 키는 서버에만, 붙여넣기는 하지 않기:
NEXT_PUBLIC_같은 브라우저 노출 변수에 넣지 말고, AI 도구나 메신저에 키를 붙여넣지 않습니다.
| 항목 | 사고 전 | 사고 후 |
|---|---|---|
| 프로젝트·키 | 두 서비스가 키 하나 공유 | 서비스별 전용 프로젝트와 키 |
| 결제 계정 | 하나에 모두 연결 | 중요 서비스만 단독 연결 |
| 지출 감시 | 없음 | 월 예산 알림 |
| 키 교체 방법 | 삭제 후 장애 발견 | 새 키 적용 → 확인 → 예전 키 삭제 |
08인 개발자로서 배운 점
혼자 여러 서비스를 만들다 보면 “일단 돌아가게” 하는 것이 먼저가 됩니다. 키를 복사해 쓰고, 요금은 월말에 한 번 보는 식입니다. 이번 사고는 그 지름길의 비용이 생각보다 크다는 것을 보여줬습니다. 금액은 3만 원대였지만, 학원 수업에 쓰는 온유리본까지 하루 가까이 문제를 만들지 못했습니다. AI 비용 구조는 AI 문항 생성 비용 최적화 글에서, 온유리본의 설계 이야기는 영어 변형문제 AI 난이도 설계기에서 더 볼 수 있습니다.
09자주 묻는 질문
Gemini API 키가 유출됐는지 어떻게 알 수 있나요?
가장 빠른 신호는 요금입니다. 평소 사용량과 비교해 하루 지출이 갑자기 몇 배로 뛰면 의심해야 합니다. 예산 알림을 걸어두면 정지 통보보다 먼저 알 수 있습니다.
프로젝트가 정지되면 키를 새로 만들 수 있나요?
정지된 프로젝트에서는 콘솔 대부분의 화면이 재검토 요청 양식으로 넘어가서, 새 키를 만들거나 결제 설정을 바꾸기 어렵습니다. 다른 프로젝트에서 키를 새로 발급해야 합니다.
재검토 요청은 얼마나 걸렸나요?
이번 경우는 요청을 제출한 지 3일 만에 해결 연락을 받았습니다. 다만 상황마다 다를 수 있으니, 그동안 서비스가 멈추지 않도록 별도 키를 준비해두는 것이 안전합니다.
코드에 키를 넣지 않았는데도 유출될 수 있나요?
네. 이번 사고도 코드 저장소와 배포 번들에서는 키가 발견되지 않았습니다. AI 도구나 메신저에 붙여넣은 기록, 다른 서버의 환경 변수 등 코드 밖의 경로도 함께 점검해야 합니다.
10마무리
Gemini API 키는 발급하는 데 1분이면 되지만, 지키는 데는 설정 몇 가지가 더 필요합니다. 이 글이 같은 실수를 미리 막는 데 도움이 되면 좋겠습니다. 다른 개발 기록은 1인 개발 일지에서 볼 수 있습니다.
1인 개발 일지다른 개발 기록 모아보기→