Приложение Б. Набор параметров интерфейса SIP

Отправка предупреждений при переходе интерфейса в неактивное состояние. 

Для транков: если включена опция периодического опроса (см. настройку options_control);

Для абонентов: после окончания регистрации (настраивается для группы абонентов);

Значения:

• true — отправка оповещения включена;
• false — отправка оповещения выключена.

Автоматический ответ терминала вызываемому абоненту (позволяет средствами протокола 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 — не отправлять команду (терминал не поддерживает ни одну из реализаций авто-ответа).

Выбор режима передачи категории вызывающей стороны средствами протокола 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.

Подмена 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.

Значения:

• add — добавить;
• remove — удалить;
• channel_range — диапазон каналов;
• contact_range — диапазон контактов.

• none — стандартная работа без специфичных опций;
• auto — клиентский терминал определяется в ходе процедуры регистрации по заданным правилам ;
• ИМЯ_ПРОФИЛЯ — прямое назначение профиля или выбор предустановленного.

• default — автоматический выбор;
• true — всегда использовать компактную форму;
• false — всегда использовать полную форму.

Кодирование тела SIP-запроса (ответа).
В текущей версии ПО поддерживается только один формат кодирования.

Значения:

• gzip — кодирование (сжатие) в формате ZIP;
• none — кодирование не используется.

• true — проверка включена;
• false — проверка выключена.

• all-contacts — одновременный запрос на все контакты;
• find-me-one-by-one — последовательный перебор контактов по списку;
• find-me-with-q — последовательный перебор с учетом приоритета;
• disable — отключение исходящего форкинга.

Allow-repeat-ip — разрешить перезапись контактов с одного IP адреса, но разных портов:

• allow-repeat-ip — существующий контакт будет сохраняться;
• disallow-repeat-ip — существующий контакт будет перезаписываться.

При последовательном переборе контактов (режимы find-me) возможно переключение: 

• previous-continue — при переходе к следующему контакту вызов предыдущего продолжается;
• previous-stop — при переходе к следующему контакту вызов предыдущего отменяется.

host-to-invite

registered-domain — в исходящем INVITE в заголовке To используется домен, полученный в запросе регистрации.

sip-domain — в исходящем INVITE в заголовке To используется SIP-домен пользователя.

• false — авторизация не требуется;
• true — авторизация необходима.

Состояние интерфейса в данный момент.

Значения:

• true — интерфейс активен (направление доступно или абонент зарегистрирован);
• false — интерфейс неактивен (определено автоматически или интерфейс выведен из работы целенаправленно). Служебный параметр.

Поддержка сообщения CCL ISUP-R.

При отбое со стороны вызывающего абонента (далее абонента А) на сторону вызываемого абонента (далее абонента Б) 
вместо SIP/BYE уходит SIP/INFO с инкапсулированным ISUP-R/CCL.

Актуально только для режимов с инкапсуляцией ISUP (см. настройку mode).

Значения:

• true — отправка CCL включена;
• false — отправка CCL выключена.

• см. 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) равнозначны.

Отправка запросов на номер массовой рассылки.

Значения:

• адрес сервера массовой рассылки;
• "none" (обычная работа — отправка на прямой адрес).

• sip-proxy — направление на SIP (прокси,RFC 3261 );
• sip-t — направление на SIP-T (RFC 3372);
• sip-i — направление на SIP-I (ITU Q.1912-5;
• sip-q — направление на QSIG.

Назначается для групп транков или абонентов. Назначение исходящего адреса, отличного от локального хоста. 

Необходимо для обеспечения возможности установки в заголовок "From" (при исходящих запросах на данную транковую группу или абонентов) 
коллективного адреса нод кластера. 

Значения: 

• коллективное доменное имя кластера;
• кастомное имя, из списка public_names (определяется на уровне параметров домена);
• default — использовать локальное имя хоста, назначенного параметром конфигурации sip.transport/my_sip_address.

Периодический контроль доступности направления (транка или контактов юзера).

При включении данной опции на транк с заданным интервалом отправляется запрос "SIP/OPTIONS". Если ответа не получено, то направление (контакт) переводится в неактивное состояние и шлется соответствующий alarm (см. настройку alarm_enable).

При этом периодический опрос не прекращается. При получении ответа направление (контакт) возвращается (если было неактивно) в активное состояние. Если опция выключена, то контроля доступности нет — считаем направление (контакт) доступным Кроме проверки доступности, результатом запроса "OPTIONS" является информация о параметрах встречной стороны, например, поддержка 100rel (надежная доставка предварительных ответов), timers (session-expire по RFC 4028).

Переопределение КПВ.

где MODE:

• always — будет генерироваться всегда локальный КПВ
• early-media — генерация КПВ на получение 180+SDP (Переопределение early-media)
• ringing — генерация КПВ на получение 180
• none — нет переопределения

Если данное свойство выставлено на интерфейсе, и произошел вызов на транк, то будет КПВ будет переопределяться.

Использование расширенной QOP-авторизации (повышенный уровень защиты).

Значения:

• true — опция включена;
• false — опция выключена.

Описание параметров удаленной стороны.

Формат: {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).

Служебный параметр формируется автоматически при декларации или смене одного из параметров.

Включение инкапсуляции ISUP/REL в "SIP/CANCEL". Актуально для режимов с инкапсуляцией ISUP (см. настройку mode).
В зависимости от сети, на которой установлен SSW, либо от встречной стороны инкапсуляция может требоваться или быть неподдерживаемой.

Значения:

• false — "CANCEL" без инкапсуляции ISUP/REL;
• true — "CANCEL" с инкапсуляцией ISUP/REL.

• coral — Поддержка сервера CORAL;
• default — стандартная работа.

• rpi — REMOTE-PARTY-ID;
• pai — P-ASSERTED-IDENTITY;
• both — одновременное включение REMOTE-PARTY-ID и P-ASSERTED-IDENTITY;
• none.

Тип удаленной сети. Используется для определения инициатора разъединения, в частности, при инкапсуляции ISUP/REL.

Значения:

• private;
• local;
• transit;
• international.

Требование надежных промежуточных ответов. Надежность обеспечивается 
отправкой запроса "PRACK" в ответ на соответствующий 1хх (RFC 3262).

Значения:

• true — при отправке ответов группы 1хх включать "Require: 100rel";
• false — требование надежности не отправляется;
• supported — требование надежности не отправляется. 

Удаленная сторона поддерживает данную опцию, 
но требование надежности ему не отправляется;

• unsupported — требование надежности не отправляется. 

Удаленная сторона не поддерживает данную опцию, но при настройке было задано "требовать надежность". 

В этом случае требование отправляться не будет, но если в дальнейшем (например, после очередного ответа на "OPTIONS") определится поддержка, то требование начнет ставиться, в этом случае данный параметр поменяет значение на "true".

Поддержка контроля сессии по RFC 4028, даже в случае, если удаленная сторона его не поддерживает. К настройке доступны значения "true" и "false".

Значения:

• true — включено. Обновление сессии производится только в случае если встречная сторона поддерживает timer;
• false — выключено;
• force — включено. Обновление сессии производится не зависимо от поддержки timer встречной стороной.

Настройка актуальна для динамического транка. Позволяет подставлять в Request-URI информацию из поля Contact, полученную при регистрации.

Значения:

• true;
• false.

Настройка модификации заголовков 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 — вставить текст вместо удаленного предыдущей командой.

При звонке SIP/SIP есть возможность транзита отдельных заголовков

Формат: 

• sip-transit set PARAMETERS SET key1 = val1, key2 = val2, ...

Параметры:

• headers = [HEADER1, HEADER2, ...] — транзит SIP заголовков в исходящих запросах и ответах на вторую сторону;
• clean — сброс всех настроек транзита.

• имя домена;
• "undefined".

Отображение Display Name в зависимости от типа кодировки

Значения:

• utf-8 — использование кодировки UTF-8 для данного абонента;
• latin1 — использование кодировки latin1 для данного абонента;
• cp1251 — использование кодировки cp1251 для данного абонента.

• false — решётка передаётся в hex-формате (%23);
• true — решётка передаётся символом '#'.