/domain/<DOMAIN>/sip/properties/ - команды настройки свойств SIP-протокола для виртуальной АТС
В данном разделе приводится описание команд для настройки общих параметров SIP-протокола виртуальной АТС.
<DOMAIN> - имя виртуальной АТС.
Таблица 1 - Описание общих параметров SIP-протокола для виртуальной АТС
Название | Значение по умолчанию | Описание |
---|---|---|
absence_allow_by_rfc | false | При отсутствии поля Allow абонент поддерживает все методы:
|
authentication_store | ds | Место хранения аутентификационных данных абонентов (логин, пароль):
|
auto-answer-version | Alert-Info: Auto Answer | Автоматический ответ терминала вызываемому абоненту (позволяет средствами протокола SIP установить диалог, не дожидаясь ответа стороной Б). Значения:
|
category_to_sip | category | Выбор режима передачи категории вызывающей стороны средствами протокола SIP (для обеспечения совместимости с встречными системами различных производителей).
По умолчанию используется режим category. |
compact_headers | default | Использование краткой формы заголовков SIP:
|
direct_early_update | false | Разрешить отправлять UPDATE до установления диалога (ECSS-10 не было отправлено 200 или надежного 18х). |
disable_ruri_control | false | Не проверять имя пользователя в RURI при входящих запросах с разрешенных адресов |
dtmf_duration | 100 ms | Длительность DTMF-сигнала, передаваемая в исходящем сообщении SIP INFO |
dtmf_relay | false | Выбор типа MIME для передачи DTMF в теле запроса SIP INFO. При значении "true" используется тип "application/dtmf-relay", иначе "application/dtmf" |
inaccess_status_codes | 408, 480 | Список статусов SIP для определения недоступного транка (При ответе статусом из списка или не ответе на четыре OPTIONS, транк блокируется) |
info_header | true | Передача тестового заголовка "P-Eltex-Info" в запросах протокола SIP. В заголовке "P-Eltex-Info" содержится информация об обслуживании соединения: имя ноды, внутренний интерфейс и внутренний "call reference" (если данная информация доступна):
|
mtu_size | 1300 | SIP MTU - ограничение максимального размера датаграммы UDP-пакета в режиме "udp_prefer". При поддержке протокола ТСР SIP-сообщения с большим размером датаграммы будут передаваться по протоколу ТСР. |
nit100 | выключено | Включение/выключение ответов 100 на не INVITE-запросы:
Для запроса INVITE, который заведомо обрабатывается больше 200 мс. серверной стороной, обычно отправляется промежуточный ответ 100 в целях извещения клиентской транзакции, что запрос доставлен и принят к обработке, и исключения повторных запросов. Ответ 100 может не отправляться, если серверная сторона уверена в быстром другом ответе. В некоторых ситуациях другие запросы могут также иметь длительные задержки с ответами. Например, из-за перегрузки на системе запросы BYE обслуживаются длительное время. В такой ситуации для исключения повторных запросов, что в свою очередь еще больше загружает серверную сторону, могут отправляться промежуточные ответы 100. При включенной опции, если по истечении 200 мс. на сервер транзакций (уровень SIP-сервера на адаптере) не поступает ответа от приложения (уровень транслятора на адаптере), то выполняется отправка ответа 100. Не все шлюзы корректно понимают такие ответы, поэтому реализована возможность отключения данной функции. |
non_telephone_number_allow | false | Разрешить трансляцию не телефонного номера в SetupInd. То есть, если в SIP сообщении в поле To, содержится не телефонных номер, то он будет все равно передан на ECSS-10 в исходном виде. Вендор , передающий в поле To свой URI для реализации например перехвата или иного действия будут корректно отработаны. Таким образом имеется поддержка для BLF Cisco , пример URI в поле To : "x-cisco-serviceuri-blfpickup-1199" |
non_response_default_isup_cause | false | true - При отбое абонента А до ответа абонента Б, в CDR записи параметр InfConnection принимает значение ISUP Cause=19 (no answer from the user) false - При отбое абонента А до ответа абонента Б, в CDR записи параметр InfConnection принимает значение ISUP Cause=16 (normal call clearing) |
realm | - | Область аутентификации. При аутентификации (Digest-запрос) в качестве параметра "realm" используется имя виртуальной АТС. Если необходимо изменить это значение, используется параметр "realm". |
silent_mode | false | Запрет отправки не успешного ответа на запросы от неизвестных абонентов:
Например, если настройка выключена, при попытке регистрации неизвестного абонента (злоумышленник) SIР-адаптер отправит фиктивный запрос аутентификации 401, а затем ответ 403 с информацией, что регистрация запрещена. А если настройка включена, ответ отправлен не будет, и злоумышленник не узнает, что на данном сокете работает SIP-сервер. |
symbol_hash_as_is | false | Передача символа '#' не в Hex-формате (%23). Значения:
|
via_use_to_check | true | Если в регистрируемом контакте нет параметра "transport=", определяющего, какой транспортный протокол использовать, то ограничивать список используемых при инициализации вызова к абоненту транспортных протоколов значением, полученным из заголовка Via (например, в данном примере будет ограничено протоколом UDP Via: SIP/2.0/UDP 192.168.117.10:5060;branch=z9hG4bK-20736-83-020736):
|
clean
Командой устанавливается значение по умолчанию для параметров SIP-протокола на уровне виртуальной АТС.
Путь команды:
/domain/<DOMAIN>/sip/properties/clean
Синтаксис:
clean [<FIELD>] [--force]
Параметры:
<FIELD> - названия параметра, для которого устанавливается значение по умолчанию, опциональный параметр. Список параметров приведен в таблице 1.
--force - выполнение команды без запроса подтверждения.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/properties/clean auto-answer-version Property auto-answer-version values successfully restored [exec at: 12.03.2021 14:04:24, exec time: 178ms, nodes: sip1@ecss2 v.3.14.8.26]
info
Команда просмотра настроек SIP-протокола на уровне виртуальной АТС.
Путь команды:
/domain/<DOMAIN>/sip/properties/info
Синтаксис:
info [<FIELD>]
Параметры:
<FIELD> - названия параметра, опциональный параметр. Список параметров приведен в таблице 1.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/properties/info ┌────────────────────────────┬───────────┬───────────────────────┐ │ Property │ Domain │ Value │ ├────────────────────────────┼───────────┼───────────────────────┤ │absence_allow_by_rfc │biysk.local│false │ │authentication_store │biysk.local│ds │ │auto-answer-version │biysk.local│Alert-Info: Auto Answer│ │category_to_sip │biysk.local│category │ │compact_headers │biysk.local│default │ │direct_early_update │biysk.local│false │ │disable_ruri_control │biysk.local│false │ │dtmf_duration │biysk.local│100 │ │dtmf_relay │biysk.local│false │ │inaccess_status_codes │biysk.local│408, 480 │ │info_header │biysk.local│true │ │messages_localization_enable│biysk.local│false │ │mtu_size │biysk.local│1300 │ │nit100 │biysk.local│false │ │non_telephone_number_allow │biysk.local│false │ │realm │biysk.local│ │ │remote_party_id_enable │biysk.local│false │ │silent_mode │biysk.local│false │ │symbol_hash_as_is │biysk.local│false │ │via_use_to_check │biysk.local│false │ └────────────────────────────┴───────────┴───────────────────────┘ [exec at: 21.01.2022 15:04:44, exec time: 35ms, nodes: sip1@ecss1 v.3.14.10.194]
set
Командой выполняются настройки параметров SIP-протокола на уровне виртуальной АТС.
Путь команды:
/domain/<DOMAIN>/sip/properties/set
Синтаксис:
set <FIELD> <VALUE>
Параметры:
<FIELD> - названия параметра, список параметров приведен в таблице 1;
<VALUE> - значение параметра.
Примеры:
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/properties/set auto-answer-version alert-info template: "info=alert-autoanswer" Property "auto-answer-version" successfully changed from: Alert-Info: Auto Answer to Alert-Info: info=alert-autoanswer. [exec at: 12.03.2021 14:00:29, exec time: 166ms, nodes: sip1@ecss1 v.3.14.8.26]
admin@mycelium1@ecss1:/$ domain/biysk.local/sip/properties/set inaccess_status_codes add 503 Property "inaccess_status_codes" successfully changed from: 408, 480 to 408, 480, 503. [exec at: 21.01.2022 15:11:36, exec time: 249ms, nodes: sip1@ecss1 v.3.14.10.194]