BroadRouter
시작하기

IP 허용 목록(IP allow list)

업데이트

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

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

BroadNet Inference에서는

계정 페이지에서 IPv4나 IPv6 주소, 또는 CIDR 범위를 한 줄에 하나씩, 최대 32개까지 추가하세요. 목록이 비어 있으면 제한이 없습니다. 새 키는 계정 목록을 물려받습니다. 키별 allowed_ips를 설정하면 그 키에서는 계정 목록 대신 이 값이 적용됩니다.

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 허용 목록에, 오류 표는 오류와 재시도에 있습니다. 데이터 보호 전반은 ZDR 체크리스트를 참고하세요.

흔한 실수

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

자주 묻는 질문

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

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

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

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

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

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

Markdown으로 읽기ChatGPT에 질문하기Claude에 질문하기Perplexity에 질문하기