В данном разделе описываются параметры SIP-интерфейсов.
Различают:
параметры SIP-транка (TR) - просмотр и установка командами /domain/DOMAIN/trunk/sip/...
параметры локального SIP-абонента (SUB) - - просмотр и установка командами /domain/DOMAIN/sip/user/...Пометка "info" означает что параметр не имеет возможности настройки командами адаптера (формируется на основе других параметров или внешних воздействий/событий).Пометка "rt" означает realm-time параметр, не имеющий хранения в общей базе интерфейсов.
При отображении значения, все значения параметров приводятся к "читаемому" виду адаптером.В "сыром" виде, хранимом в базе, значениями параметров можно оперировать командами /domain/DOMAIN/iface/...Если рабочее имя параметра отличается от хранимого в базе, что второе указывается дополнительно в скобках.Следует иметь ввиду, что хранимое в базе значение может отличаться от текущего. Работа с параметрами интерфейса напрямую (не через команды адаптера) допускается лишь в случаях крайней необходимости: устранение аварий, временное решение каких-либо проблем или ошибок.Также может отличаться состав параметров. Так не все рабочие параметры могут быть отображены в базе (в частности, параметры, используемые "по умолчанию"). Или в базе могут присутствовать устаревшие параметры (не всегда импорт данных при переходе на новую версию может автоматически зачистить неиспользуемые данные).
Примечание. Если в таблице не указано значение по умолчанию ("-"), то значение по умолчанию не определено и устанавливается протокол-адаптером SIP.
Таблица 1 – Описание параметров SIP-интерфейса
Название параметра |
Тип |
Описание |
Значение по умолчанию |
||
alarm_enable |
TR, SUB |
Отправка предупреждений при переходе интерфейса в неактивное состояние. Для транков: если включена опция периодического опроса (см. настройку options_control); Для абонентов: после окончания регистрации (настраивается для группы абонентов);Значения:- true - отправка оповещения включена;- false - отправка оповещения выключена. |
true |
||
alias (aliases_list) |
SUB |
Cписок алиасов, если пользователь был задекларирован с логическим, а не цифровым номером |
- |
||
aliases activities |
SUB (info) |
Cписок алиасов с указанием их состояния |
- |
||
allow |
SUB (info,rt) |
Параметр хранит для абонента запросы, поддерживаемые пользовательским шлюзом, которые были получены в запросе регистрации (используется, чтобы знать, чем отправить запрос "check OPTIONS" или "INVITE"). Устанавливается протокол-адаптером SIP. |
- |
||
allow events |
SUB (info) |
Расширения (Allow-Events), поддерживаемые терминалом SIP-пользователя |
- |
||
authentication |
SUB (info) |
Параметры аутентификации SIP-пользователя: логин, пароль, требование qop |
none |
||
auto-answer-version |
SUB |
Автоматический ответ терминала вызываемому абоненту (позволяет средствами протокола SIP установить диалог, не дожидаясь ответа стороной Б).Значения:- default - используется настройка на уровне виртуальной АТС;- answermode - заголовки Auto-Answer: auto, Require: answermode (терминалы, поддерживающие RFC5373);- сall-info - шаблон заголовка Call-Info: <sip:PBX_NAME>; answer-after=0 (Broadsoft, Yealink, Snom);- call-info - шаблон заголовка Call-Info: =\; answer-after=0 (Lynksys, Yealink);- call-info - по необходимости возможна строка в произвольном формате;- alert-info - шаблон заголовка Alert-Info: Auto Answer (Polycom, Yealink);- alert-info - шаблон заголовка Alert-Info: info=alert-autoanswer (Aastra);- alert-info - по необходимости возможна строка в произвольном формате;- none - не отправлять команду (терминал не поддерживает ни одну из реализаций авто-ответа). |
Alert-Info: Auto Answer |
||
cdpn-transformation |
TR |
Подмена CDPN в сообщении SetupInd от SIP-адаптера к ядру значением из ACDPN или RedirectingЗначения:- none - не изменять;- by-redirection - подмена номера из Redirecting Number;- by-generic-cdpn - подмена из Generic Number, имеющего Number qualifier indicator = 00000001 additional called number; - by-generic - подмена из Generic Number, имеющего любой Number qualifier indicator. |
none |
||
client-profile |
SUB |
Идентификатор профиля SIP-клиента. Позволяет включать опции специфичные терминалам конкретного производителя или модели (см.настройку профиля абонентов SIP)- none - стандартная работа без специфичных опций- auto - клиентский терминал определяется в ходе процедуры регистрации по заданным правилам - ИМЯ_ПРОФИЛЯ - прямое назначение профиля или выбор предустановленного |
none |
||
compact-form |
TR, SUB |
Использование SIP-заголовков компактной формы.- default - автоматический выбор;- true - всегда использовать компактную форму;- false - всегда использовать полную форму. |
- |
||
connect time |
TR (info) |
Время последнего соединения с транком (либо после пропадания ответов на периодический опрос доступности, либо с момента старта или декларации |
- |
||
contacts definition |
SUB (info,rt) |
Список зарегистрированных контактов с сопутствующей им информацией: время истечения регистрации, локальная точка регистрации, заголовков Via, User-Agetnt |
- |
||
content_encoding |
TR |
Кодирование тела SIP-запроса (ответа).В текущей версии ПО поддерживается только один формат кодирования.Значения:- gzip - кодирование (сжатие) в формате ZIP;- none - кодирование не используется. |
none |
||
declared by |
TR, SUB (info,rt) |
Дата декларации интерфейса и оператор, выполнивший ее |
- |
||
digest |
SUB |
Требование аутнетификации. Для частной сети, при настроенных trusted-ip, аутентификация может быть излишней |
true |
||
disconnections number |
TR (info) |
Количество потерь связи с транком (прекращение ответов на периодический опрос доступности) |
- |
||
disable-remote-port-control |
TR, SUB |
Отключение проверки удаленного порта при входящем вызове от абонента. Значения:- true - проверка включена;- false - проверка выключена. |
false |
||
display-name-encoding |
|
Тип схемы для кодирования/декодирования sip url |
win1251 |
||
dtmf-duration |
TR, SUB |
Длительность DTMF-сигнала, передаваемая в исходящем сообщении SIP INFO |
100 |
||
dtmf-relay |
TR, SUB |
Выбор типа MIME для передачи DTMF в теле запроса SIP INFO. При значении "true" используется тип "application/dtmf-relay", иначе "application/dtmf" |
false |
||
fork-mode |
SUB |
Регистрация нескольких контактов SIP-абонента.- all-contacts - одновременный запрос на все контакты;- find-me-one-by-one - последовательный перебор контактов по списку;- find-me-with-q - последовательный перебор с учетом приоритета;- disable - отключение исходящего форкинга. |
disable |
||
gate |
TR, SUB (info) |
Имя инициирующей очереди и ключ маршрутизации адаптера на внутреннем транспорте (AMQP). Параметры являются служебными, назначаются всегда автоматически при декларации или регистрации в зависимости от типа транка или юзера |
- |
||
group |
TR,SUB (info) |
Группа интерфейсов, которой принадлежит SIP-пользователь |
- |
||
history_info |
TR |
Включение оригинальной информации о переадресации в заголовок History-Info в исходящий INVITE |
false |
||
host |
TR |
IP-адрес или имя хоста сервера. |
- |
||
inc_authentication |
TR |
Требование прокси авторизации со стороны транка. Принимает значения:false - авторизация не требуется;true - авторизация необходима. |
false |
||
inc_authentication_type |
TR |
Тип запроса авторизации: user - в ответе 401, proxy - в ответе 407 |
user |
||
inc_authentication_login |
TR |
Логин для входящей прокси авторизации. Используется, если требуется прокси-авторизация для транка при входящем занятии. |
- |
||
inc_authentication_password |
TR |
Пароль для входящей прокси авторизации. Используется, если требуется прокси-авторизация для транка при входящем занятии. |
- |
||
internal iface name |
SUB (info) |
Идентификатор интерфейса внутри системы |
- |
||
inc-login |
TR |
логин встречной стороны для аутентификации входящего вызова |
LOGIN |
||
inc-password |
TR |
пароль встречной стороны для аутентификации входящего вызова |
PASSWORD |
||
ip-set |
TR |
Привязка транка к локальному адресу (набору адресов). Настроенные ip-set смотри: cluster/adapter/sip1/sip/network/info |
- |
||
isActive |
TR, SUB (info) |
Состояние интерфейса в данный момент.Значения:- true - интерфейс активен (направление доступно или абонент зарегистрирован);- false - интерфейс неактивен (определено автоматически или интерфейс выведен из работы целенаправленно). Служебный параметр. |
false |
||
isup_r_ccl_send |
TR |
Поддержка сообщения CCL ISUP-R.При отбое со стороны вызывающего абонента (далее абонента А) на сторону вызываемого абонента (далее абонента Б) вместо SIP/BYE уходит SIP/INFO с инкапсулированным ISUP-R/CCL.Актуально только для режимов с инкапсуляцией ISUP (см. настройку mode).Значения:- true - отправка CCL включена;- false - отправка CCL выключена. |
false |
||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="0e4fc674-e735-442b-a027-d55e14f963dc"><ac:plain-text-body><![CDATA[ |
isup-cause-location |
TR, SUB |
Локализация транка на сети. Используется для определения инициатора разъединения, в частности, при инкапсуляции ISUP/REL. Данная локализация описана в рекомендации ITU Q.850: см. Figure 4/Q.850 – Reference configuration for location field generation см. Table 4/Q.850 – The setting of location fields by events at nodes of the reference configuration and values expected to be received by user A. Реальные значения (при отображении параметров интерфейсов):- user (U);- local_private_network (LPN);- local_network (LN);- transit_network (TN);- international_network (INTL);- remote_network (RLN);- remote_private_network (RPN); Разрешенные значения для ввода (при вводе с терминала используются сокращения):- INTL_(International_network);- LN__(Public_network_serving_the_local_user;- LPN(Private_network_serving_the_local_user;- RLN(Public_network_serving_the_remote_user;- RPN(Private_network_serving_the_remote_user;- TN_(Transit_network);- U__(User). По [TAB] параметры разворачиваются в указанном выше виде с подсказкой после символа подчеркивания. К установке применяются только первые значащие символы (до ""). Например, значения LPN и LPN__(Private_network_serving_the_local) равнозначны. |
local_network |
]]></ac:plain-text-body></ac:structured-macro> |
last via |
SUB (info) |
Информация о прохождении запроса регистрации |
- |
||
listen_port |
TR |
Порт для SIP-сигнализации с транка на стороне SSW. Если на адаптере открыто несколько слушающих портов, то можно различать транки по получению сообщений с одного адреса одной сети, но с разных портов. Номер порта всегда должен быть выбран из имеющегося списка |
- |
||
local-end-point |
TR |
Транспортные параметры включения транка на стороне CSS. Включают в себя: ip-set, listen-port, node-control. Node-control включается при необходимости обслуживания вызовов только одним определенным IP-адресом. на локальной стороне. |
|
||
maddr |
TR |
Отправка запросов на номер массовой рассылки.Значения:- адрес сервера массовой рассылки;- "none" (обычная работа - отправка на прямой адрес). |
none |
||
mode |
TR |
Режим инкапсуляции ISUP. Принимает значения:sip-proxy - направление на SIP (прокси,RFC 3261 );sip-t - направление на SIP-T (RFC 3372);sip-i - направление на SIP-I (ITU Q.1912-5;sip-q - направление на QSIG |
- |
||
my_from |
TR, SUB |
Назначение исходящего адреса, отличного от локального хоста. Необходимо для обеспечения возможности установки в заголовок "From" (при исходящих запросах) коллективного адреса нод кластера. Назначается для групп транков или абонентов.Значения: - коллективное доменное имя кластера;- default - использовать локальное имя хоста, назначенного параметром конфигурации sip.transport/my_sip_address |
default |
||
nat_traversal |
TR, SUB |
Флаг, означающий использование реального адреса назначения, вместо контакта. Для транков актуален для динамических (требующих регистрации). Значения:- true - опция включена;- false - опция выключена. |
false |
||
options_control |
TR, SUB |
Периодический контроль доступности направления (транка или контактов юзера)При включении данной опции на транк с заданным интервалом отправляется запрос "SIP/OPTIONS". Если ответа не получено, то направление (контакт) переводится в неактивное состояние и шлется соответствующий alarm (см. настройку alarm_enable). При этом периодический опрос не прекращается. При получении ответа направление (контакт) возвращается (если было неактивно) в активное состояние.Если опция выключена, то контроля доступности нет - считаем направление (контакт) доступным Кроме проверки доступности, результатом запроса "OPTIONS" является информацияо параметрах встречной стороны, например, поддержка 100rel (надежная доставка предварительных ответов), timers (session-expire по RFC 4028). |
0 |
||
original-cdpn-to |
TR |
Переключение подстановки CDPN на основе Original CDPN на основе принятых заголовков To либо Diversion |
false |
||
out_login (proxy_out_login) |
TR, SUB |
Логин для исходящей авторизации. Необходим, если встречная сторона (транк) требует авторизации исходящих от нас запросов. |
- |
||
out_password (proxy_out_password) |
TR, SUB |
Пароль для исходящей авторизации. Необходим, если встречная сторона (транк) требует авторизации исходящих от нас запросов. |
- |
||
published presence |
SUB (info) |
Состояние опубликованное терминалом SIP-пользователь (PUBLISH, Event: presence). Транслируется подписчикам услуги presence |
- |
||
port |
TR |
Порт назначения для транка |
- |
||
qop-authentication (aut_qop) |
SUB |
Использование расширенной QOP-авторизации (повышенный уровень защиты).Значения:- true - опция включена;- false - опция выключена. |
false |
||
realUri |
TR |
Описание параметров удаленной стороны.Формат: {MODE,ISUP,DEST_HOST,DEST_PORT}- MODE - режим: sipproxy, sipt (инкапсуляция ISUP по RFC 3372), sipi (инкапсуляция ISUP по ITU Q.1912-5);- ISUP - инкапсуляция ISUP: sub (без инкапсуляции), far (с инкапсуляцией);- DEST_HOST - адрес удаленной стороны (IP или доменное имя);- DEST_PORT - порт удаленной стороны (числовое значение, например, 5060).Служебный параметр формируется автоматически при декларации или смене одного из параметров. |
- |
||
referred-by-as-cgpn |
TR, SUB |
Номер и поля user заголовка Referred-By используется в качестве Cgpn при отправке в ядро SetupInd |
false |
||
register-expire-min |
SUB |
Минимальное значение периода перерегистрации. |
90 |
||
register-expire-max |
SUB |
Максимальное значение периода перерегистрации. |
3600 |
||
registrator |
SUB (info) |
Имя и транспортные параметры ноды, которой была обработана регистрация. Выставляется протокол-адаптером SIP. |
- |
||
regs_time |
SUB (info) |
Время регистрации. Устанавливается протокол-адаптером SIP. |
- |
||
rel_to_cancel |
TR |
Включение инкапсуляции ISUP/REL в "SIP/CANCEL". Актуально для режимов с инкапсуляцией ISUP (см. настройку mode).В зависимости от сети, на которой установлен SSW, либо от встречной стороны инкапсуляция может требоваться или быть неподдерживаемой.Значения:- false - "CANCEL" без инкапсуляции ISUP/REL;- true - "CANCEL" с инкапсуляцией ISUP/REL. |
false |
||
remote-client |
TR |
Выбор предустановленного профиля встречного сервера. Позволяет включать опции специфичные серверам конкретного производителя (см.настройку профиля абонентов SIP)- coral - Поддержка сервера CORAL- default - стандартная работа |
default |
||
remote-ctr-indication |
TR, SUB |
Заголовок для указания об удаленном CTR:- rpi - REMOTE-PARTY-ID- pai - P-ASSERTED-IDENTITY- both - одновременное включение REMOTE-PARTY-ID и P-ASSERTED-IDENTITY- none |
rpi |
||
remote-end-point |
TR |
Транспортные параметры включения транка на встречной стороне. Включают в себя: ip-адрес/доменное имя и порт |
|
||
remote-network-type |
TR |
Тип удаленной сети. Используется для определения инициатора разъединения, в частности, при инкапсуляции ISUP/REL.Значения:- private;- local;- transit;- international |
local |
||
req100rel |
TR |
Требование надежных промежуточных ответов. Надежность обеспечивается отправкой запроса "PRACK" в ответ на соответствующий 1хх (RFC 3262).Значения:- true - при отправке ответов группы 1хх включать "Require: 100rel";- false - требование надежности не отправляется;- supported - требование надежности не отправляется. Удаленная сторона поддерживает данную опцию, но требование надежности ему не отправляется;- unsupported - требование надежности не отправляется. Удаленная сторона не поддерживает данную опцию, но при настройке было задано "требовать надежность". В этом случае требование отправляться не будет, но если в дальнейшем (например, после очередного ответа на "OPTIONS") определится поддержка,то требование начнет ставиться, в этом случае данный параметр поменяет значение на "true". |
false |
||
rfc-4028-control |
TR, SUB |
Поддержка контроля сессии по RFC 4028, даже в случае, если удаленная сторона его не поддерживает. К настройке доступны значения "true" и "false".Значения:- true - включено. Обновление сессии производится только в случае если встречная сторона поддерживает timer;- false - выключено;- force - включено. Обновление сессии производится не зависимо от поддержки timer встречной стороной. |
true |
||
route-by-via |
TR |
Настройка актуальна для динамического транка. Позволяет подставлять в Request-URI информацию из поля Contact, полученную при регистрации.Значения:- true;- false. |
false |
||
routing.context |
TR, SUB |
Контекст маршрутизации |
- |
||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="466ca734-8dd2-44f8-bcf6-5d8a70e9706c"><ac:plain-text-body><![CDATA[ |
sip-modifications |
TR, SUB |
Настройка модификации заголовков SIP в исходящих запросах и ответах. Кроме модификации текста доступно полное исключение заголовка из сообщения.Формат: sip-modifications ignore headers = [HEADER1, HEADER2, ...] - исключение заголовка при отправке сообщения;sip-modifications set PARAMETERS SET header = HEADER, key1 = val1, key2 = val2, ... - правило модификации; sip-modifications clean HEADER - сброс модификации.Описание правил модификации:add_new = TEXT - добавить новый заголовок с TEXT;add_start = STRING - вставить текст в начало;add_end = STRING - добавить текст в конец;delete = STRING - найти и удалить указанный текст;insert = STRING - вставить текст вместо удаленного предыдущей командой. |
- |
]]></ac:plain-text-body></ac:structured-macro> |
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="bb5e3c7a-724b-4a38-a0a8-2c2ee3139695"><ac:plain-text-body><![CDATA[ |
sip-transit |
TR, SUB |
При звонке SIP/SIP есть возможность транзита отдельных заголовков а также RURIФормат: sip-transit set PARAMETERS SET key1 = val1, key2 = val2, ...Параметры:headers = [HEADER1, HEADER2, ...] - транзит SIP заголовков в исходящих запросах и ответах на вторую сторону.request_line = disable - транзит RURI выключенrequest_line = domain_name - установка доменного имени в RURI исходящего запроса из входящего, сам запрос шлется в контакт исходящего интерфейса (транка или юзера)request_line = domain_name_force - установка доменного имени в RURI исходящего запроса из входящего, сам запрос шлется также на хост, соответствующий этому имениrequest_line = ruri - полная копия исходящего RURI из входящего запроса, сам запрос шлется в контакт исходящего интерфейса (транка или юзера)request_line = ruri_force - полная копия исходящего RURI из входящего запроса, сам запрос шлется также на хост из этого RURIclean - сброс всех настроек транзита |
- |
]]></ac:plain-text-body></ac:structured-macro> |
sip_transport |
TR |
Используемый протокол при запросе в сторону транка.Значения:- system - используется протокол, установленный для кластера - udp-only, tcp-only, udp-prefer, tcp-prefer |
system |
||
sip-domain |
TR, SUB |
SIP-домен в "Request URI", заголовках From, To исходящего от нас запроса. Значения: - имя домена;- "undefined". |
- |
||
supported |
SUB (info) |
Функции (Supported), поддерживаемые терминалом SIP-пользователя |
- |
||
support_encoding |
SUB (info) |
Отображение Display Name в зависимости от типа кодировкиЗначения:- utf-8 - использование кодировки UTF-8 для данного абонента- latin1 - использование кодировки latin1 для данного абонента- cp1251 - использование кодировки cp1251 для данного абонента |
- |
||
symbol_hash_as_is |
TR, SUB |
Передача символа '#' не в Hex-формате (%23). Значения:- false - решётка передаётся в hex-формате (%23);- true - решётка передаётся символом '#'. |
false |
||
trunk |
TR |
Логическое объединение транков (направление). Необходим для группировки SIP-направлений в целях контроля, статистики, СОРМ и т.д.Значением является имя. |
- |
||
trusted-ip |
SUB |
Список доверенных IP-адресов, запросы REGISTER и INVITE, полученные с IP-адреса из этого списка, обрабатываются без аутентификации. |
none |
||
tel-uri-in-diversion |
TR, SUB |
Использование формата "tel:" вместо "sip:" в заголовке Diversion при переадресации звонка |
false |
||
uptime |
TR (info) |
Длительность последнего соединения с транком (либо после пропадания ответов на периодический опрос доступности, либо с момента старта или декларации |
- |
||
user agent |
SUB (info) |
Название терминала SIP-пользователя (User-Agent) |
- |
||
use-global-callref |
TR |
Использование GLOBAL CALL REF для ISUP-ETSI. Параметр работает для адаптации диалектов национальных стандартов ОКС-7 при пропускании международного трафика |
false |
||
user-name |
TR |
Имя юзера при исходящей регистрации транка. Если не назначено (значение none), используется имя транка |
none |
Описание параметров кластера SIP:/adapter/<CLUSTER>/properties
Описание параметров Виртуальной АТС на уровне SIP-адаптера:domain/<DOMAIN>/sip/propertiesdomain/<DOMAIN>/sip/properties_sys