개발 도구

네트워크 (IP 허용목록)

한국AI통신 플랫폼이 사용하는 고정 출발지 IP 전체 목록. 방화벽/PBX 화이트리스트가 필요한 경우 용도(HTTP Webhook·Stream·SIP 시그널링·RTP 미디어)별로 아래 고정 IP만 허용하세요.

Markdown으로 보기

네트워크 (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/32HTTPS (TCP 443)한국AI통신 → 고객 서버
Stream (WebSocket)34.64.147.48/32WSS (TCP 443)한국AI통신 → 고객 WebSocket 서버
SIP 시그널링 (INVITE/응답 등)34.47.65.45/32UDP 5060 · TLS (TCP 5061)한국AI통신 → 고객 PBX·외부 SIP 엔드포인트 (<Dial><Sip> 착신 포워딩, SIP 라우팅)
SIP 시그널링 (단말·PBX 등록/발신)sip.claw-ops.comTLS (TCP 5061)고객 단말·PBX → 한국AI통신
RTP 미디어 (음성)34.64.155.183/32UDP양방향

콘솔의 국외 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)도 함께 허용하세요.

관련 문서