В данном разделе приводится описание команд для настройки общих параметров SIP-протокола виртуальной АТС.
<DOMAIN> - имя виртуальной АТС.
В таблице 1 приведено описание общих параметров SIP-протокола.
Таблица 1 - Описание общих параметров SIP-протокола
| Название | Значение по умолчанию | Описание |
|---|---|---|
| authentication_store | ds | Место хранения аутентификационных данных абонентов (логин, пароль): - ds - данные сохраняются на DS, в файловой системе сервера; - ldap - данные сохраняются на LDAP-сервере. |
| auto-answer-version | Alert-Info: Auto Answer | Автоматический ответ терминала вызываемому абоненту (позволяет средствами протокола SIP установить диалог, не дожидаясь ответа стороной Б). Значения: - rfc5373 - заголовки Auto-Answer: auto, Require: answermode (терминалы, поддерживающие RFC5373);- broadsoft - заголовок Call-Info: <sip:'outgoing_ip'>; answer-after=0 (Broadsoft, Snom);- linksys - заголовок Call-Info: =\; answer-after=0 (Lynksys);- polycom - заголовок Alert-Info: Auto Answer (Polycom) ;- aastra - заголовок Alert-Info: info=alert-autoanswer (Aastra);- none - не отправлять команду (терминал не поддерживает ни одну из реализаций авто-ответа). |
| compact_headers | default | Использование краткой формы заголовков SIP: - default - переход на краткую форму при отправке сообщения по UDP и превышении размера SIP MTU (параметр "mtu_size" описан ниже); - force_compact - всегда отправлять в краткой форме; - force_long - всегда отправлять в полной форме. |
| disable_ruri_control | false | Не проверять имя пользователя в RURI при входящих запросах с разрешенных адресов |
| info_header | true | Передача тестового заголовка "P-Eltex-Info" в запросах протокола SIP. В заголовке "P-Eltex-Info" содержится информация об обслуживании соединения: имя ноды, внутренний интерфейс и внутренний "call reference" (если данная информация доступна): - false - выключить; - true - включить. |
| mtu_size | 1300 | SIP MTU - ограничение максимального размера датаграммы UDP-пакета в режиме "udp_prefer". При поддержке протокола ТСР SIP-сообщения с большим размером датаграммы будут передаваться по протоколу ТСР. |
| nit100 | выключено | Включение/выключение ответов 100 на не INVITE-запросы: - false - выключить; - true - включить. При длительном отсутствии ответа на запрос клиентская транзакция повторяет его отправку. Для запроса INVITE, который заведомо обрабатывается больше 200 мс. серверной стороной, обычно отправляется промежуточный ответ 100 в целях извещения клиентской транзакции, что запрос доставлен и принят к обработке, и исключения повторных запросов. Ответ 100 может не отправляться, если серверная сторона уверена в быстром другом ответе. В некоторых ситуациях другие запросы могут также иметь длительные задержки с ответами. Например, из-за перегрузки на системе запросы BYE обслуживаются длительное время. В такой ситуации для исключения повторных запросов, что в свою очередь еще больше загружает серверную сторону, могут отправляться промежуточные ответы 100. При включенной опции, если по истечении 200 мс. на сервер транзакций (уровень SIP-сервера на адаптере) не поступает ответа от приложения (уровень транслятора на адаптере), то выполняется отправка ответа 100. Не все шлюзы корректно понимают такие ответы, поэтому реализована возможность отключения данной функции. |
| remote_party_id_enable | выключено | Включение/выключение передачи заголовка Remote-Party-ID (используется в сервисе pickup): - false - выключить - true - включить |
| realm | - | Область аутентификации. При аутентификации (Digest-запрос) в качестве параметра "realm" используется имя виртуальной АТС. Если необходимо изменить это значение, используется параметр "realm". |
| silent_mode | false | Запрет отправки неуспешного ответа на запросы от неизвестных абонентов: - false - выключить; - true - включить. Позволяет скрыть от незарегистрированных абонентов (злоумышленников) работу SIP-адаптера на определенном сокете. Например, если настройка выключена, при попытке регистрации неизвестного абонента (злоумышленник) SIР-адаптер отправит фиктивный запрос аутентификации 401, а затем ответ 403 с информацией, что регистрация запрещена. А если настройка включена, ответ отправлен не будет, и злоумышленник не узнает, что на данном сокете работает SIP-сервер. |
| sip_transport | udp_prefer | Транспортный режим: - tcp - создается только TCP-сокет, адаптер принимает и передает SIP-сообщения только по протоколу TCP; - udp - создается только UDP-сокет, адаптер принимает и передает SIP-сообщения только по протоколу UDP; - tcp_prefer - создаются TCP и UDP-сокеты, адаптер принимает SIP-сообщения по обоим протоколам, передача инициирующих SIP-запросов выполняется по протоколу TCP; - udp_prefer - создаются TCP и UDP-сокеты, адаптер принимает SIP-сообщения по обоим протоколам, передача инициирующих SIP-запросов выполняется по протоколу UDP. Передача запросов, в рамках уже установленного диалога, выполняется по протоколу, по которому было инициировано соединение. |
| via_use_to_check | true | Если в регистрируемом контакте нет параметра "transport=", определяющего, какой транспортный протокол использовать, то ограничивать список используемых транспортных протоколов значением, полученным из заголовка Via (например, в данном примере будет ограничено протоколом UDP Via: SIP/2.0/UDP 192.168.117.10:5060;branch=z9hG4bK-20736-83-020736): - false - выключить; - true - включить. |
| dtmf_duration | 100 | Длительность DTMF-сигнала, передаваемая в исходящем сообщении SIP INFO |
| dtmf_relay | false | Выбор типа MIME для передачи DTMF в теле запроса SIP INFO. При значении "true" используется тип "application/dtmf-relay", иначе "application/dtmf" |
| symbol_hash_as_is | false | Передача символа '#' не в Hex-формате (%23). Значения: - false - решётка передаётся в hex-формате (%23); - true - решётка передаётся символом '#'. |
clean
Командой устанавливается значение по умолчанию для параметров SIP-протокола на уровне виртуальной АТС.
Путь команды:
domain/<DOMAIN>/sip/properties/clean
Синтаксис:
clean [<FIELD>]
Параметры:
<FIELD> - названия параметра, для которого устанавливается значение по умолчанию, опциональный параметр. Список параметров приведен в таблице 1.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/sip/properties/clean auto_answer_version Property auto_answer_version values successfully restored [exec at: 27.09.2018 21:23:06, exec time: 347ms, nodes: sip1@ecss1]
info
Команда просмотра настроек SIP-протокола на уровне виртуальной АТС.
Путь команды:
domain/<DOMAIN>/sip/properties/info
Синтаксис:
info [<FIELD>]
Параметры:
<FIELD> - названия параметра, опциональный параметр. Список параметров приведен в таблице 1.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/sip/properties/info ┌──────────────────────┬───────────┬───────────────────────┐ │ Property │ Domain │ Value │ ├──────────────────────┼───────────┼───────────────────────┤ │authentication_store │biysk.local│ds │ │auto_answer_version │biysk.local│Alert-Info: Auto Answer│ │compact_headers │biysk.local│default │ │dtmf_duration │biysk.local│100 │ │dtmf_relay │biysk.local│false │ │info_header │biysk.local│true │ │mtu_size │biysk.local│1300 │ │nit100 │biysk.local│false │ │realm │biysk.local│ │ │remote_party_id_enable│biysk.local│false │ │silent_mode │biysk.local│false │ │sip_transport │biysk.local│udp_only │ │symbol_hash_as_is │biysk.local│false │ │via_use_to_check │biysk.local│false │ └──────────────────────┴───────────┴───────────────────────┘ [exec at: 27.09.2018 21:06:00, exec time: 16ms, nodes: sip1@ecss1]
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: 27.09.2018 21:21:42, exec time: 323ms, nodes: sip1@ecss1]