# 네트워크 (IP 허용목록) (/docs/network)

## 네트워크 (IP 허용목록)

한국AI통신 플랫폼과 통신하는 경로는 모두 **GCP asia-northeast3(서울) 리전의 고정(static) IP**로 통일되어 있습니다.
방화벽이나 PBX에서 IP 화이트리스트를 운영하신다면, **IP 대역(range)을 열 필요 없이** 아래 용도별 고정 IP만 허용하시면 됩니다.

모두 예약된 고정 IP입니다. 임의로 변경되지 않으며, 부득이 변경이 필요한 경우 **사전 공지**드립니다.

## 용도별 고정 IP

| 용도 | 출발지 IP | 프로토콜 | 방향 |
|------|-----------|----------|------|
| **Webhook / VoiceML** (XML fetch · status callback) | `34.64.147.48/32` | HTTPS (TCP 443) | 한국AI통신 → 고객 서버 |
| **Stream** (WebSocket) | `34.64.147.48/32` | WSS (TCP 443) | 한국AI통신 → 고객 WebSocket 서버 |
| **SIP 시그널링** (INVITE/응답 등) | `34.47.65.45/32` | UDP 5060 · TLS (TCP 5061) | 한국AI통신 → 고객 PBX·외부 SIP 엔드포인트 (`<Dial><Sip>` 착신 포워딩, SIP 라우팅) |
| **SIP 시그널링** (단말·PBX 등록/발신) | `sip.claw-ops.com` | TLS (TCP 5061) | 고객 단말·PBX → 한국AI통신 |
| **RTP 미디어** (음성) | `34.64.155.183/32` | UDP | 양방향 |

콘솔의 국외 IP 차단은 문자 발송과 콘솔 접속에 적용되고, SIP 연결에는 적용되지 않습니다. SIP 연결은 자격증명별 허용 IP 대역(IP ACL)으로 제한합니다.

## 어떤 IP를 허용해야 하나요?

연동 방식에 따라 필요한 IP가 다릅니다.

- **Webhook / VoiceML XML 을 받는 경우** → `34.64.147.48/32` (HTTPS)
- **`<Connect><Stream>` 으로 오디오 WebSocket 을 받는 경우** → `34.64.147.48/32` (WSS)
- **SIP 트렁크 / SIP 단말로 통화를 주고받는 경우** (예: 사내 PBX·FreeSWITCH·Asterisk 로 착신 포워딩) → **SIP 시그널링 `34.47.65.45/32` 와 RTP 미디어 `34.64.155.183/32` 를 함께 허용**

SIP 연동에서는 **신호(SIP)와 음성(RTP)이 서로 다른 서버에서 나갑니다.** 시그널링 IP(`34.47.65.45`)만 허용하면
호는 성립해도 음성이 한쪽만 들리거나 무음이 될 수 있습니다. 반드시 **RTP 미디어 IP(`34.64.155.183`)도 함께**
허용하세요.

## 관련 문서

- [Webhook](/docs/webhooks) — 발신 Webhook 서명 검증 및 페이로드
- [Stream](/docs/build/stream) — 실시간 오디오 WebSocket 프로토콜
- [SIP 단말](/docs/clients/sip) · [SIP 트렁크](/docs/sip-trunk) — SIP 연동