API 요금이 걷잡을 수 없이 불어나는 가장 흔한 원인은 키 유출입니다. BroadNet Inference는 이를 막는 두 가지 수단을 제공합니다. IP 허용 목록과 빠른 폐기입니다.
두 종류의 자격 증명
| 자격 증명 | 용도 | 취급 방식 |
|---|---|---|
| 추론용 키 | /v1/*로 보내는 모델 요청 |
앱이나 에이전트 하나에 쓰는 비밀 값 |
| 포털 자격 증명 | 계정 자동화: 키, 허용 IP, 구매 | 계정 전체 권한 |
둘 다 한 번만 표시됩니다. 포털은 SHA-256 해시만 보관하므로 키를 다시 보여 줄 수 없습니다. 종량제 추론용 키는 생성 후 1년간 유효하며, 계정 하나에 활성 키를 최대 10개까지 둘 수 있습니다.
허용 목록 설정
계정 페이지에서 IPv4·IPv6 주소나 CIDR 범위를 한 줄에 하나씩, 최대 32개까지 추가하세요. 빈 목록은 IP 제한이 없다는 뜻입니다. 새 키는 이 계정 목록을 물려받습니다. 엣지는 모든 API 요청마다 Cloudflare가 알려 주는 클라이언트 IP를 검사합니다.
스크립트로 계정 목록을 관리하려면 PUT /portal/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"]}'
키별 allowed_ips는 그 키에 대해 물려받은 계정 목록을 대체합니다. 응답에는 원본 키가 한 번만 담기니 바로 저장하세요.
유출된 키를 빠르게 폐기하기
DELETE /portal/keys/{alias}는 종량제 키를, DELETE /portal/keys/hourly/{alias}는 시간제 키를 폐기합니다(처음 구매 요금은 그대로 남습니다). 폐기나 허용 목록 변경 후 5초 안에 새 요청이 차단됩니다.
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의 모든 오류 코드와 재시도 시점을 참고하세요. 새 키로 첫 요청을 보내려면 OpenAI Python SDK 가이드를 따라 해 보세요. 개념 전반은 IP 허용 목록 용어 설명에 정리되어 있습니다.

