> ## Documentation Index
> Fetch the complete documentation index at: https://manual.seahorse.dnotitia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> API Key 영구 삭제 — 외부 시스템 호출 즉시 중단. 비활성화 먼저 검토 후 진행

# Apikey delete

# API Key 삭제

**경로**: Console → **Management → API Keys** → 대상 행의 🗑 Delete 아이콘

<img src="https://mintcdn.com/dnotitia-328335e7/nH6QAwwQZ-jsIFdi/.gitbook/assets/admin__Managementkey3.png?fit=max&auto=format&n=nH6QAwwQZ-jsIFdi&q=85&s=133cea30da9574a3aead7ae0a2590d80" alt="삭제 확인 다이얼로그" width="982" height="804" data-path=".gitbook/assets/admin__Managementkey3.png" />

API Key 를 **영구 제거** 합니다. 삭제된 키는 복구 불가이며, 해당 키를 사용 중이던 모든 외부 호출이 **즉시 인증 실패** 합니다.

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

| 상황                 | 권장                                          |
| ------------------ | ------------------------------------------- |
| 일시 중단이 목적 (테스트·점검) | **비활성화**(Power 토글) 로 충분. 활성/비활성은 자유로이 왕복 가능 |
| 유출 의심·사고 대응        | **즉시 비활성화 → 신규 키 발급 → 기존 키 삭제**             |
| 퇴사자·종료된 프로젝트의 키 정리 | 비활성화로 1\~2 주 관찰 후 **영향 없으면 삭제**             |
| 더 이상 쓰지 않는 키 정기 정리 | 삭제 (방치된 키는 유출 경로)                           |

<Warning>
  급하지 않다면 **비활성화를 먼저** 검토하세요. 어느 시스템이 키를 쓰고 있었는지 모를 때 즉시 삭제하면 원인 불명의 장애로 이어질 수 있습니다.
</Warning>

## 삭제 절차

<Steps>
  <Step title="영향 분석">
    삭제 전, 해당 키를 사용하는 시스템을 확인하세요.

    * `Created By` 필드로 발급 담당자 파악
    * Key Name 의 명명 규칙(예: `prod-etl`, `external-dashboard-read`) 에서 용도 유추
    * 유출 의심이 아니면 **비활성화 먼저** → 외부 호출이 실패하는 시스템이 있는지 1\~2 일 관찰
  </Step>

  <Step title="Delete 아이콘 클릭">
    목록 행의 **🗑 Delete** (빨간색) 아이콘 클릭 → 확인 다이얼로그 표시.
  </Step>

  <Step title="확인 후 Delete">
    다이얼로그의 **Delete** 클릭 → 키 영구 제거 + 목록에서 행 제거.
  </Step>

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

## 삭제 시 발생하는 일

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

## 주의 사항

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

<Info>
  삭제 이력은 감사 목적으로 보존되며, `Created By` 를 기준으로 **누가 발급·사용한 키를 언제 삭제했는지** 추적 가능합니다. 자세한 감사: [Events](/internal/system-admin/operations/events)
</Info>

## 관련 문서

* [API Key 목록](/console/management/api-keys/apikey-list)
* [API Key 생성](/console/management/api-keys/apikey-create) — 신규 키 발급
* [API Key 상태 수정](/console/management/api-keys/update-status) — 비활성화(대안)
* [API Keys 기능 개요](/console/management/api-keys)