유사 사이트를 조심하세요. 한국에이아이통신(주)의 공식 사이트는 katel.kr · katcloud.kr · zerocall.kr · aicallpay.com 입니다.공식 채널 확인
KAT CloudKOEN로그인

Asterisk PJSIP 트렁크 설정: endpoint·aor·auth·identify와 다이얼플랜

Asterisk에서 SIP 트렁크는 PJSIP의 endpoint·aor·auth·identify 네 객체와 다이얼플랜 컨텍스트로 구성합니다. 각 객체의 역할, 자리표시자 예시 설정, 수신·발신 다이얼플랜과 점검 명령을 정리했습니다.

가이드한국에이아이통신(주) KAT Cloud 팀6분 읽기
Asterisk PJSIP 트렁크 설정: endpoint·aor·auth·identify와 다이얼플랜

Asterisk에서 SIP 트렁크는 pjsip.conf의 네 가지 객체로 만듭니다. 통화 설정을 담는 endpoint, 상대 주소를 담는 aor, 인증 정보를 담는 auth, 들어온 요청을 IP로 endpoint에 짝짓는 identify입니다. 여기에 등록이 필요하면 registration을 더하고, 들어온 통화와 나갈 통화의 처리는 extensions.conf 다이얼플랜 컨텍스트에서 정합니다. KAT Cloud와 연결할 때 쓸 서버 주소·포트·인증 방식은 콘솔 또는 도입 상담으로 받으며, 아래 값은 모두 자리표시자입니다.

PJSIP 트렁크를 이루는 객체

객체(type)역할트렁크에서 쓰는 이유
transport수신 포트·프로토콜, NAT 외부 주소모든 endpoint가 공유
endpoint코덱, DTMF, 컨텍스트, 미디어 동작통화 하나의 "규칙 묶음"
aor상대에게 보낼 주소(contact)발신 시 목적지
auth사용자 이름·비밀번호상대가 다이제스트 인증을 요구할 때
identify출발 IP와 endpoint 연결인증 없이 들어오는 트렁크 통화 매칭
registration상대 서버에 REGISTER등록형 트렁크일 때만

PBX 내선은 보통 endpoint가 직접 등록해 오지만, 트렁크는 반대로 Asterisk가 상대 사업자 서버에 붙는 쪽이라 aor에 고정 contact를 적고 identify로 들어오는 통화를 알아봅니다.

예시 설정 (pjsip.conf)

아래는 개념을 보여 주는 예시입니다. sip.example.com, 203.0.113.10(문서용 IP), 계정 값은 실제 KAT Cloud 정보가 아닙니다.

ini
[transport-udp]
type=transport
protocol=udp
bind=0.0.0.0:5060
external_media_address=198.51.100.20
external_signaling_address=198.51.100.20
local_net=10.0.0.0/8

[trunk-auth]
type=auth
auth_type=userpass
username=EXAMPLE_USER
password=EXAMPLE_PASSWORD

[trunk]
type=aor
contact=sip:sip.example.com:5060
qualify_frequency=60

[trunk]
type=endpoint
transport=transport-udp
context=from-trunk
disallow=all
allow=ulaw
outbound_auth=trunk-auth
aors=trunk
from_domain=sip.example.com
direct_media=no
rtp_symmetric=yes
force_rport=yes
rewrite_contact=yes
dtmf_mode=rfc4733

[trunk]
type=identify
endpoint=trunk
match=203.0.113.10
  • allow=ulaw: KAT Cloud는 G.711 μ-law(PCMU)와 A-law(PCMA)를 지원합니다. 국내 구간은 μ-law가 기본이라 ulaw만 열어 두는 편이 협상이 단순하고, A-law가 필요하면 allow=ulaw,alaw로 둡니다.
  • dtmf_mode=rfc4733: 키패드 입력을 RTP 이벤트로 보냅니다. 상대가 다른 방식을 요구하면 맞춥니다(DTMF란?).
  • direct_media=no: 트렁크 통화의 RTP가 Asterisk를 거치게 해 NAT 문제를 줄입니다.
  • external_*, local_net: Asterisk가 사설망 안에 있을 때 SDP와 Contact에 공인 IP를 적게 합니다. 빠뜨리면 단방향 음성의 대표 원인이 됩니다.

등록형 트렁크라면 다음 블록을 더합니다. IP 인증형이면 registration은 필요 없고 identify와 상대 측 허용 IP 등록이 핵심입니다. 차이는 REGISTER vs IP 인증에 정리했습니다.

ini
[trunk-reg]
type=registration
transport=transport-udp
outbound_auth=trunk-auth
server_uri=sip:sip.example.com
client_uri=sip:EXAMPLE_USER@sip.example.com
retry_interval=60

다이얼플랜: 받는 통화와 거는 통화

endpoint의 context=from-trunk가 들어온 통화의 첫 진입점입니다.

ini
[from-trunk]
exten => _X.,1,NoOp(IN from ${CALLERID(num)} to ${EXTEN})
 same => n,Dial(PJSIP/1001,30)
 same => n,Hangup()

[to-trunk]
exten => _0X.,1,NoOp(OUT to ${EXTEN})
 same => n,Dial(PJSIP/${EXTEN}@trunk,60)
 same => n,Hangup()
  • 받는 통화: ${EXTEN}에 착신번호가 들어옵니다. 번호가 국내형으로 오는지 국제형으로 오는지 첫 시험 통화의 로그로 확인한 뒤 패턴을 맞춥니다.
  • 거는 통화: 내선의 컨텍스트에서 to-trunk를 include하면 내선이 트렁크로 발신합니다. 발신번호 표시는 상대 사업자가 허용한 번호여야 하며 임의로 바꿀 수 없습니다.
  • AI 연결: 특정 조건의 통화만 AI 음성 서버로 보내는 구조는 기존 PBX에 AI 붙이기를 참고하세요.

적용 후 점검 명령

명령보는 것
pjsip show endpointsendpoint 상태, 연결된 aor
pjsip show registrations등록형일 때 Registered 여부
pjsip show contactsqualify 응답 시간(Avail 여부)
pjsip set logger onINVITE·응답 원문 확인
rtp set debug onRTP가 실제로 오가는지

401·403·488 같은 응답이 보이면 SIP 응답 코드 읽는 법에서 원인을 찾아보세요. 연동 전 준비 항목은 SIP 연동 준비 체크리스트에 있습니다.

KAT Cloud의 SIP 직접 연결은 모든 플랜에서 무료이고, 기본 동시통화는 10회선입니다(요금). KAT Cloud 가입하기로 7일 무료 체험을 시작하거나, 구성이 복잡하다면 도입 상담을 신청하세요.

자주 묻는 질문

Asterisk PJSIP 트렁크에 identify가 꼭 필요한가요?

Asterisk PJSIP에서 상대 사업자가 인증 없이 IP 기준으로 통화를 보내는 경우, identify가 없으면 들어온 INVITE가 어느 endpoint인지 알 수 없어 거절되거나 익명 처리됩니다. IP 인증형 트렁크라면 identify에 상대 신호 서버 주소를 반드시 넣으세요.

KAT Cloud와 연결할 때 Asterisk 코덱은 무엇으로 설정하나요?

KAT Cloud는 G.711 μ-law(PCMU)와 A-law(PCMA)를 지원하므로 Asterisk endpoint에서 allow=ulaw(필요하면 ulaw,alaw)를 설정합니다.

Asterisk가 사설망 안에 있으면 무엇을 바꿔야 하나요?

Asterisk가 공유기나 방화벽 뒤 사설망에 있다면 transport에 공인 IP(external_media_address, external_signaling_address)와 local_net을 적고, 방화벽에서 SIP 포트와 RTP 포트 범위를 열어야 합니다. 그렇지 않으면 연결은 되지만 소리가 한쪽만 들리는 문제가 생기기 쉽습니다.

  • #Asterisk
  • #PJSIP
  • #SIP 트렁크
  • #다이얼플랜
  • #PBX

Get started

만든 AI에 전화번호 연결

070 번호 발급, SIP 직접 연결, 음성 AI 모델 연결, 문자·웹훅까지 API 하나로. 월 10,000원부터.