Skip to main content

​
API Key 삭제

경로: Console → Management → API Keys → 대상 행의 🗑 Delete 아이콘 삭제 확인 다이얼로그 API Key 를 영구 제거 합니다. 삭제된 키는 복구 불가이며, 해당 키를 사용 중이던 모든 외부 호출이 즉시 인증 실패 합니다.

​
삭제 vs 비활성화 — 어느 것을 쓸까

상황권장
일시 중단이 목적 (테스트·점검)비활성화(Power 토글) 로 충분. 활성/비활성은 자유로이 왕복 가능
유출 의심·사고 대응즉시 비활성화 → 신규 키 발급 → 기존 키 삭제
퇴사자·종료된 프로젝트의 키 정리비활성화로 1~2 주 관찰 후 영향 없으면 삭제
더 이상 쓰지 않는 키 정기 정리삭제 (방치된 키는 유출 경로)
급하지 않다면 비활성화를 먼저 검토하세요. 어느 시스템이 키를 쓰고 있었는지 모를 때 즉시 삭제하면 원인 불명의 장애로 이어질 수 있습니다.

​
삭제 절차

1

영향 분석

삭제 전, 해당 키를 사용하는 시스템을 확인하세요.
  • Created By 필드로 발급 담당자 파악
  • Key Name 의 명명 규칙(예: prod-etl, external-dashboard-read) 에서 용도 유추
  • 유출 의심이 아니면 비활성화 먼저 → 외부 호출이 실패하는 시스템이 있는지 1~2 일 관찰
2

Delete 아이콘 클릭

목록 행의 🗑 Delete (빨간색) 아이콘 클릭 → 확인 다이얼로그 표시.
3

확인 후 Delete

다이얼로그의 Delete 클릭 → 키 영구 제거 + 목록에서 행 제거.
4

외부 시스템 갱신

삭제된 키를 사용하던 외부 시스템(CI/CD·스크립트·배포 파이프라인·챗봇 등) 의 설정을 신규 키로 교체 또는 해당 시스템 중단.

​
삭제 시 발생하는 일

영향 범위결과
해당 키를 쓰던 외부 호출즉시 401 Unauthorized 실패
사용 이력·호출 로그과거 로그는 감사 목적으로 유지
콘솔 내부 선택 연결이 키를 선택했던 에이전트·리소스의 설정에서 연결 끊김 (재선택 필요)
키 값복구 불가 — 같은 Key Name 으로 재발급해도 키 값 자체는 다름

​
주의 사항

  • 삭제는 복구 불가 합니다. 일시 중단이 목적이면 비활성화(Power 토글) 를 사용하세요.
  • 외부 시스템 즉시 실패 — 해당 키를 박아놓은 CI/CD·스크립트·챗봇·외부 앱이 있으면 삭제 후 호출이 모두 실패합니다. 사전 공지 + 신규 키 교체 후 삭제 권장.
  • 유출 사고 대응 순서 — 1) 비활성화 2) 신규 키 발급·안전한 곳에 저장 3) 외부 시스템에서 신규 키로 교체 4) 기존 키 삭제. 이 순서가 서비스 중단 없이 유출 영향을 차단 하는 최소 경로입니다.
삭제 이력은 감사 목적으로 보존되며, Created By 를 기준으로 누가 발급·사용한 키를 언제 삭제했는지 추적 가능합니다. 자세한 감사: Events

​
관련 문서