В данном разделе приводится описание команд для настройки общих параметров 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 (для обеспечения совместимости с встречными системами различных производителей).
Режим передачи может быть задан на уровне домена (Pbx), группы SIP-юзеров, SIP-интерфйса (транка или юзера).
В зависимости от уровня, имеются следующие режимы:

  • default - (*не применяется к настройке на уровне домена*) - использовать режим, выставленный на уровне домена;
  • category - отправка и прием категории вызывающего абонента в отдельном SIP-заголовке Сategory инициирующего запроса INVITE, в этом случае передается категория ОКС-7 со значениями 0 – 255;
  • сpc - категория передается при помощи тега «cpc=», передаваемого в SIP-заголовке From, в этом случае передается категория АОН со значениями 1-10;
  • сpc-rus - категория передается при помощи тега «cpc-rus=», передаваемого в SIP-заголовке From, в этом случае передается категория АОН со значениями 1-10;
  • none - не передавать категорию средствами SIP.

По умолчанию используется режим category.

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"
inaccess_status_codes408, 480Список статусов SIP для определения недоступного транка (При ответе статусом из списка или не ответе на четыре OPTIONS, транк блокируется)
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. То есть, если в SIP сообщении в поле To, содержится не телефонных номер, то он будет все равно передан на ECSS-10 в исходном виде. Вендор , передающий в поле To свой URI для реализации например перехвата или иного действия будут корректно отработаны. 
Таким образом имеется поддержка для BLF Cisco , пример URI в поле To : "x-cisco-serviceuri-blfpickup-1199"
non_response_default_isup_causefalsetrue - При отбое абонента А до ответа абонента Б, в CDR записи параметр InfConnection принимает значение ISUP Cause=19 (no answer from the user) 
false - При отбое абонента А до ответа абонента Б, в CDR записи параметр InfConnection принимает значение ISUP Cause=16 (normal call clearing)
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 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]