В данном разделе приводится описание команд для настройки общих параметров SIP-протокола виртуальной АТС.

<DOMAIN> - имя виртуальной АТС.

Таблица 1 - Описание общих параметров SIP-протокола для виртуальной АТС

НазваниеЗначение по умолчаниюОписание
absence_allow_by_rfcfalse

При отсутствии поля Allow абонент поддерживает все методы:

  • true - В случае, если при установлении сессии абонент не передал поле Allow обновление сессии будет происходить посредством UPDATE
  • false - В случае, если при установлении сессии абонент не передал поле Allow обновление сессии будет происходить посредством re-INVITE
authentication_storedsМесто хранения аутентификационных данных абонентов (логин, пароль):
  • - ds - данные сохраняются на DS, в файловой системе сервера;
  • - ldap - данные сохраняются на LDAP-сервере.
auto-answer-versionAlert-Info: Auto AnswerАвтоматический ответ терминала вызываемому абоненту (позволяет средствами протокола 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 - не отправлять команду (терминал не поддерживает ни одну из реализаций авто-ответа).
category_to_sipcategory

Установка категории вызова в заголовке SIP(category | cpc | cpc-rus | none).

compact_headersdefaultИспользование краткой формы заголовков SIP:
  • - default - переход на краткую форму при отправке сообщения по UDP и превышении размера SIP MTU (параметр "mtu_size" описан ниже);
  • - force_compact - всегда отправлять в краткой форме;
  • - force_long - всегда отправлять в полной форме.
direct_early_updatefalseРазрешить отправлять UPDATE  до установления диалога (ECSS-10 не было отправлено 200 или надежного 18х).
disable_ruri_controlfalse Не проверять имя пользователя в RURI при входящих запросах с разрешенных адресов
dtmf_duration100 ms Длительность DTMF-сигнала, передаваемая в исходящем сообщении SIP INFO
dtmf_relayfalse Выбор типа MIME для передачи DTMF в теле запроса SIP INFO. При значении "true" используется тип "application/dtmf-relay", иначе "application/dtmf"
info_headertrueПередача тестового заголовка "P-Eltex-Info" в запросах протокола SIP. В заголовке "P-Eltex-Info" содержится информация об обслуживании соединения: имя ноды, внутренний интерфейс и внутренний "call reference" (если данная информация доступна):
  • - false - выключить;
  • - true - включить.
mtu_size1300SIP MTU - ограничение максимального размера датаграммы UDP-пакета в режиме "udp_prefer". При поддержке протокола ТСР SIP-сообщения с большим размером датаграммы будут передаваться по протоколу ТСР.
nit100выключеноВключение/выключение ответов 100 на не INVITE-запросы:
  • - false - выключить;
  • - true - включить.
При длительном отсутствии ответа на запрос клиентская транзакция повторяет его отправку.
Для запроса INVITE, который заведомо обрабатывается больше 200 мс. серверной стороной, обычно отправляется промежуточный ответ 100 в целях извещения клиентской транзакции, что запрос доставлен и принят к обработке, и исключения повторных запросов. Ответ 100 может не отправляться, если серверная сторона уверена в быстром другом ответе. В некоторых ситуациях другие запросы могут также иметь длительные задержки с ответами. Например, из-за перегрузки на системе запросы BYE обслуживаются длительное время. В такой ситуации для исключения повторных запросов, что в свою очередь еще больше загружает серверную сторону, могут отправляться промежуточные ответы 100. При включенной опции, если по истечении 200 мс. на сервер транзакций (уровень SIP-сервера на адаптере) не поступает ответа от приложения (уровень транслятора на адаптере), то выполняется отправка ответа 100. Не все шлюзы корректно понимают такие ответы, поэтому реализована возможность отключения данной функции.
non_telephone_number_allowfalse Разрешить трансляцию не телефонного номера в SetupInd.
remote_party_id_enableвыключеноВключение/выключение передачи заголовка Remote-Party-ID (используется в сервисе pickup):
  • - false - выключить
  • - true - включить
realm-Область аутентификации. При аутентификации (Digest-запрос) в качестве параметра "realm" используется имя виртуальной АТС. Если необходимо изменить это значение, используется параметр "realm".
silent_modefalseЗапрет отправки неуспешного ответа на запросы от неизвестных абонентов:
  • - false - выключить;
  • - true - включить.
Позволяет скрыть от незарегистрированных абонентов (злоумышленников) работу SIP-адаптера на определенном сокете.
Например, если настройка выключена, при попытке регистрации неизвестного абонента (злоумышленник) SIР-адаптер отправит фиктивный запрос аутентификации 401, а затем ответ 403 с информацией, что регистрация запрещена. А если настройка включена, ответ отправлен не будет, и злоумышленник не узнает, что на данном сокете работает SIP-сервер.
symbol_hash_as_isfalse

Передача символа '#' не в Hex-формате (%23). Значения:

  • - false - решётка передаётся в hex-формате (%23);
  • - true - решётка передаётся символом '#'.
via_use_to_checktrueЕсли в регистрируемом контакте нет параметра "transport=", определяющего, какой транспортный протокол использовать, то ограничивать список используемых при инициализации вызова к абоненту  транспортных протоколов значением, полученным из заголовка Via (например, в данном примере будет ограничено протоколом UDP Via: SIP/2.0/UDP 192.168.117.10:5060;branch=z9hG4bK-20736-83-020736):
  • - false - выключить;
  • - true - включить.

clean

Командой устанавливается значение по умолчанию для параметров SIP-протокола на уровне виртуальной АТС.

Путь команды:

/domain/<DOMAIN>/sip/properties/clean

Синтаксис:

clean [<FIELD>] [--force]

Параметры:

<FIELD> - названия параметра, для которого устанавливается значение по умолчанию, опциональный параметр. Список параметров приведен в таблице 1.

--force - выполнение команды без запроса подтверждения.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/sip/properties/clean mtu_size                
Property mtu_size values successfully restored

[exec at: 18.03.2019 21:26:53, exec time: 458ms, 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         │
├────────────────────────────┼───────────┼───────────────────────┤
│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                  │
│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│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: 02.04.2020 16:30:46, exec time: 17ms, 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: 18.03.2019 21:25:25, exec time: 350ms, nodes: sip1@ecss2]