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만 개가 넘는 주소를 포함합니다.