> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/admin-help/integrations/api-keys.md).

# API 키 관리 화면의 모든 것

사람이 아니라 시스템이 웍스AI를 쓸 때 필요한 열쇠예요.

`관리자 > API 키 관리` 에서 회사 시스템이 웍스AI를 부를 때 쓰는 키를 발급합니다.

### API 키가 뭔가요

**사람이 아니라 시스템이 웍스AI를 쓸 때 필요한 열쇠예요.** 사내 프로그램에서 자동으로 문서를 요약하거나 번역하게 할 때 씁니다.

직원이 화면에서 쓰는 것과는 별개예요. 일반 사용에는 필요 없습니다.

### 화면에 있는 것

| 항목               | 무엇을 하나                                              |
| ---------------- | --------------------------------------------------- |
| `+ 새 키 발급`       | 키 만들기. 키 목록 위 파란 버튼이에요 (키가 하나도 없을 때는 빈 화면 가운데에 있어요) |
| 이름               | 어디에 쓰는 키인지 (예: production-system-key)               |
| 만료 기간            | `30일` / `90일` / `1년` / `직접 입력` (기본값은 `1년`)          |
| 생성일 / 만료일        | 언제 만들고 언제 끝나는지                                      |
| 곧 만료 / D-일       | 만료가 가까우면 표시                                         |
| API Key 허용 IP 관리 | 이 키를 쓸 수 있는 IP 제한                                   |

### 발급하는 방법

1. **`+ 새 키 발급`** 을 누르면 **새 API 키 발급** 창이 열려요
2. **이름**을 적고 **만료 기간**을 고릅니다. `직접 입력` 을 고르면 아래에 날짜 칸(**만료일 선택**)이 나와요
3. **`발급하기`** 를 누릅니다
4. **`발급 완료`** 창에 키가 보여요. **`복사`** 한 뒤 **`복사 완료, 닫기`** 를 누릅니다

### 발급할 때 주의할 것

**발급 직후 화면에서만 키를 볼 수 있어요.** 창을 닫으면 다시 볼 수 없습니다. 꼭 복사해서 안전한 곳에 보관해 주세요.

이름은 나중에 알아볼 수 있게 지으세요. 키가 여러 개면 어떤 시스템 것인지 구분이 안 됩니다.

### 만료 기간

`30일` / `90일` / `1년` 중에 고르거나 `직접 입력` 으로 날짜를 정합니다.

**짧게 잡는 게 안전합니다.** 키가 유출돼도 자동으로 못 쓰게 되니까요. 다만 만료되면 그 키를 쓰는 시스템이 멈추니 미리 새 키로 바꿔주셔야 해요.

> **직접 정하실 때는 내일부터 5년 안쪽으로만 됩니다.** (2026년 9월 16일부터) 오늘이나 지난 날짜, 5년을 넘는 날짜는 저장되지 않고 사유가 표시돼요.

목록에서 만료가 가까운 키는 `곧 만료` 로 표시됩니다.

### 허용 IP 제한

이 키를 어느 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 호출이 차단됩니다. 계속하시겠습니까?" 확인 창이 떠요. **`적용하기`** 를 누르면 저장돼요.

> 이 기능은 **회사당 하루 3,000원**(30일 기준 약 9만원)의 부가서비스예요.

***

### 자주 묻는 질문

**Q. 키를 잃어버렸어요. 다시 볼 수 있나요?**

없습니다. 발급 직후에만 보여요. 새로 발급받고 예전 키는 삭제해 주세요.

**Q. 키를 삭제하면 어떻게 되나요?**

그 키를 쓰는 시스템이 바로 멈춥니다. 삭제 전에 새 키로 바꿔두세요.

**Q. API 키로 쓴 사용량은 어디에 나오나요?**

`관리자 > 이용 현황` 의 사용자 목록에서 **부가서비스/API** 로 모여 보입니다. → [사용자 목록에 있는 '부가서비스/API'는 무엇인가요](/admin-help/billing/addon-api-usage.md)

**Q. 키마다 사용량을 따로 볼 수 있나요?**

지금은 하나로 합쳐서 보입니다.

**Q. 만료된 키는 어떻게 하나요?**

새로 발급받아 시스템에 넣고, 예전 키는 삭제해 주세요.

**Q. "잘못된 IP 형식이 포함되어 있습니다" 라고 나와요.**

사설 IP(`192.168.` 로 시작하는 것 등)는 등록할 수 없어요. 회사 공인 IP를 전산 담당자에게 확인해 주세요.

**Q. 우리 회사 공인 IP를 모르겠어요.**

전산 담당자에게 문의해 주세요. 웍스AI에서는 알려드릴 수 없습니다.

**Q. 직원 로그인 IP 제한과 같은 건가요?**

다릅니다.

* **API 키 허용 IP** — 시스템이 키로 부를 때
* **내부 통제의 IP 주소 관리** — 직원이 로그인할 때

→ [내부 통제 화면의 모든 설정](/admin-help/security/internal-control.md)

**Q. '새 키 발급' 버튼이 어디 있나요?**

키 목록 위의 파란 **`+ 새 키 발급`** 버튼이에요. 키가 하나도 없으면 빈 화면 가운데에 같은 버튼이 보여요.

**Q. 만료일을 직접 고르려면요?**

만료 기간에서 **`직접 입력`** 을 고르면 날짜 칸이 나와요. 날짜를 고르고 **`발급하기`** 를 누르세요. 내일부터 5년 안쪽 날짜만 돼요.

**Q. 키를 몇 개까지 만들 수 있나요?**

시스템마다 따로 만드시는 걸 권합니다. 문제가 생겼을 때 그 키만 지우면 되니까요.

**Q. API로 파일을 올리면 거절돼요.**

API로 올리는 파일에도 **화면에서 올릴 때와 같은 회사 규칙**이 적용돼요. 회사에서 **업로드 전 결재**를 쓰고 있으면 API로도 파일을 바로 올릴 수 없어요. → [웍스 드라이브 — 관리자가 알아야 할 것](/admin-help/features/drive.md)

**Q. API 사용법 문서가 있나요?**

연동 방식은 담당자가 안내해 드려요. 고객지원으로 문의해 주세요.

### 이럴 땐 문의해 주세요

* API 연동 방법을 알고 싶을 때
* 키가 유출된 것 같을 때 (바로 삭제 후 문의)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.wrks.ai/admin-help/integrations/api-keys.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.