BroadRouter
시작하기

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

업데이트

서버의 외부 송신 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를 쓰세요. 한 번의 호출로 목록 전체를 교체합니다(포털 자격 증명 필요).

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

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 허용 목록 용어 설명에 정리되어 있습니다.

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

자주 묻는 질문

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

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

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

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

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

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

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

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

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