GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
모든 가이드

· reAPI Team

API 키 유출: 무단 사용과 과금 차단하기

API 키 유출을 차단하고, 새로운 사용량과 미결제 요금을 구분하며, 노출된 인증 정보를 안전하게 교체하고 청구 검토에 필요한 증거를 준비합니다.

API 키 유출: 무단 사용과 과금 차단하기

지금 서비스 제공업체의 계정 콘솔에서 노출된 키를 폐기하세요. 시간을 기록하세요. 스크린샷, 저장소 또는 로그 항목 조사는 인증 정보를 무효화한 뒤에 할 수 있습니다.

비밀 정보가 나타난 위치를 삭제해도 다른 사람이 이미 보유한 사본은 무효화되지 않습니다. 이 때문에 GitHub 지침은 저장소 정리보다 폐기 또는 교체를 먼저 하도록 안내합니다.[1] 애플리케이션이 해당 키를 사용 중이라면 교체에 조율이 필요할 것으로 예상하세요. 애플리케이션이 정상 작동한다는 사실은 노출이 확인된 인증 정보를 활성 상태로 남겨 둘 이유가 되지 않습니다.

평소 사용하는 계정 로그인 경로에서 시작하세요

유출을 발견했다고 주장하는 메시지의 링크가 아니라, 평소 사용하는 북마크나 알고 있는 제공업체의 계정 주소를 사용하세요. 안전하게 사용할 수 있는 식별자 또는 라벨로 해당 인증 정보를 찾고, 문서에 명시된 폐기 또는 비활성화 기능을 사용하세요. 사고 기록에 키의 전체 값을 붙여 넣을 필요는 없습니다.

reAPI에서는 키를 폐기하면 해당 키를 사용하는 새 요청이 차단됩니다. 여전히 그 키를 보유한 애플리케이션은 대체 키가 필요합니다. 인증 문서에는 대기 중인 작업이 폐기 후에도 완료될 때까지 계속되어 크레딧을 소비할 수 있다고 명시되어 있습니다.[2] 폐기 직후 잔액을 볼 때는 이 두 번째 설명이 중요합니다.

자동 충전과 미완료 작업은 별도의 제어 항목으로 확인하세요. 자동 자금 충전을 끄기로 했다면 그 설정이 실제로 무엇을 중단하는지 확인하세요. API 인증 정보를 폐기하거나 이미 수락된 작업을 취소하지 않으며, 그 자체로 요금의 이유를 설명하지도 않습니다. 제공업체가 취소를 지원한다면 취소 버튼을 누르면 무료가 된다고 가정하지 말고, 확정된 작업 결과와 과금 규칙을 확인하세요.

이 단계에서는 영향을 받은 계정, 인증 정보 라벨, 발견 시각과 폐기 시각을 시간대와 함께 간단히 기록하세요. 자세한 조사는 나중에 이어 갈 수 있습니다. 완벽한 보고서를 만들 때까지 기다리면 노출된 인증 정보를 더 오랫동안 사용할 수 있게 됩니다.

폐기 후에도 잔액이 변할 수 있는 이유

생성 요청이 09:01에 수락되고, 09:03에 노출된 키를 폐기한 뒤, 09:07에 작업이 완료된다고 가정해 보겠습니다. 이는 설명을 위한 순서이며 보고된 사고가 아닙니다. reAPI 문서에 명시된 대기 작업 동작에 따르면 앞서 수락된 작업이 완료되고 크레딧을 소비할 수 있습니다. 작업 계약도 제출 시 예약과 최종 정산을 구분합니다.[2][3]

09:07의 정산만으로는 해당 키가 09:03 이후 새 요청을 인증했다고 판단할 수 없습니다. 작업이 언제 수락되었는지 확인하세요. 그 타임스탬프가 답하는 질문은 처리가 끝난 시각이나 요금이 표시된 시각과 다릅니다.

반대로도 단정하지 마세요. 기록한 폐기 시각 이후에 수락된 낯선 요청은 여전히 조사해야 합니다. 다른 활성 인증 정보, 현재 보고 있는 계정 또는 조직, 그곳에 작업을 제출할 수 있는 애플리케이션이나 사람을 확인하세요. 이용 가능한 기록으로 인증 정보 또는 수락 시각을 식별할 수 없다면 그 부분은 미확인 상태로 두고 지원팀에 확인을 요청하세요.

각 의심스러운 요청에 대해 정보가 있는 경우 ID, 모델 또는 엔드포인트, 수락 시각, 완료 시각 및 정산 금액을 보관하세요. 애플리케이션이 그 요청을 인식하는지도 추가하세요. 목적은 알려진 작업과 설명되지 않는 작업을 구분하는 것이지, 줄어드는 잔액을 근거로 가설을 입증하는 것이 아닙니다.

위험에 노출된 금액은 이미 정산된 금액과 다를 수도 있습니다. 플랫폼의 계약에 따라 예약 및 최종 사용량 필드를 해석하세요. reAPI에서는 정산된 사용량이 0인 처리 중 작업도 과금이 완료되지 않은 상태입니다. 그 0은 앞선 예약 금액이 환불되었다는 증거가 아닙니다.[3] 결과가 확인될 때까지 미해결 작업을 계속 추적하세요.

실제로 키를 사용하는 프로세스에서 교체하세요

제공업체의 인증된 대시보드에서 대체 키를 만들고 애플리케이션의 비밀 정보 관리 방식으로 저장하세요. reAPI는 API Keys 설정에서 키를 생성하는 방법을 문서화하고, 환경과 서비스별로 별도 인증 정보를 사용하도록 권장합니다.[2] 다음 교체 때 모든 사용처를 다시 찾지 않도록 대체 키의 용도를 명확히 하세요.

영향을 받은 사용처에 배포하기 전에 이미 알고 있는 노출 경로를 차단하세요. 해당 프로세스가 인증 정보를 프런트엔드 번들에 공개하거나 공유 로그에 출력한다면 그 경로를 먼저 수정하세요. 전체 조사는 나중에 계속할 수 있지만, 이미 유출이 확인된 방식을 통해 대체 키를 전달해서는 안 됩니다.

그런 다음 애플리케이션에서 인증 정보의 흐름을 추적하세요. 웹 서비스, 백그라운드 워커, 예약 작업 및 API를 호출하는 모든 자동화를 확인하세요. 로컬 개발과 CI는 그 인증 정보를 사용하는 경우에만 포함하세요. 핵심은 비밀 정보를 실제로 읽는 곳을 찾는 것이지, 운영하지 않는 시스템의 긴 체크리스트를 만드는 것이 아닙니다.

키 교체 후 웹사이트는 다시 작동하지만 백그라운드 워커의 API 호출은 여전히 인증 오류를 반환한다고 가정해 보세요. 이는 가상의 진단 사례입니다. 웹 요청의 성공은 한 프로세스의 설정이 유효함을 확인해 줄 뿐입니다. 별도 워커의 환경에 대해서는 아무것도 알려 주지 않습니다. 또 다른 키를 만들기 전에 실패하는 워커가 실제로 무엇을 로드하는지 확인하세요.

비밀 정보를 출력하지 않고 설정을 검증하세요. 안전한 라벨, 설정된 비밀 정보 참조 및 애플리케이션의 기존 검증 절차를 사용하세요. 대체 값이 프로세스에 전달되었는지 확인하기 위해서만 익숙하지 않은 유료 생성을 실행할 필요는 없습니다.

reAPI 인증 오류가 발생하면 문서에 명시된 Bearer 헤더와 실제 오류 응답을 확인하세요. 유효하지 않거나 폐기된 인증 정보는 잔액 부족 및 엔드포인트 오류와 구별됩니다.[2] 새 키가 유효하지만 계정이 요청한 작업의 비용을 감당할 수 없다면 다시 교체해도 잔액 문제는 해결되지 않습니다.

서버 인증 정보는 서버에 보관하세요. Google의 키 관리 지침은 클라이언트 코드에 비밀 정보를 넣지 않도록 주의를 주며, GitHub는 재노출 방지를 위해 더 안전한 비밀 정보 처리를 권장합니다.[4][1] 가장 짧은 튜토리얼 예제를 작동시킬 수 있다는 이유만으로 브라우저 번들이나 배포되는 모바일 애플리케이션에 대체 키를 숨기는 것은 적절하지 않습니다.

이 사본이 어떻게 유출되었는지 찾으세요

기존 인증 정보가 무효화되고 정상 사용처가 대체 키를 받은 뒤에 노출된 사본을 다시 살펴보세요. 저장소 이력, 빌드된 프런트엔드 자산, CI 로그, 노트북, 스크린샷 또는 공유된 문제 해결 출력 등, 사본을 공개했을 가능성이 있는 구체적인 경로를 확인하세요.

Git 저장소에 나타났다면 현재 파일 삭제는 정리의 일부일 뿐입니다. GitHub는 민감한 내용이 이력, 포크 및 복제본에 남을 수 있다고 설명합니다.[1] 이력 삭제 작업은 저장소를 사용하는 사람들과 조율하세요. 복사된 인증 정보에 대응하는 것은 폐기이며, 정리는 해당 위치에서 노출이 계속되는 것을 줄입니다.

로그에 나타났다면 이를 출력한 코드를 찾으세요. 같은 로깅 경로를 활성 상태로 두고 로그 항목 하나만 삭제하면 다음에 애플리케이션이 오류를 보고할 때 대체 키가 노출될 수 있습니다. 성공한 요청뿐 아니라 평소 문제 해결 과정의 출력도 검토하세요. 문제가 생겼을 때 사람들이 복사하는 자료에 비밀 정보가 들어갈 수 있습니다.

스크린샷이나 공유 워크플로에 나타났다면 민감한 정보를 제거한 버전으로 자료를 교체하고 워크플로에 기존 값이 남아 있는지 확인하세요. 동료에게 삭제 증거로 비밀 정보를 다시 보내 달라고 요청하지 마세요. 인증 정보의 안전한 라벨과 영향을 받은 파일 또는 메시지 위치로 정리 과정을 추적하세요.

조사 결과와 행위자 식별을 구분하세요. 애플리케이션 로그에 요청이 없다는 사실은 그 로그로 해당 요청을 설명할 수 없다는 증거입니다. 누가 요청을 보냈는지 또는 어디서 인증 정보를 얻었는지는 입증하지 않습니다. 확인할 수 있는 노출과 식별할 수 있는 트래픽을 기록하고 나머지는 조사 대상으로 남겨 두세요.

적합한 제어 기능이 있다면 대체 키를 제한하세요

Google은 애플리케이션이나 팀별 인증 정보, 적절한 제한 및 모니터링을 권장합니다.[4] 이를 키 교체에 적용하면, 습관적으로 광범위하게 공유되는 인증 정보를 다시 만드는 대신 제공업체가 해당 제한을 지원하는 경우 백그라운드 이미지 워커에 필요한 접근 권한만 주는 것입니다.

제공되는 제어 기능은 다릅니다. fal은 권한, 만료 및 허용 모델 설정을 문서화합니다. OpenRouter의 Security Center는 지출 및 만료 제어를 문서화하고 키 비활성화와 보관을 구분합니다. IP 허용 목록은 Enterprise 기능입니다.[5][6] 의존하기 전에 계정에 실제로 제공되는 옵션의 적용 범위를 확인하세요.

지출 한도는 인증 정보, 계정, 자금 충전 행위 또는 다른 어떤 수량을 제한하는지, 이미 수락된 작업은 어떻게 되는지 확인하세요. 만료 설정은 해당 날짜 전에 어떤 애플리케이션이 대체 키를 필요로 하는지 파악하세요. 모델 제한은 정상 작업을 여전히 허용하는지 검증하세요. 어떤 문제를 억제하는지 알 때 제어 기능이 유용해집니다.

비정상 사용량 알림에 대응할 담당자를 지정하세요. 알림은 조사를 시작하도록 알려 줄 수 있지만, 대응에는 여전히 해당 인증 정보를 식별하고 폐기할 수 있는 사람이 필요합니다. 담당자 정보는 키의 용도와 함께 보관하세요. 사고 발생 시 용도 설명 없는 오래된 인증 정보 이름 목록보다 활용하기 쉽습니다.

API 제공업체 변경은 사고 이후 별도의 제품 결정으로 내릴 수 있습니다. 하지만 기존 제공업체에서 활성 상태로 남겨 둔 키를 무효화하지 않으며, 다음 서버 비밀 정보를 같은 공개 번들에 넣는 애플리케이션을 수정하지도 않습니다.

해결되지 않은 질문을 지원팀에 보내세요

작성한 타임라인을 기반으로 청구 관련 요청을 준비하세요. 계정 또는 프로젝트, 안전한 인증 정보 식별자, 의심되는 활동 시간대, 폐기 시각 및 요청 ID를 포함하세요. 관련 요금 기록과 제공업체가 필요로 하는 영수증 식별자를 첨부하세요. 공개 티켓과 스크린샷에 API 키, 카드 정보 및 고객의 비공개 파일을 넣지 마세요.

아직 확인이 필요한 사실을 중심으로 요청을 작성할 수 있습니다.

영향을 받은 인증 정보를 [시각 및 시간대]에 폐기했습니다. 첨부한 요청 목록은 애플리케이션이 인식하는 활동과 저희가 설명할 수 없는 활동을 구분합니다. 이 요청 중 폐기 후에 수락된 것이 있는지 확인하고, 앞서 대기 중이던 작업의 정산을 설명하며, 이의가 제기된 요금을 검토해 주세요.

기록이 뒷받침하는 내용을 기입하세요. 수락 타임스탬프나 인증 정보와의 연결 정보가 없다면 만들어 내지 말고 없다고 밝히세요. 이미 취한 조치를 포함해 지원팀이 지속 중인 접근과 아직 대조가 필요한 청구를 구별할 수 있도록 하세요.

보안 조사와 청구 조정은 별개의 결과입니다. 유출을 발견하거나 티켓을 생성했다고 요금이 취소되는 것은 아닙니다. 제공업체가 구체적인 요청에 답하고 조정 사항을 설명할 때까지 검토를 계속하세요. 그동안 애플리케이션의 대체 인증 정보, 수정된 노출 경로 및 미완료 작업은 각각의 기록과 대조해 확인할 수 있습니다.

참고 자료

  1. GitHub. 저장소에서 민감한 데이터 제거하기. 2026년 11월 15일 확인. GitHub 보안 지침.
  2. reAPI. 인증 참조. 2026년 11월 15일 확인. 인증 문서.
  3. reAPI. 작업 참조. 2026년 11월 15일 확인. 작업 수명 주기와 정산.
  4. Google Cloud. API 키 관리 권장사항. 2026년 11월 15일 확인. Google Cloud 인증 지침.
  5. fal. 키 기반 인증. 2026년 11월 15일 확인.
  6. OpenRouter. 새로운 Security Center로 API 키를 관리하고 위험 줄이기. 2026년 9월 28일 게시, 2026년 11월 15일 확인.
모든 가이드