---
title: "LLM API 키를 서버 IP로 제한하는 방법 | BroadRouter"
description: "IP 허용 목록으로 BroadNet Inference 키를 보호하고, 추론용 키와 포털 자격 증명을 분리하고, 유출된 키를 몇 초 만에 폐기하는 방법을 curl 예제와 함께 설명합니다."
url: https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/
lang: ko
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

이 페이지는 영어 원문을 AI의 도움을 받아 번역했습니다. [영어 원문 읽기](https://broadrouter.com/guides/api-keys-ip-allow-lists/) (2026-11-16 업데이트).

# IP 허용 목록으로 API 키를 내 서버에만 묶기

업데이트 2026-11-16

서버의 외부 송신 IPv4·IPv6 주소나 CIDR 범위를 계정 허용 목록에 최대 32개까지 추가하세요. 새 키는 생성할 때 allowed\_ips를 넘기지 않는 한 이 목록을 그대로 물려받습니다. 다른 주소에서 온 요청은 403을 받으며, 허용 목록 변경이나 키 폐기는 5초 안에 적용됩니다.

API 요금이 걷잡을 수 없이 불어나는 가장 흔한 원인은 키 유출입니다. BroadNet Inference는 이를 막는 두 가지 수단을 제공합니다. IP 허용 목록과 빠른 폐기입니다.

## 두 종류의 자격 증명

| 자격 증명 | 용도 | 취급 방식 |
| --- | --- | --- |
| 추론용 키 | `/v1/*`로 보내는 모델 요청 | 앱이나 에이전트 하나에 쓰는 비밀 값 |
| 포털 자격 증명 | 계정 자동화: 키, 허용 IP, 구매 | 계정 전체 권한 |

둘 다 한 번만 표시됩니다. 포털은 SHA-256 해시만 보관하므로 키를 다시 보여 줄 수 없습니다. 종량제 추론용 키는 생성 후 1년간 유효하며, 계정 하나에 활성 키를 최대 10개까지 둘 수 있습니다.

## 허용 목록 설정

계정 페이지에서 IPv4·IPv6 주소나 CIDR 범위를 한 줄에 하나씩, 최대 32개까지 추가하세요. 빈 목록은 IP 제한이 없다는 뜻입니다. 새 키는 이 계정 목록을 물려받습니다. 엣지는 모든 API 요청마다 Cloudflare가 알려 주는 클라이언트 IP를 검사합니다.

스크립트로 계정 목록을 관리하려면 `PUT /portal/allowed_ips`를 쓰세요. 한 번의 호출로 목록 전체를 교체합니다(포털 자격 증명 필요).

포털 자격 증명으로 키를 만들 때 그 키에만 적용할 목록을 따로 지정할 수 있습니다.

```bash
curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'
```

키별 `allowed_ips`는 그 키에 대해 물려받은 계정 목록을 대체합니다. 응답에는 원본 키가 한 번만 담기니 바로 저장하세요.

## 유출된 키를 빠르게 폐기하기

`DELETE /portal/keys/{alias}`는 종량제 키를, `DELETE /portal/keys/hourly/{alias}`는 시간제 키를 폐기합니다(처음 구매 요금은 그대로 남습니다). 폐기나 허용 목록 변경 후 5초 안에 새 요청이 차단됩니다.

```bash
curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"
```

`KEY_ALIAS`에는 계정 페이지나 `GET /portal/keys`에 표시되는 키의 별칭(alias)을 넣으세요. 별칭은 비밀 키가 아닙니다. 포털 자격 증명이 유출되었다면 `DELETE /portal/credentials/{id}`로 폐기하세요. 포털 자격 증명은 계정이 할 수 있는 모든 일을 할 수 있습니다.

## 문제 해결

-   **목록에 넣은 서버에서 403이 남.** 엣지에는 서버의 사설 IP가 아니라 공인 송신 주소가 보입니다. NAT 게이트웨이, 프록시, 로드 밸런서 뒤에 있는 서버는 그 장비의 주소로 나갑니다. IPv6가 있는 서버는 IPv4 주소만 등록했더라도 IPv6로 나갈 수 있습니다. 요청이 실제로 나가는 주소나, 그 주소를 포함하는 CIDR 범위를 등록하세요.
-   **새 키가 계정 목록을 무시함.** 키별 `allowed_ips` 배열은 그 키에 대해 물려받은 계정 목록을 대체합니다. 생성할 때 무엇을 넘겼는지 확인하세요.
-   **409 `key_limit_reached`.** 계정에 이미 활성 키가 10개 있습니다. 더 이상 쓰지 않는 키를 하나 폐기하세요.
-   **폐기 후 몇 초 동안 요청이 계속 성공함.** 캐시가 따라잡는 동안 최대 5초까지는 정상입니다.

목록에 없는 주소에서 온 요청은 403을 받습니다. [BroadNet의 모든 오류 코드와 재시도 시점](https://broadrouter.com/ko/guides/errors-and-retries/)을 참고하세요. 새 키로 첫 요청을 보내려면 [OpenAI Python SDK 가이드](https://broadrouter.com/ko/guides/openai-python-sdk/)를 따라 해 보세요. 개념 전반은 [IP 허용 목록 용어 설명](https://broadrouter.com/ko/glossary/ip-allow-list/)에 정리되어 있습니다.

_[image: A metal key whose bow is shaped like curly braces { }, with the text "One API key. More possibilities."]_

## 이 가이드의 용어

[종량제(Pay-as-you-go)](https://broadrouter.com/ko/glossary/pay-as-you-go/)

종량제(pay-as-you-go)는 구독이나 최소 약정 없이 토큰, 요청, 오디오 분 같은 단위로 사용량을 측정해 쓴 만큼만 내는 요금 방식입니다. 대부분의 LLM API가 선불 잔액에서 차감하거나 정기 청구서를 발행하는 식으로 이렇게 과금합니다.

[AI 에이전트(AI agent)](https://broadrouter.com/ko/glossary/agent/)

AI 에이전트는 언어 모델이 목표를 향해 스스로 단계를 정하는 시스템입니다. 어떤 도구를 호출할지 결정하고, 결과를 읽고, 최종 답변을 내거나 한도에 닿을 때까지 이를 반복합니다. 정해진 지점에서 모델을 호출하는 고정된 스크립트는 보통 워크플로라고 부릅니다.

[IP 허용 목록(IP allow list)](https://broadrouter.com/ko/glossary/ip-allow-list/)

IP 허용 목록(IP allow list)은 목록에 있는 IP 주소나 CIDR 범위에서 온 요청만 받고 나머지는 모두 거부하는 보안 통제입니다. API에서는 키가 유출되어도 목록에 없는 네트워크에서는 작동하지 않으므로 피해를 줄여 줍니다.

## 자주 묻는 질문

### LLM API 키를 내 서버 IP 주소에서만 쓰게 하려면 어떻게 하나요?

BroadNet 계정 페이지에서 서버의 공인 송신 주소나 CIDR 범위를 계정 허용 목록에 추가하거나, POST /portal/keys로 키를 만들 때 allowed\_ips를 넘기세요. 그 밖의 주소에서 온 요청은 403으로 거부됩니다.

### 허용 목록이 비어 있으면 모든 요청이 차단되나요?

아니요. 빈 목록은 IP 제한이 없다는 뜻이므로 키를 어느 주소에서나 쓸 수 있습니다. 제한을 켜려면 항목을 하나 이상 추가하세요.

### 추론용 키로 다른 키를 만들 수 있나요?

아니요. 추론용 키는 /v1/\* 모델 경로만 호출합니다. 키 생성과 폐기, 허용 IP 변경, 시간제 키 구매에는 계정 전체 권한을 가진 포털 자격 증명이 필요합니다.

### 유출된 키를 폐기하면 얼마나 빨리 적용되나요?

BroadNet 문서에 따르면 폐기나 허용 목록 변경 후 5초 안에 새 요청이 차단됩니다. 인가 결정이 그동안 복제된 캐시에 남아 있을 수 있기 때문입니다.

## 관련 가이드

-   [BroadNet Inference 오류 코드와 재시도해야 하는 경우](https://broadrouter.com/ko/guides/errors-and-retries/)
-   [BroadNet Inference에서 OpenAI Python SDK 사용하기](https://broadrouter.com/ko/guides/openai-python-sdk/)

실제 워크로드로 테스트해 보세요. 신규 계정에는 US$5 상당의 초기 크레딧이 제공되며 Gemma 및 음성 전사에 사용할 수 있습니다. DeepSeek, GLM 및 Qwen3.8 모델은 충전이 필요합니다.

[시작하기](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-api-keys-ip-allow-lists&utm_content=page-cta) ·

**출처**

-   [BroadNet Inference API 레퍼런스, IP 허용 목록(2026-11-16 확인) (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-api-keys-ip-allow-lists&utm_content=sources#ip-allow-lists)
-   [BroadNet Inference API 레퍼런스, 시간제 키와 포털 자격 증명(2026-11-16 확인) (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-api-keys-ip-allow-lists&utm_content=sources#hourly-keys)
-   [BroadNet Inference API 레퍼런스, 한도(키 유효 기간과 활성 키)(2026-11-16 확인) (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-guides-api-keys-ip-allow-lists&utm_content=sources#limits)
