# API 키 관리
> Source: https://docs.wrks.ai/admin-guide/admin-security/api-key · Last updated: 2026-11-05
API 키 관리 화면에서는 **사내 시스템이 웍스AI를 호출할 때 쓰는 키**를 발급하고 관리할 수 있어요.
### 시작하기 전에
* 이 기능은 **최고 관리자**만 쓸 수 있어요.
* 관리자 왼쪽 메뉴의 **설정/보안 > API 키 관리**에서 들어갈 수 있습니다.
### 따라하기
**1단계. 발급된 키 보기**
발급한 키가 표로 보여요. 칸은 `이름` · `키`(앞뒤 일부만) · `생성일` · `만료일` · `상태` · `허용 IP` · `삭제` 예요. `상태` 는 `활성`, 만료 21일 전부터 `곧 만료`, 지나면 `만료` 로 바뀌어요.
1단계 화면
**2단계. 새 키 발급하기**
**`+ 새 키 발급`** 을 누르고 이름(50자까지)과 만료 기간(`30일` · `90일` · `1년` · `직접 입력`, 기본 `1년`)을 고른 뒤 `발급하기` 를 눌러요. `발급 완료` 창에서 `복사` 를 누른 다음에야 `복사 완료, 닫기` 로 닫을 수 있어요. 창을 닫으면 키를 다시 볼 수 없어요.
발급한 키의 만료일은 나중에 바꾸거나 연장할 수 없어요. 만료 전에 새 키를 발급해 교체해 주세요.
2단계 화면
### 허용 IP를 함께 걸어주세요
**허용된 IP 주소 관리** 에서 API 키를 쓸 수 있는 서버의 IP를 등록합니다. 이 목록은 **따로 정하지 않은 키 모두에 적용**돼요. 등록한 IP에서 호출한 키만 허용되므로, 키가 새어 나가도 그 밖에서는 쓸 수 없어요.
키마다 다르게 하려면 키 표의 **허용 IP** 칸에서 **\[변경하기]** 를 눌러 셋 중 하나를 고르세요.
| 고르는 것 | 어떻게 되나 |
| ------------------ | ------------------------------------------ |
| **회사 설정 따르기** | 아래 회사 목록을 그대로 써요 |
| **이 키만 따로 정하기** | 여기 적은 IP에서만 이 키를 쓸 수 있어요. 회사 목록은 적용되지 않아요 |
| **어디서나 쓸 수 있게 하기** | IP를 확인하지 않아요. 꼭 필요한 키에만 쓰세요 |
IP는 적은 뒤 **\[+ 추가]** 를 눌러야 목록에 들어가요. 키마다 최대 100개까지 넣을 수 있어요.
> 목록이 비어 있으면 회사 목록을 따르는 키는 IP 제한 없이 호출돼요. 키를 쓰는 서버의 IP를 등록해 두시길 권해요.
> **사내 직원 접속 IP와는 별개**입니다. 내부 통제의 접속 제한과 헷갈리지 마세요.
입력은 세 가지 형식을 씁니다. 화면에도 예시가 적혀 있어요.
| 형식 | 예시 |
| ----- | ------------------------------- |
| 단일 IP | `218.144.97.227` |
| 범위 | `218.144.97.227-218.144.97.230` |
| CIDR | `218.144.97.224/29` |
여러 개를 한 번에 넣으실 때는 **콤마(,)로 구분**해 주세요.
회사 목록에서는 IP를 적고 `+ 추가` 를 누르면 `API Key 허용 IP 관리` 확인 창이 떠요. `적용하기` 를 누르면 저장돼요. 등록한 IP는 칩 옆 X로 하나씩, `전체 삭제` 로 한꺼번에 지울 수 있고, 지울 때도 같은 확인 창이 떠요. 키별로 따로 정할 때는 창 안에서 `+ 추가` 로 목록에 넣은 뒤 `저장하기` 를 눌러요.
> API 키 허용 IP에는 **요금이 붙지 않아요.** 하루 요금이 붙는 건 내부 통제의 접속 통제예요.
> **공인 IP만 등록할 수 있어요.** 사설 IP는 받지 않습니다.
### 연동 방법이 궁금하시면
화면 오른쪽 위의 **\[API 문서]** 를 누르면 개발 담당자가 볼 연동 문서로 이동합니다.
키가 새어 나간 것 같으면 **바로 삭제**하시고 새로 발급해 주세요.
설정 하나하나와 자주 묻는 질문은 [**관리자 도움말**](https://docs.wrks.ai/admin-help)에 정리돼 있어요.