키 보안

키가 유출되면 타인이 이를 사용해 여러분의 할당량을 소진할 수 있습니다. IP 화이트리스트는 가장 직접적인 보호 수단입니다 — 여러분이 신뢰하는 IP만 키를 사용할 수 있습니다.

어디서 구성하나요

**콘솔 → API 키 → 편집(또는 생성)**으로 이동하여 IP 화이트리스트와 IP 블랙리스트라는 두 필드를 찾으세요.

한 줄에 규칙 하나씩, 두 가지 형식 중 하나로 입력합니다:

IPv4와 IPv6 모두 지원됩니다(IPv6 예: 2001:db8::/32).

어떻게 적용되나요

• 화이트리스트 비어 있음 → 출처 제한 없음; 어떤 IP든 키를 사용할 수 있음
• 화이트리스트 비어 있지 않음 → 목록에 있는 IP만 사용할 수 있고, 나머지는 모두 거부됨
• 블랙리스트 → 일치하는 IP는 거부되며, 화이트리스트보다 우선함
• 둘을 동시에 사용할 수 있습니다(블랙리스트가 먼저 확인되고 그다음 화이트리스트)

거부되면 API는 403 ACCESS_DENIED를 반환합니다.

실제 송출 IP 확인하기(중요!)

이것이 가장 저지르기 쉬운 실수입니다: 키에 구성하는 IP는 LMU AI의 서버가 보는 공인 송출 IP여야 하며, 여러분 컴퓨터의 ipconfig / ifconfig가 보여주는 사설 주소가 아닙니다.

# Command line
curl https://ifconfig.me
# or
curl https://ip.sb

또는 브라우저에서 ip.sb / ifconfig.me를 여세요.

일반적인 시나리오

시나리오 1: 고정된 사무실 IP

Whitelist:
203.0.113.10

시나리오 2: 집과 사무실 양쪽에서 작업

Whitelist:
203.0.113.10      # Company egress
198.51.100.20     # Home broadband

시나리오 3: 자체 클라우드 서버에서 실행

Whitelist:
<your cloud server's public IP>

여러분의 서버만 API를 호출하도록 허용하고, 로컬 개발에는 별도의 키(화이트리스트 없음)를 사용하세요.

시나리오 4: 의심스러운 IP를 잠시 차단하고 싶을 뿐

Blacklist:
1.2.3.4

그 외 모든 것은 평소처럼 작동하며, 정상적인 사용에 영향을 주지 않습니다.

문제 해결

Q: 제 호출이 403 ACCESS_DENIED를 반환합니다 — IP 제한 때문인가요?

대부분 그렇습니다. 순서대로 확인하세요:

1. curl https://ifconfig.me를 사용해 현재 실제 송출 IP를 확인
2. 키의 화이트리스트와 비교해 일치하는지 확인
3. 일치하지 않으면 현재 IP를 화이트리스트에 추가하거나, 화이트리스트를 임시로 비워서 테스트
4. 그래도 거부된다면 블랙리스트에 있는지, 키가 비활성화되었는지, 할당량이 소진되었는지 확인

Q: IP를 화이트리스트에 넣었는데도 거부됩니다?

• 사설 IP(192.168.x.x / 10.x.x.x / 172.16-31.x.x)를 입력하지 않았나요? 공인 송출 IP로 교체하세요.
• IPv6 주소를 입력했는데 IPv4로 접속하고 있나요(또는 그 반대)? 둘 다 입력하세요.
• 잘못된 형식의 CIDR(예: 1.2.3.4/33)을 입력하지 않았나요? 유효하지 않은 규칙은 조용히 무시됩니다.

권장 사례

• 프로덕션 키의 경우, 공격 표면을 최소화하기 위해 IP 화이트리스트를 구성하는 것을 강력히 권장합니다
• 개발 / 디버깅 키의 경우 화이트리스트를 건너뛸 수 있지만, 백스톱으로 총 할당량 상한을 반드시 설정해야 합니다
• 유출이 특히 걱정된다면 속도 제한, 총 할당량, 모델 화이트리스트와 결합하여 계층적 방어를 구성하세요
• 키가 유출되었다고 의심되는 순간, 즉시 콘솔에서 키를 재설정하거나 삭제하세요

마지막 업데이트: 2026-09-10