---
title: "API 키 IP 허용 목록(화이트리스트)이란? CIDR 예시 | BroadRouter"
description: "IP 허용 목록은 등록한 주소나 CIDR 범위에서 온 요청만 받습니다. LLM API 키를 보호하는 원리, CIDR 표기법, 클라우드 egress IP의 함정을 정리했습니다."
url: https://broadrouter.com/ko/glossary/ip-allow-list/
lang: ko
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# IP 허용 목록(IP allow list)

업데이트 2026-11-14

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

다른 이름: IP 화이트리스트, IP 허용 리스트, 허용 IP, IP 제한, IP 접근 제한, IP allowlist, IP whitelist, allowed IPs, IP restriction, allowed\_ips

API 키는 기본적으로 어디서든 작동합니다. 허용 목록은 키를 실제로 코드가 실행되는 곳에만 묶어 둡니다.

## 작동 방식

API의 엣지는 각 요청의 출발지 IP를 목록과 대조합니다. 주소가 목록에 있거나 등록된 범위 안에 있으면 요청은 일반적인 키 검사로 넘어갑니다. 그렇지 않으면 거부됩니다.

범위는 CIDR 표기법으로 씁니다. 주소, 슬래시, 프리픽스 길이 순입니다. RFC 4632는 프리픽스 길이가 앞에서부터 고정되는 비트 수라고 설명합니다. IPv4의 예는 다음과 같습니다.

| 항목 | 범위 |
| --- | --- |
| `203.0.113.7` | 주소 1개 |
| `198.51.100.0/24` | 주소 256개, `198.51.100.0`부터 `198.51.100.255`까지 |
| `10.0.0.0/16` | 주소 65,536개 |

IPv6도 같은 원리이며 `2001:db8::/48`처럼 128비트 주소를 씁니다.

중요한 것은 **egress** IP, 즉 서버의 트래픽이 밖으로 나가는 공인 주소입니다. NAT, 로드 밸런서, 사내 프록시 뒤에서는 이 주소가 머신이 스스로 보여 주는 주소와 다른 경우가 많습니다.

## 왜 중요한가

[API 키](https://broadrouter.com/ko/glossary/api-key/)는 베어러 토큰이라서 가진 사람이면 누구나 쓸 수 있습니다. 키는 커밋, 로그, 스크린샷, 노트북을 통해 유출됩니다. 허용 목록이 있으면 탈취한 키도 공격자의 네트워크에서는 실패하므로, 유출이 비용 사고가 아니라 아무 일도 아닌 일로 끝납니다. 예를 들어 GitHub은 웹 로그인뿐 아니라 API 호출과 개인 액세스 토큰에도 허용 목록을 적용합니다.

대가는 약간의 운영 작업입니다. 서버, 리전, CI 러너를 새로 추가할 때마다 그 egress IP를 등록해야 하고, 동적 IP라면 고정된 egress 경로가 필요합니다.

## BroadNet Inference에서는

계정 페이지에서 IPv4나 IPv6 주소, 또는 CIDR 범위를 한 줄에 하나씩, 최대 32개까지 추가하세요. 목록이 비어 있으면 제한이 없습니다. 새 키는 계정 목록을 물려받습니다. 키별 `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"]}'
```

다른 주소에서 온 요청은 403을 받습니다. 목록을 바꾸거나 키를 폐기하면 5초 안에 새 요청이 차단됩니다. 전체 절차는 [API 키와 IP 허용 목록](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/)에, 오류 표는 [오류와 재시도](https://broadrouter.com/ko/guides/errors-and-retries/)에 있습니다. 데이터 보호 전반은 [ZDR 체크리스트](https://broadrouter.com/ko/blog/zero-data-retention-llm-api-checklist/)를 참고하세요.

## 흔한 실수

-   공인 egress IP 대신 `10.x.x.x` 같은 서버의 사설 주소를 등록하는 것.
-   오류를 없애려고 너무 넓은 범위를 쓰는 것. `/8` 하나가 1,600만 개가 넘는 주소를 포함합니다.

## 자주 묻는 질문

### IP 허용 목록만으로 API 키를 충분히 보호할 수 있나요?

아닙니다. 보호 계층 하나일 뿐입니다. 키는 여전히 서버에만 두고, 코드와 로그에 남기지 말고, 앱마다 별도 키를 쓰고, 유출되면 바로 폐기하세요.

### 서버리스나 오토스케일링 환경에서도 허용 목록을 쓸 수 있나요?

아웃바운드 트래픽이 알려진 주소에서 나갈 때만 가능합니다. 고정 IP를 가진 NAT 게이트웨이나 egress 프록시로 트래픽을 보낸 뒤, 그 주소를 등록하세요.

### 목록에 없는 IP에서 요청하면 어떤 오류가 나나요?

BroadNet Inference에서는 403이 반환됩니다. 다른 API도 보통 403을 반환합니다.

## 함께 보기

-   [API 키(API key)](https://broadrouter.com/ko/glossary/api-key/) (용어)
-   [데이터 비보관(Zero data retention, ZDR)](https://broadrouter.com/ko/glossary/zero-data-retention/) (용어)
-   [속도 제한(rate limit)](https://broadrouter.com/ko/glossary/rate-limit/) (용어)
-   [IP 허용 목록으로 API 키를 내 서버에만 묶기](https://broadrouter.com/ko/guides/api-keys-ip-allow-lists/) (가이드)
-   [BroadNet Inference 오류 코드와 재시도해야 하는 경우](https://broadrouter.com/ko/guides/errors-and-retries/) (가이드)
-   [데이터 비보관(ZDR) LLM API: 확인해야 할 질문 10가지](https://broadrouter.com/ko/blog/zero-data-retention-llm-api-checklist/) (글)

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

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

**출처**

-   [RFC 4632: Classless Inter-domain Routing(CIDR)](https://www.rfc-editor.org/rfc/rfc4632)
-   [GitHub Docs, 조직의 허용 IP 주소 관리](https://docs.github.com/en/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)
-   [BroadNet Inference API 레퍼런스, IP 허용 목록 (영어)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ko-glossary-ip-allow-list&utm_content=sources#ip-allow-lists)
