Настройка SIP-I/SIP-T транка с помощью Yate

Добрый день, коллеги.

У меня плохо получается излагать свои мысли в письменном виде (да и не родной для меня русский язык), но постараюсь описать свой метод настройки данного типа транка.

Так получилось, что наш местный телеком начал давать доступ в PSTN другим VoIP провайдерам лишь посредством протокола SIP-I. Тем кто успел подключится по E1/SS7 повезло (а может и нет), а новым приходится как-то выкручиваться: одни покупают дорогие софтсвичи, другие ищут варианты подешевле, а то и бесплатно. Мы пошли вторым путем. Если интересно чем это все закончилось, добро пожаловать под кат.

Введение

SIP-I и SIP-T относятся к двум очень похожим между собой технологиям для взаимодействия ISUP и SIP сетей. В частности они предоставляют методы для транспортировки конкретных ISUP параметров через сеть основанной на протоколе SIP, так что вызовы инициированные и терминированные в сетях ISUP могут спокойно проходить через сеть SIP, без потери информации.

SIP-T был разработан IETF — та же контора которая разработала сам SIP. Примерно в тоже время была разработана последняя версия SIP (середина 2002-го). Данный протокол описан в RFC 3372, RFC 3398, RFC 3578 и RFC 3204.

SIP-I был разработан ребятами из ITU в 2004-ом году и использует большинство конструкций определенных в SIP-T. Он описан в ITU-T Q.1912.5.

Оба протокола описывают методы маппинга сообщений, параметров и кодов ошибок между SIP и ISUP. Так же они полностью совместимы с обычной сетью основанной на SIP.

SIP-I отличается от SIP-T тем, что использует много стандартов и драфтов IETF, да и намного богаче в параметрах которые позволяет передавать. SIP-I содержит не только базовые параметры звонка, но и позволяет использовать параметры дополнительных услуг, таких как CLIP и CLIR.

На данный момент в вариантах связи SoftSwitch — SoftSwitch, SIP-T более распостранен. Например в CDMA2000 он используется для взаимодействия между MSC. SIP-I рассматривается как вариант для взаимодействия между SoftSwitch-ом и обычными сетями в 3GPP.

Дабы не нагружать вас сухой теорией, покажу как выглядит в WireShark дамп такого звонка:

Как видно в Message Body был добавлен раздел «application/isup» где в свою очередь были инкапсулированы все поля ISUP.

Настройка

В интернете вообще очень мало информации по настройке данных протоколов, а реальных примеров днем с огнем не сыщешь. Мы довольно основательно подошли к этому делу и наткнулись на Yate.

Yate позиционирует себя как телефонный движок нового поколения. Его трудно как-то выделить по классу, так как он умеет все. Написан он румынскими программистами из Null Team. На хабре есть несколько статей про него, но там он используется в других решениях.

Плюсы:
1. Написан на C++.
2. Модульная структура.
3. Есть модули на все случаи жизни.
4. Позволяет писать конфигурацию на разных языках программирования: php, perl, python, javascript.

Минусы:
1. Очень мало документации. Мне например пришлось полностью читать исходники чтобы понять до конца принципы его работы. Кстати в почтовой рассылке люди жалуются на это, но как сказал один мудрый человек: «Документация у Yate есть, и она очень хорошая, просто написана на C++».

Я не буду описывать процесс установки и первоначальной настройки. Их можно найти на сайте проекта и на хабре. Я опишу лишь основные моменты чтобы наш софтсвитч начал понимать SIP-I/SIP-T.

И так, чтобы Yate смог кодировать и декодировать поля из «application/isup» надо включить следующий параметр в файле ysipchan.conf:

[sip-t] isup=enable 

После этого при входящем звонке от телекома в стандартных сообщениях Yate появятся поля isup как на примере ниже. Эти поля мы уже можем использовать при маршрутизации и биллинге.

Sniffed 'call.preroute' time=1350892372.716302   thread=0x7f017c011600 'Call Router'   data=(nil)   retval='(null)'   param['id'] = 'sip/4'   param['module'] = 'sip'   param['status'] = 'incoming'   param['address'] = '172.xxx.xxx.xxx:5060'   param['billid'] = '1350892357-3'   param['answered'] = 'false'   param['callid'] = 'sip/SBCxdl85tuup8zxylqx8xbcdp5pcvtbtpw8@SoftX3000/zxzlwuzt-CC-23/'   param['message-prefix'] = 'isup.'   param['isup.protocol-type'] = 'itu-t92+'   param['isup.protocol-type'] = 'itu-t'   param['isup.message-type'] = 'IAM'   param['isup.NatureOfConnectionIndicators'] = '0sat,cont-check-none,echodev'   param['isup.ForwardCallIndicators'] = 'national,e2e-none,interworking,isup-notreq,sccp-none'   param['isup.CallingPartyCategory'] = 'ordinary'   param['isup.TransmissionMediumRequirement'] = '3.1khz-audio'   param['isup.CalledPartyNumber'] = 'xxxxxxxxx'   param['isup.CalledPartyNumber.nature'] = 'subscriber'   param['isup.CalledPartyNumber.plan'] = 'isdn'   param['isup.CalledPartyNumber.inn'] = 'false'   param['isup.OptionalForwardCallIndicators'] = 'non-CUG'   param['isup.CallingPartyNumber'] = 'xxxxxxxxx'   param['isup.CallingPartyNumber.nature'] = 'national'   param['isup.CallingPartyNumber.plan'] = 'isdn'   param['isup.CallingPartyNumber.complete'] = 'true'   param['isup.CallingPartyNumber.restrict'] = 'allowed'   param['isup.CallingPartyNumber.screened'] = 'network-provided'   param['isup.PropagationDelayCounter'] = '0'   param['isup.LocationNumber'] = ''   param['isup.LocationNumber.nature'] = '0'   param['isup.LocationNumber.plan'] = 'unknown'   param['isup.LocationNumber.inn'] = 'true'   param['isup.LocationNumber.restrict'] = 'unavailable'   param['isup.LocationNumber.screened'] = 'network-provided'   param['isup.ParameterCompatInformation.PropagationDelayCounter'] = 'transit,cnf,discard-param,nopass-param'   param['isup.ParameterCompatInformation.EchoControlInformation'] = 'transit,nopass-param'   param['isup.ParameterCompatInformation'] = '31 d4 37 c0'   param['isup.parameters-unhandled-cnf'] = 'PropagationDelayCounter'   param['caller'] = 'xxxxxxxxx'   param['called'] = 'xxxxxxxxx'   param['ip_transport'] = 'UDP'   param['newcall'] = 'true'   param['domain'] = '172.xxx.xxx.xxx'   param['device'] = 'Huawei SoftX3000 V300R010'   param['username'] = ''   param['xsip_nonce_age'] = '0'   param['antiloop'] = '19'   param['ip_host'] = '172.xxx.xxx.xxx'   param['ip_port'] = '5060'   param['ip_transport'] = 'UDP'   param['sip_uri'] = 'sip:xxxxxxxxx@172.xxx.xxx.xxx:5060;user=phone'   param['sip_from'] = 'sip:xxxxxxxxx@172.xxx.xxx.xxx;user=phone'   param['sip_to'] = '<sip:xxxxxxxxx@172.xxx.xxx.xxx;user=phone>'   param['sip_callid'] = 'SBCxdl85tuup8zxylqx8xbcdp5pcvtbtpw8@SoftX3000'   param['device'] = 'Huawei SoftX3000 V300R010'   param['sip_allow'] = 'INVITE,ACK,OPTIONS,BYE,CANCEL,REGISTER,INFO,PRACK,SUBSCRIBE,NOTIFY,UPDATE,MESSAGE,REFER'   param['sip_supported'] = '100rel'   param['sip_user-agent'] = 'Huawei SoftX3000 V300R010'   param['sip_privacy'] = 'none'   param['sip_p-charging-vector'] = 'icid-value=0a.0a.00.0a-2012102210555100;orig-ioi=www.huawei.com;icid-generated-at=172.xxx.xxx.xxx'   param['sip_p-asserted-identity'] = '<sip:xxxxxxxxx@172.xxx.xxx.xxx;user=phone>'   param['sip_contact'] = '<sip:xxxxxxxxx@172.xxx.xxx.xxx:5060;user=phone>'   param['sip_content-type'] = 'multipart/mixed;boundary=ssboundary-1_'   param['rtp_addr'] = '172.xxx.xxx.xxx'   param['media'] = 'yes'   param['formats'] = 'alaw,mulaw'   param['transport'] = 'RTP/AVP'   param['rtp_rfc2833'] = 'false'   param['rtp_port'] = '40016'   param['rtp_forward'] = 'possible' 

Исходящий звонок от нас выглядит так (regexroute.conf):

; Контекст определенный на этапе preroute [PSTN]  ; Выставляем параметры для всех звонков попавших в данный контекст.  .*=;osip_P-Asserted-Identity=<sip:${caller}@172.xxx.xxx.xxx:5060$()user=phone>;\         message-prefix=isup.;\         isup.message-type=IAM;\         isup.protocol-type=itu-t92+;\         isup.NatureOfConnectionIndicators=echodev;\         isup.CallingPartyCategory=ordinary;\         isup.ForwardCallIndicators=national,e2e-none,interworking,isup-notreq,sccp-none;\         isup.TransmissionMediumRequirement=3.1khz-audio;\         isup.CalledPartyNumber=${called};\         isup.CalledPartyNumber.nature=national;\         isup.CalledPartyNumber.plan=isdn;\         isup.CalledPartyNumber.inn=false;\         isup.CallingPartyNumber=${caller};\         isup.CallingPartyNumber.nature=national;\         isup.CallingPartyNumber.plan=isdn;\         isup.CallingPartyNumber.complete=true;\         isup.CallingPartyNumber.restrict=allowed;\         isup.CallingPartyNumber.screened=network-provided  ; Уже сама маршрутизация .*=sip/sip:${called}@172.xxx.xxx.xxx 

Вот и все. Теперь все SIP инвайты от нас идут с полями ISUP в Message Body.

Если у уважаемого сообщества есть вопросы буду рад ответить. Мы на Yate собаку съели и смогли разобраться во многих нюансах.