h1. SIP параметры оригинатора

{{>toc}}

h2. Общие

!sip_parameters.gif!

*хост* - IP адрес оригинатора с которого будут приниматься звонки. 
*динамический* - когда эта опция включена, то требуется регистрация перед звонков.
Это необходимо если по каким-то причинам Вы не хотите или не можете использовать авторизацию по IP, например пир находится под NAT и у него нет постоянного IP адреса.
Для этого на оборудовании оригинатора нужно включить регистрацию, указать IP адрес Вашего сервера, логин и пароль.
Логином является +название+ оригинатора (в данном случае some_customer_IN), а пароль указывается в поле *секрет* или *MD5 секрет*.

Если Вы хотите указать больше одного IP для оригинатора, то для этого нужно использовать меню ACL (внизу страницы).
Пример добавления двух IP:

!ACL.png!  

Так же можно добавлять целые подсети, указывая соответствующую маску подсети.
ACL просматриваются от первой до последней записи, то есть если добавить:
  1) "запретить" 192.168.1.3/255.255.255.255
  2) "разрешить" 192.168.1.3/255.255.255.255
  то результатом будет "разрешить".
Таблица ниже описывает работу ACL в связке с различными сочетаниями значений полей 

|*секрет*|*хост*|*динамический*|*ACL*|*звонки*|*регистрация*|
|-|-|-|-|-|-|
|-|-|-|+|разрешены с IP, указанных в ACL|-|
|-|-|+|-|-|-|
|-|-|+|+|разрешены с IP, указанных в ACL|-|
|-|+|-|-|разрешены с указанного хоста|-|
|-|+|-|+|разрешены с указанного хоста + ACL|-|
|+|-|-|-|авторизация идет по логину (имя пира в Smartswitch) и секрету|-|
|+|-|-|+|авторизация идет по логину (имя пира в Smartswitch) и секрету, при этом разрешенные IP указаны в ACL|-|
|+|-|+|-|разрешены после успешной регистрации с IP/порта, с которого прошла регистрация|авторизация идет по логину (имя пира в Smartswitch) и секрету|
|+|-|+|+|разрешены после успешной регистрации с IP/порта, с которого прошла регистрация|авторизация идет по логину (имя пира в Smartswitch) и секрету, при этом разрешенные IP указаны в ACL|
|+|+|-|-|авторизация идет по логину (имя пира в Smartswitch) и секрету. разрешены с указанного хоста|-|
|+|+|-|+|авторизация идет по логину (имя пира в Smartswitch) и секрету. разрешены с указанного хоста + из ACL|-|


*секрет* - пароль, который будет использоваться оригинатором для регистрации в системе.
*MD5 секрет* - MD5-Hash *секрета*, предпочтительнее использовать вместо *секрета*, так как в таком случае пароль пользователя не будет храниться на сервере в  чистом виде. Его можно сгенерировать из секрета, нажав кнопку справа. После генерации MD5 секрета незашифрованный секрет можно стереть. 
*порт* - SIP порт клиента. 5060 по умолчанию.
*макс.одновременных звонков* - значение максимально допустимого количества одновременных звонков через этого оригинатора по протоколу SIP.
*режим DTMF* - описывает в каком режиме принимать DTMF от оригинатора.

* _авто_ - система сама определит необходимый режим.
* _RFC 2833_ - режим мередачи DTMF по рекомендации 2833.
* _инфо_ - режим передачи DTMF посредством SIP сообщений  INFO.
* _в медиа_ - режим при котором DTMF передается в медиа потоке кодеком G.711.

*прогресс в медиа* - значения: да/нет/никогда, по умолчанию: никогда. Должна ли система генерировать самостоятельно звуковой сигнал вызова для вызывающего абонента (in-band ringing). Используйте значение 'never', чтобы никогда не производилась генерация этого сигнала, даже в случае, когда некоторые странные устройства не могут генерировать его самостоятельно.

h2. Приоритет транспорта

!sip_parameters1.gif!

h2. RTP

!sip_parameters2.gif!

*может делать re-INVITE*
 
* _да_ - разрешает установление прямого RTP соединения, посредством re-INVITE.
* _нет_ - система блокирует отправку сообщений re-INVITE, когда соединение уже установлено. Эта опция не отключает ВСЕ re-INVITE, она только подразумевает контроль генераций re-INVITE-ов для специфических потребностей установления прямого RTP соединения.
* _не NAT_ - запрещает re-INVITE когда NAT=да.
* _обновление_ - использовать UPDATE вместо INVITE.

*постоянный SSRC* - эта опция контролирует смену SSRC в RTP потоке после того, как медиа начало обрабатываться модулем Медиа прокси. Нужна для совместимости с некоторому шлюзами (в частности, Huawei).
*таймаут RTP* - прерывать вызов, если нет активности RTP медиапотока более чем указанного количества секунд и если линия не находиться в режиме удержания (hold). 
*поддержка видео* - параметр для включения поддержки SIP видео.
*макс. видео битрейт* - максимальный битрейт для видео в kbit/s.
*быстрый RTP прокси* - активируется модуль RTP  +Медиа Прокси+ для этого оригинатора

h2. Факс

!sip_parameters3.gif!

*T38 UDPTL* - включить/выключить поддержку T.38 для данного оригинатора.
*использовать сокет RTP для Т.3*8 - включить/выключить отправку Т.38 на тот же порт что и RTP. Может понадобится если оборудование оригинатора находится за NAT.
*распозновать факс*  
*быстрый UDPTL прокси* - активируется модуль UDPTL  +Медиа Прокси+ для этого оригинатора

h2. NAT

!sip_parameters4.gif!

*NAT*

* _да_ - изменяет образ действия системы для клиентов находящихся за файрволом с трансляцией адресов (NAT).Эта опция заставляет систему игнорировать информацию об адресах, содержащуюся в полях SIP и SDP, и она будет отправлять ответы на тот IP адрес и порт, с которого приходит запрос.
* _нет_ - работа системы в обычном режиме
* _никогда/маршрут_ - нужны для решения проблемы, когда некоторые SIP UA не могут корректно обработать дополнительное поле "rport" в заголовках SIP сообщений (смотри RFC3581), один из таких клиентов - это SIP телефон "Uniden UIP200", для которых должен быть создан параметр nat=маршрут.

*период NAT qualify* - система периодически будет отправлять SIP сообщение типа OPTIONS, для проверки, что данный оригинатор работает и доступен для совершения вызовов. Если данный оригинатор, не ответит в течении заданного периода (или периода по умолчанию) в миллисекундах, тогда система рассматривает это устройство как выключенное и недоступное для совершения вызовов.
Эта функциональность также может использоваться для сохранения открытой UDP сессии с устройством, которое находиться за сервером с трансляцией IP адресов (NAT). С помощью периодической отправки SIP сообщений OPTIONS, мы будем продлевать время жизни записи в таблице трансляции IP адресов, для нашего UDP соединения через NAT. Это время жизни будет продлеваться, когда присутствует трафик между нашим сервером и устройством, которое находиться по ту сторону NAT. Если же время жизни этой записи истечет, тогда запросы, отправляемые с нашего сервера, просто не дойдут до SIP устройства, потому что NAT сервер уже не будет знать, как ему обратно оттранслировать IP адреса.
Этот режим используется совместно с установленным параметром NAT=да.

h2. Регистрация

!sip_parameters5.gif!

*включен* - включает отправку сообщений REGISTER на удаленное оборудование указаное в "хост". Состояние регистрации на удаленном оборудовании можно посмотреть в меню "Текущее состояние" >> SIP реестр.
*хост* - адрес оборудования на котором нужно регестрироваться.
*порт* - на какой номер порта посылать запросы на регистрацию на сервер указанный в "хост". По умолчанию - 5060 
*имя пользователя* -идентификатор пользователя, используемый для SIP сервера.
*домен* - установка домена по умолчанию в поле From:, SIP сообщений, когда происходит вызов с использованием этой записи. 
*имя пользователя для аутентификации* - не обязательное имя пользователя для авторизации на SIP сервере.
*пароль* - пароль для авторизации.
*расширение* - поле служит для указания номера который удаленный сервер (на котором зарегистрировался SmartSwitch) будет вставлять в INVITE. Данная опция полезна когда используется DID.

h2. Безопасность

!sip_parameters6.gif!

*неразборчивое перенаправление* - необходимо включить только в том случае, если нужно чтобы система реагировала на SIP сообщения "302 Moved Temporarely". 
Это может понадобится при подключении к кластеру, который осуществляет балансировку нагрузки по нескольким узлам сигнализации с помощью SIP сообщения "302 Moved Temporarely".
*разрешить перевод* - разрешить или запретить перевод (Transfer) вызова для этого оригинатора. 

h2. Протокол

!sip_parameters7.gif!

*доверять RPID* - если включено, то полученному значению Remote-Party-ID можно доверять. 
*презентация звонящего* - установка метода презентации звонящего номера.
*таймер Т1 (мс)* - время на протяжении которого будет ожидаться ответ на первый INVITE, после повторной пересылки время ожидания будет 2*T1, после третьей пересылки время ожидания будет 3*Т1 и т.д. Значение по умолчанию 500мс. Мы не рекомендуем изменять значение по умолчанию.
*причина отбоя Q.850* - поддержка ISDN кодов отбоя в пакетах SIP

h2. Таймеры сессии

Сессионные таймеры служат для обрыва сессии в случае если прервался обмен keepalive сообщениями. 
Последнее может произойти, например, если произошел обрыв интернет-соединения к диалпиру. 

!sip_parameters8.gif!

*режим* 
* _отсылать_ - запрашивать и запускать session-timers
* _принимать_ - запускать session-timers только если был запрос от удаленной стороны
* _отказываться_ - никогда не запускать session-timers

*макс. интервал обновления сессии* - значение Session-Expires которое система будет предлагать удаленной стороне. Если удаленная сторона предложит больший интервал, система все равно попробует уменьшить этот интервал до указанного в этой опции.
*мин. интервал обновления сессии* - минимальное значение Session-Expires которое будет принято системой, в ином случае звонок будет отбит  422 response.
*обновитель сессии* - определяет кто будет посылать запросы на обновление сессий - UAS или UAC.

h2. Отладка

!sip_parameters9.gif!

[[Originator SIP parameters|English translation]]