IP 허용 목록
조직과 API 키에 허용할 IP 대역을 정해, 키가 새어도 등록하지 않은 곳에서는 쓰이지 않게 막는 방법을 설명합니다
IP 허용 목록을 켜면 등록한 IP 대역에서 온 요청만 받습니다, 키가 유효해도 목록 밖에서 온 요청은 403 ip_not_allowed로 거절됩니다, 키가 새어도 회사 네트워크나 CI 러너 밖에서는 쓰이지 않게 하는 두 번째 울타리입니다
동작
| 설정 | 동작 |
|---|---|
| 목록이 비어 있음 (기본) | 모든 IP에서 받습니다 |
| 조직 목록 | 조직의 모든 API 키 요청에 적용됩니다 |
| 키 목록 (선택) | 그 키에만 더 좁게 적용됩니다, 조직 목록과 키 목록을 모두 통과해야 합니다 |
| 목록 밖 요청 | 403 ip_not_allowed, 요청은 처리되지 않고 과금도 없습니다 |
- IPv4와 IPv6 CIDR를 받습니다 (예:
203.0.113.0/24,2001:db8::/32), 한 주소만 허용하려면/32또는/128을 붙입니다 - API, CLI, MCP, GitHub Action 요청 모두에 같은 규칙이 적용됩니다
- 콘솔 로그인 세션에는 적용하지 않습니다, 목록을 잘못 넣어도 콘솔에서 고칠 수 있습니다
설정하기
소유자와 관리자가 정합니다
- 콘솔 설정 → 조직에서 IP 허용 목록을 엽니다
- 화면 위에 지금 내 IP가 보입니다, 이 IP에서 키를 쓴다면 먼저 넣으세요
- CIDR를 한 줄에 하나씩 넣고 저장을 누릅니다
키 하나에만 적용하려면 API 키에서 키를 열고 IP 허용 목록에 넣습니다
오류
{
"error": {
"code": "ip_not_allowed",
"message": "This key may not be used from this IP address",
"retryable": false,
"fault": "client",
"request_id": "req_..."
}
}CLI와 MCP는 이 오류를 그대로 보여 주고 종료 코드 2로 끝납니다, 요청을 보낸 IP를 목록에 넣거나 목록을 비우면 바로 풀립니다