В данном разделе приводится описание команд управления конфигурацией абонентов SIP.

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

Набор параметров SIP

В данном разделе описываются параметры SIP-интерфейсов.

Различают:

параметры SIP-транка (TR) — просмотр и установка командами /domain/DOMAIN/trunk/sip/...
параметры локального SIP-абонента (SUB) — просмотр и установка командами /domain/DOMAIN/sip/user/...
параметры интерфейса SIP (IF) — просмотр и установка командами /domain/DOMAIN/iface/user-set/...
Пометка "info" означает, что параметр не имеет возможности настройки командами адаптера (формируется на основе других параметров или внешних воздействий/событий).
Пометка "rt" означает realm-time параметр, не имеющий хранения в общей базе интерфейсов.

При отображении значения, все значения параметров приводятся к "читаемому" виду адаптером. В "сыром" виде, хранимом в базе, значениями параметров можно оперировать командами /domain/DOMAIN/iface/... Если рабочее имя параметра отличается от хранимого в базе, что второе указывается дополнительно в скобках.

Следует иметь ввиду, что хранимое в базе значение может отличаться от текущего. Работа с параметрами интерфейса напрямую (не через команды адаптера) допускается лишь в случаях крайней необходимости: устранение аварий, временное решение каких-либо проблем или ошибок.

Также может отличаться состав параметров. Так не все рабочие параметры могут быть отображены в базе (в частности, параметры, используемые "по умолчанию"). Или в базе могут присутствовать устаревшие параметры (не всегда импорт данных при переходе на новую версию может автоматически зачистить неиспользуемые данные).

Если в таблице не указано значение по умолчанию ("-"), то значение по умолчанию не определено и устанавливается протокол-адаптером SIP.

Таблица — Описание параметров SIP-интерфейса

Название параметра	Тип	Описание	Значение по умолчанию
access_group	TR, SUB	Группа, которая определяет правила доступа для этого пользователя	all
alarm_enable	TR, SUB	Отправка предупреждений при переходе интерфейса в неактивное состояние. Для транков/абонентов: если включена опция периодического опроса (см. настройку keep_alive_control). Значения: true — отправка оповещения включена; false — отправка оповещения выключена.	true
alias (aliases_list)	SUB	Cписок алиасов, если пользователь был задекларирован с логическим, а не цифровым номером.	-
aliases activities	SUB (info)	Cписок алиасов с указанием их состояния.	-
allow	SUB (info,rt)	Параметр хранит для абонента запросы, поддерживаемые пользовательским шлюзом, которые были получены в запросе регистрации (используется, чтобы знать, чем отправить запрос "check OPTIONS" или "INVITE"). Устанавливается протокол-адаптером SIP.	-
allow events	SUB (info)	Расширения (Allow-Events), поддерживаемые терминалом SIP-пользователя.	-
authentication	SUB (info)	Параметры аутентификации SIP-пользователя: логин, пароль, требование qop.	none
auto-answer-version	SUB	Автоматический ответ терминала вызываемому абоненту (позволяет средствами протокола 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 — не отправлять команду (терминал не поддерживает ни одну из реализаций авто-ответа).	Alert-Info: Auto Answer
category_to_sip	TR, SUB	Выбор режима передачи категории вызывающей стороны средствами протокола 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.	default
cdpn-transformation	TR	Подмена 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.	none
channel-contact-map	TR	Параметр связывает номер канала с контактом, который уже должен быть создан. Если канал не существует, то он будет создан. Значения: add — добавить; remove — удалить; channel_range — диапазон каналов; contact_range — диапазон контактов.	-
client-profile	SUB	Идентификатор профиля SIP-клиента. Позволяет включать опции специфичные терминалам конкретного производителя или модели (см. настройку профиля абонентов SIP). none — стандартная работа без специфичных опций; auto — клиентский терминал определяется в ходе процедуры регистрации по заданным правилам; ИМЯ_ПРОФИЛЯ — прямое назначение профиля или выбор предустановленного.	none
compact-form	TR, SUB	Использование SIP-заголовков компактной формы. default — автоматический выбор; true — всегда использовать компактную форму; false — всегда использовать полную форму.	-
connect time	TR (info)	Время последнего соединения с транком (либо после пропадания ответов на периодический опрос доступности, либо с момента старта или декларации.	-
contacts definition	SUB (info,rt)	Список зарегистрированных контактов с сопутствующей им информацией: время истечения регистрации, локальная точка регистрации, заголовков Via, User-Agetnt.	-
content_encoding	TR	Кодирование тела SIP-запроса (ответа). В текущей версии ПО поддерживается только один формат кодирования. Значения: gzip — кодирование (сжатие) в формате ZIP; none — кодирование не используется.	none
declared by	TR, SUB (info,rt)	Дата декларации интерфейса и оператор, выполнивший ее.	-
digest	SUB	Требование аутентификации. Для частной сети при настроенных trusted-ip аутентификация может быть излишней.	true
disconnections number	TR (info)	Количество потерь связи с транком (прекращение ответов на периодический опрос доступности).	-
disable-remote-port-control	TR, SUB	Отключение проверки удаленного порта при входящем вызове от абонента. Значения: true — проверка включена; false — проверка выключена.	false
display-name-encoding		Тип схемы для кодирования/декодирования sip url.	win1251
dtmf-duration	TR, SUB	Длительность DTMF-сигнала, передаваемая в исходящем сообщении SIP INFO.	100
dtmf-relay	TR, SUB	Выбор типа MIME для передачи DTMF в теле запроса SIP INFO. При значении "true" используется тип "application/dtmf-relay", иначе "application/dtmf".	false
expand-destinations	TR	Позволяет ввести несколько IP адресов для транка, с которых разрешается принимать входящие вызовы.	-
fork-mode	SUB	Регистрация нескольких контактов SIP-абонента. 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 — при переходе к следующему контакту вызов предыдущего отменяется.	disable
gate	TR, SUB (info)	Имя инициирующей очереди и ключ маршрутизации адаптера на внутреннем транспорте (AMQP). Параметры являются служебными, назначаются всегда автоматически при декларации или регистрации в зависимости от типа транка или юзера.	-
group	TR,SUB	Группа интерфейсов, которой принадлежит SIP-пользователь.	-
history_info	TR	Включение оригинальной информации о переадресации в заголовок History-Info в исходящий INVITE.	false
host	TR	IP-адрес или имя хоста сервера.	-
host-to-invite	SUB	registered-domain — в исходящем INVITE в заголовке To используется домен, полученный в запросе регистрации. sip-domain — в исходящем INVITE в заголовке To используется SIP-домен пользователя.	registered-domain
ice/enabled	IF	Включается, когда необходимо обеспечить корректную работу web-клиента, чтобы вызов уходил с SDP, понятным WebRTC. Значения: false — решётка передается в hex-формате (%23); true — решётка передается символом '#'. Вместе с данным параметром нужно включить nat-traversal. Данный параметр в своей работе конфликтует с core_forking, являясь менее приоритетным.
core_forking	IF	Включается, когда необходимо обеспечить одновременное использование абонентом телефонного аппарата и WebRTC-клиента, работающего по протоколу ice. На все контакты такого пользователя делаются параллельные вызовы. Контакт, ответивший раньше остальных, будет проключен с вызывающим абонентом. Данный параметр в своей работе конфликтует с ice/enabled, являясь более приоритетным.	none
inc_authentication	TR	Требование прокси авторизации со стороны транка. Принимает значения: false — авторизация не требуется; true — авторизация необходима.	false
inc_authentication_type	TR	Тип запроса авторизации: user — в ответе 401, proxy — в ответе 407.	user
inc_authentication_login	TR	Логин для входящей прокси авторизации. Используется, если требуется прокси-авторизация для транка при входящем занятии.	-
inc_authentication_password	TR	Пароль для входящей прокси авторизации. Используется, если требуется прокси-авторизация для транка при входящем занятии.	-
internal iface name	SUB (info)	Идентификатор интерфейса внутри системы.	-
inc-login	TR	логин встречной стороны для аутентификации входящего вызова.	LOGIN
inc-password	TR	пароль встречной стороны для аутентификации входящего вызова.	PASSWORD
ip-set	TR	Привязка транка к локальному адресу (набору адресов). Настроенные ip-set смотри: cluster/adapter/sip1/sip/network/info.	-
isActive	TR, SUB (info)	Состояние интерфейса в данный момент. Значения: true — интерфейс активен (направление доступно или абонент зарегистрирован); false — интерфейс неактивен (определено автоматически или интерфейс выведен из работы целенаправленно). Служебный параметр.	false
isup_r_ccl_send	TR	Поддержка сообщения CCL ISUP-R. При отбое со стороны вызывающего абонента (далее абонента А) на сторону вызываемого абонента (далее абонента Б) вместо SIP/BYE уходит SIP/INFO с инкапсулированным ISUP-R/CCL. Актуально только для режимов с инкапсуляцией ISUP (см. настройку mode). Значения: true — отправка CCL включена; false — отправка CCL выключена.	false
isup-cause-location	TR, SUB	Локализация транка на сети. Используется для определения инициатора разъединения, в частности, при инкапсуляции ISUP/REL. Данная локализация описана в рекомендации ITU Q.850: см. 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) равнозначны.	local_network
keep_alive_control	IF, TR, SUB	Периодический контроль доступности направления (транка или контактов user). При включении данной опции на транк с заданным интервалом отправляется запрос "OPTIONS/NOTIFY". Если ответа не получено, то направление (контакт) переводится в неактивное состояние и шлется соответствующий alarm (см. настройку alarm_enable). При этом периодический опрос не прекращается. При получении ответа направление (контакт) возвращается (если было неактивно) в активное состояние. Если опция выключена, то контроля доступности нет — считаем направление (контакт) доступным. доступные значения: notify - ( 0 - отключено, 32-Х интервал в сек.) options - ( 0 - отключено, 32-Х интервал в сек.)	disable (options)
last via	SUB (info)	Информация о прохождении запроса регистрации.	-
listen_port	TR	Порт для SIP-сигнализации с транка на стороне SSW. Если на адаптере открыто несколько слушающих портов, то можно различать транки по получению сообщений с одного адреса одной сети, но с разных портов. Номер порта всегда должен быть выбран из имеющегося списка.	-
local-end-point	TR	Транспортные параметры включения транка на стороне ECSS. Включают в себя: ip-set, listen-port, node-control. Node-control включается при необходимости обслуживания вызовов только одним определенным IP-адресом. На локальной стороне.
maddr	TR	Отправка запросов на номер массовой рассылки. Значения: адрес сервера массовой рассылки; "none" (обычная работа — отправка на прямой адрес).	none
mode	TR	Режим инкапсуляции ISUP. Принимает значения: sip-proxy — направление на SIP (прокси,RFC 3261 ); sip-t — направление на SIP-T (RFC 3372); sip-i — направление на SIP-I (ITU Q.1912-5; sip-q — направление на QSIG.	-
my_from	TR, SUB	Назначается для групп транков или абонентов. Назначение исходящего адреса, отличного от локального хоста. Необходимо для обеспечения возможности установки в заголовок "From" (при исходящих запросах на данную транковую группу или абонентов) коллективного адреса нод кластера. Значения: коллективное доменное имя кластера; кастомное имя, из списка public_names (определяется на уровне параметров домена); default — использовать локальное имя хоста, назначенного параметром конфигурации sip.transport/my_sip_address. Опциональные параметры: - --use_login - использовать логин вместо Cgpn в заголовке From - --use number - использовать Cgpn в заголовке From (по умолчанию)	default
nat_traversal	TR, SUB	Включение режима обхода NAT. Опция применима к SIP-пользователям и динамическим SIP-транкам (для которых требуется регистрация на ECSS). Значения: true — опция включена; false — опция выключена. Общий принцип режима NAT-traversal: При включении этого параметра SSW игнорирует поле "Contact" в SIP-сообщениях и отправляет сигнализацию, используя адрес источника (source). Для работы режима необходимо дополнительно настроить параметр udp-src-check на MSR, данный параметр работает аналогично параметру NAT-traversal, но уже не для SIP-сигнализации, а для RTP-потока, он позволяет SSW игнорировать данные источника в SDP и отправлять медиа на адрес источника (см. раздел MSR Настройка медиасервера).	false
no_video	IF	На уровне интерфейса добавлено свойство no_video. Возможные значения опции no_video: false — опция включена, значение по умолчанию; if_no_video_from_a — опция отключена. Чтобы в SDP отсутствовала секция видео для исходящего вызова на номер Б, нужно чтобы: на интерфейсе Б свойство no_video было выставлено в if_no_video_from_a; отсутствовала секция видео в SDP входящем вызова от номера А (в рамках вызова с номера А на номер Б); вызов с номера А на номер Б был прямой, т. е. вызов не через IVR, trunk; Б может быть алиасом или транком. Если условия выше были выполнены, то в рамках вызова из медиа профиля абонента Б удаляется секция видео. На основе получившего медиа профиля формируется sdp-template, который засылается на msr в SIP-сообщении INVITE. В результате msr отдает OfferSDP без секции видео в SIP-сообщении 200 OK.	false
original-cdpn-to	TR, SUB	Переключение подстановки CDPN на основе Original CDPN на основе принятых заголовков To либо Diversion.	true
original_cdpn_uri	TR	При включении параметра original_cdpn_uri в R-URI подставляется номер Cdpn.	false
out_login (proxy_out_login)	TR, SUB	Логин для исходящей авторизации. Необходим, если встречная сторона (транк) требует авторизации исходящих от нас запросов.	-
out_password (proxy_out_password)	TR, SUB	Пароль для исходящей авторизации. Необходим, если встречная сторона (транк) требует авторизации исходящих от нас запросов.	-
published presence	SUB (info)	Состояние, опубликованное терминалом SIP-пользователь (PUBLISH, Event: presence). Транслируется подписчикам услуги presence.	-
play-rbt	IF	Переопределение КПВ. где MODE: always — будет генерироваться всегда локальный КПВ early-media — генерация КПВ на получение 180+SDP (Переопределение early-media) ringing — генерация КПВ на получение 180 none — нет переопределения Если данное свойство выставлено на интерфейсе, и произошел вызов на транк, то будет КПВ будет переопределяться.	none
port	TR	Порт назначения для транка.	-
qop-authentication (aut_qop)	SUB	Использование расширенной QOP-авторизации (повышенный уровень защиты). Значения: true — опция включена; false — опция выключена.	false
realUri	TR	Описание параметров удаленной стороны. Формат: {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). Служебный параметр формируется автоматически при декларации или смене одного из параметров.	-
referred-by-as-cgpn	TR, SUB	Номер и поля user заголовка Referred-By используется в качестве Cgpn при отправке в ядро SetupInd.	false
register-expire-min	SUB	Минимальное значение периода перерегистрации.	90
register-expire-max	SUB	Максимальное значение периода перерегистрации.	3600
registrator	SUB (info)	Имя и транспортные параметры ноды, которой была обработана регистрация. Выставляется протокол-адаптером SIP.	-
regs_time	SUB (info)	Время регистрации. Устанавливается протокол-адаптером SIP.	-
rel_to_cancel	TR	Включение инкапсуляции ISUP/REL в "SIP/CANCEL". Актуально для режимов с инкапсуляцией ISUP (см. настройку mode). В зависимости от сети, на которой установлен SSW, либо от встречной стороны инкапсуляция может требоваться или быть неподдерживаемой. Значения: false — "CANCEL" без инкапсуляции ISUP/REL; true — "CANCEL" с инкапсуляцией ISUP/REL.	false
remote-client	TR	Выбор предустановленного профиля встречного сервера. Позволяет включать опции специфичные серверам конкретного производителя (см. настройку профиля абонентов SIP). coral — Поддержка сервера CORAL; default — стандартная работа.	default
remote-ctr-indication	TR, SUB	Заголовок для указания об удаленном CTR: rpi — REMOTE-PARTY-ID; pai — P-ASSERTED-IDENTITY; both — одновременное включение REMOTE-PARTY-ID и P-ASSERTED-IDENTITY; none.	rpi
remote-end-point	TR	Транспортные параметры включения транка на встречной стороне. Включают в себя: ip-адрес/доменное имя и порт.
remote-network-type	TR	Тип удаленной сети. Используется для определения инициатора разъединения, в частности, при инкапсуляции ISUP/REL. Значения: private; local; transit; international.	local
req100rel	TR, SUB	Требование надежных промежуточных ответов. Надежность обеспечивается отправкой запроса "PRACK" в ответ на соответствующий 1хх (RFC 3262). Значения: required — при отправке ответов группы 1хх включать "Require: 100rel"; supported — требование надежности не отправляется. Удаленная сторона поддерживает данную опцию, но требование надежности ему не отправляется; unsupported — требование надежности не отправляется. Удаленная сторона не поддерживает данную опцию, но при настройке было задано "требовать надежность". В этом случае требование отправляться не будет, но если в дальнейшем (например, после очередного ответа на "OPTIONS") определится поддержка, то требование начнет ставиться, в этом случае данный параметр поменяет значение на "required".	supported
rfc-4028-control	TR, SUB	Поддержка контроля сессии по RFC 4028, даже в случае, если удаленная сторона его не поддерживает. К настройке доступны значения "true" и "false". Значения: true — включено. Обновление сессии производится только в случае если встречная сторона поддерживает timer; false — выключено; force — включено. Обновление сессии производится не зависимо от поддержки timer встречной стороной.	true
route-by-via	TR	Настройка актуальна для динамического транка. Позволяет подставлять в Request-URI информацию из поля Contact, полученную при регистрации. Значения: true; false.	false
routing.context	TR, SUB,IF	Контекст маршрутизации.	-
sip-modifications	TR, SUB	Настройка модификации заголовков 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-transit	TR, SUB	При звонке SIP/SIP есть возможность транзита отдельных заголовков Формат: sip-transit set PARAMETERS SET key1 = val1, key2 = val2, ... Параметры: headers = [HEADER1, HEADER2, ...] — транзит SIP заголовков в исходящих запросах и ответах на вторую сторону; clean — сброс всех настроек транзита.	-
sip-domain	TR, SUB	SIP-домен в "Request URI", заголовках From, To исходящего от нас запроса. Значения: имя домена; "undefined".	-
supported	SUB (info)	Функции (Supported), поддерживаемые терминалом SIP-пользователя.	-
support_encoding	SUB (info),IF	Отображение Display Name в зависимости от типа кодировки Значения: utf-8 — использование кодировки UTF-8 для данного абонента; latin1 — использование кодировки latin1 для данного абонента; cp1251 — использование кодировки cp1251 для данного абонента.	-
symbol_hash_as_is	TR, SUB	Передача символа '#' не в Hex-формате (%23). Значения: false — решётка передаётся в hex-формате (%23); true — решётка передаётся символом '#'.	false
trunk (trunk name)	TR	Логическое объединение транков (направление). Необходим для группировки SIP-направлений в целях контроля, статистики, СОРМ и т.д. Значением является имя.	-
trusted-ip	SUB	Список доверенных IP-адресов, запросы REGISTER и INVITE, полученные с IP-адреса из этого списка, обрабатываются без аутентификации.	none
tel-uri-in-diversion	TR, SUB	Использование формата "tel:" вместо "sip:" в заголовке Diversion при переадресации звонка.	false
uptime	TR (info)	Длительность последнего соединения с транком (либо после пропадания ответов на периодический опрос доступности, либо с момента старта или декларации.	-
user agent	SUB (info)	Название терминала SIP-пользователя (User-Agent).	-
use-global-callref	TR	Использование GLOBAL CALL REF для ISUP-ETSI. Параметр работает для адаптации диалектов национальных стандартов ОКС-7 при пропускании международного трафика.	false
user-name	TR	Имя юзера при исходящей регистрации транка. Если не назначено (значение none), используется имя транка.	none

Описание параметров кластера SIP:

/adapter/<CLUSTER>/properties

Описание параметров Виртуальной АТС на уровне SIP-адаптера:

domain/<DOMAIN>/sip/properties
domain/<DOMAIN>/sip/properties_sys

authentication

Команда просмотра информации о параметрах авторизации абонента.

При запросе выполняется запрос на LDAP-сервер для получения данных абонентского аккаунта.

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

/domain/<DOMAIN>/sip/user/authentication

Синтаксис:

authentication <GROUP> <USER_INTERFACE>

Параметры:

<GROUP> - название группы пользователей. Символ "*" используется для указания всех групп;
<USER_INTERFACE> - название интерфейса, задается в формате: Имя_пользователя@Домен_SIP_регистрации. Символ "*" используется для указания всех интерфейсов.

Пример:

/domain/test_domain/sip/user/authentication sip 42007@test_domain
1 make users list ...
[**********************************************************************] 69mks    
check authentication info for 1 interfaces ...
[**********************************************************************] 12ms     
Executed on the sip1@ecss2
┌───────────────────┬─────────┬────────────┬────────────────┐
│       User        │ Use QOP │ Trusted IP │  LDAP account  │
├───────────────────┼─────────┼────────────┼────────────────┤
│ 42007@test_domain │ true    │-           │ no_information │
└───────────────────┴─────────┴────────────┴────────────────┘
┌─────────────┐
│ elements: 1 │
└─────────────┘

call-list

Команда просмотра списка активных вызовов через выбранный интерфейс.

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

/domain/<DOMAIN>/sip/user/call-list

Синтаксис:

call-list [<GROUP>] [<INTERFACE>] [<OPTIONS>]

Параметры:

<GROUP> - название группы интерфейсов. Символ "*" указывается для экспорта всех групп интерфейсов;<INTERFACE> - логическое имя интерфейса;
<OPTIONS> - дополнительные действия:

--complete - установка данного флага позволяет отобразить все интерфейсы, на которые были приняты вызовы;
--more T [sec|min|hour] - установка данного флага позволяет отобразить все вызовы, длительность которых более установленного времени;
--less T [sec|min|hour] - установка данного флага позволяет отобразить все вызовы, длительность которых менее установленного времени.

Пример:

/domain/test_domain/sip/user/call-list 
Executed on the sip1@ecss1
┌───────────────────┬──────────────────────────┬───────────┬──────────────────────────────────────────┬─────────────────────────────────────────────────┐
│   Interface URI   │        Direction         │   State   │                   Time                   │                 Additional info                 │
├───────────────────┼──────────────────────────┼───────────┼──────────────────────────────────────────┼─────────────────────────────────────────────────┤
│ 42007@test_domain │ sip[42007] <- ssw[42009] │ connected │ Start: Tue, 12 Aug 2025 09:23:06         │ Node: sip1@ecss1, <0.4289.4>                    │
│                   │                          │           │ Last activity: Tue, 12 Aug 2025 09:23:10 │ CallRef: 3263544057                             │
│                   │                          │           │                                          │ Call-ID: "06daebb0a6e39ef6"                     │
│                   │                          │           │                                          │ SessionID: <<"06daebb0a6e39ef6">>               │
│                   │                          │           │                                          │ Session handler: {amqp_io_12,<0.4289.4>}        │
│ 42009@test_domain │ sip[42009] -> ssw[42007] │ connected │ Start: Tue, 12 Aug 2025 09:23:06         │ Node: sip1@ecss1, <0.4288.4>                    │
│                   │                          │           │ Last activity: Tue, 12 Aug 2025 09:23:10 │ CallRef: 3263544057                             │
│                   │                          │           │                                          │ Call-ID: "503dfe40-9b68-1200-06a0-6813e2092a90" │
│                   │                          │           │                                          │ SessionID: <<"06daebb0a5d80cd5">>               │
│                   │                          │           │                                          │ Session handler: {amqp_io_7,<0.4288.4>}         │
└───────────────────┴──────────────────────────┴───────────┴──────────────────────────────────────────┴─────────────────────────────────────────────────┘
┌────────────┐
│ 2 sessions │
└────────────┘

change-group

Команда изменения группы интерфейса.

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

/domain/<DOMAIN>/sip/user/change-group

Синтаксис:

change-group <GROUP> <USER INTERFACE> <OTHER GROUP> [--force]

Параметры:

<GROUP> - название группы интерфейсов;
<USER INTERFACE> - логическое имя интерфейса.

<OTHER GROUP> - название группы интерфейсов, на которую производится замена. При отсутствии создается новая;

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

Примеры:

/domain/test_domain/sip/user/change-group sip 50003@test_domain test  
1 make users list ...
[**********************************************************************] 59mks    
[change-group] Group test isn't exists
continue: yes/no ?> yes
1 interfaces apply ...
[**********************************************************************] 1ms      
12 interfaces recall to base
[**********************************************************************] 5ms      
1 interfaces recall to base
[**********************************************************************] 2ms      

Warning: obsolete command. It will be removed at ECSS-10 v3.15. Use command /domain/<DOMAIN>/sip/user/set <GROUP> <URI> group <NEW_GROUP>

Executed on the sip1@ecss1
ok

/domain/test_domain/sip/user/change-group sip 4201{0-9}@test_domain test                                                                       
10 make users list ...
[**********************************************************************] 79mks    
10 interfaces apply ...
[**********************************************************************] 8ms      
12 interfaces recall to base
[**********************************************************************] 7ms      
11 interfaces recall to base
[**********************************************************************] 8ms      

Warning: obsolete command. It will be removed at ECSS-10 v3.15. Use command /domain/<DOMAIN>/sip/user/set <GROUP> <URI> group <NEW_GROUP>

Executed on the sip1@ecss1
ok

check

Команда проверки доступности абонентского устройства по сигнализации.

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

/domain/<DOMAIN>/sip/user/check

Синтаксис:

check <GROUP> <USER_INTERFACE><METHOD> [timerF = <TIMEOUT>]

Параметры:

<GROUP> - название группы интерфейсов;
<USER_INTERFACE> - название интерфейса, задается в формате: Имя_пользователя@Домен_SIP_регистрации. Символ "*" используется для указания маски интерфейсов,
<METHOD> - OPTIONS or NOTIFY

например:

./user/check test.subscribers *
./user/check test.subscribers 10000*
./user/check test.subscribers 100000@eltex.local timerF = 5000

<TIMEOUT> - тайм-аут ожидания ответа, в пределах которого отправляются повторные запросы, если удаленная сторона не отвечает. По умолчанию 5000 мс.

Пример:

/domain/test_domain/sip/user/check sip 4200* options                         
10 make users list ...
[**********************************************************************] 30mks    
Executed on the sip1@ecss1
Intermediate (incomplete) result:
check for user 42005@test_domain by sip1@ecss1 (node control: sip1@ecss1)
...
Executed on the sip1@ecss1
Intermediate (incomplete) result:
check for user 42007@test_domain by sip1@ecss1 (node control: sip1@ecss1)
...
Executed on the sip1@ecss1
Intermediate (incomplete) result:
check for user 42009@test_domain by sip1@ecss1 (node control: sip1@ecss1)
...
Executed on the sip1@ecss1
┌───────┬───────────────────┬────────────┬────────────────────────────────────────────────────────────────────┐
│ Group │       User        │ Accessible │                             Check info                             │
├───────┼───────────────────┼────────────┼────────────────────────────────────────────────────────────────────┤
│ sip   │ 42000@test_domain │ false      │ User isn't registered now                                          │
│       │                   │            │                                                                    │
│ sip   │ 42001@test_domain │ false      │ User isn't registered now                                          │
│       │                   │            │                                                                    │
│ sip   │ 42002@test_domain │ false      │ User isn't registered now                                          │
│       │                   │            │                                                                    │
│ sip   │ 42003@test_domain │ false      │ User isn't registered now                                          │
│       │                   │            │                                                                    │
│ sip   │ 42005@test_domain │ true       │ OPTIONS to <sip:42005@test_domain>: 200 OK, cseq: 412920 OPTIONS.  │
│       │                   │            │ Request by node: sip1@ecss1                                        │
│       │                   │            │                                                                    │
│ sip   │ 42007@test_domain │ true       │ OPTIONS to <sip:42007@test_domain>: 200 OK, cseq: 416337 OPTIONS.  │
│       │                   │            │ Request by node: sip1@ecss1                                        │
│       │                   │            │                                                                    │
│ sip   │ 42009@test_domain │ true       │ OPTIONS to <sip:42009@test_domain>: 200 OK, cseq: 442004 OPTIONS.  │
│       │                   │            │ Request by node: sip1@ecss1                                        │
└───────┴───────────────────┴────────────┴────────────────────────────────────────────────────────────────────┘

clean

Команда предназначена для установки параметров в значение по умолчанию.

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

/domain/<DOMAIN>/sip/user/clean

Синтаксис:

clean <GROUP> <USER_INTERFACE> <PARAMETER> [--force]

Параметры:

<GROUP> - название группы интерфейсов;
<USER_INTERFACE> - название интерфейса, задается в формате: Имя_пользователя@Домен_SIP_регистрации. Символ "*" используется для указания маски интерфейсов. Доступен также ввод диапазона интерфейсов:

./user/clean test.subscribers * trusted-ip
./user/clean test.subscribers 10000*
./user/clean test.subscribers 100000@eltex.local
./user/clean test.subscribers 100{000-399}@eltex.local

<PARAMETER> - параметр, значение которого нужно установить по умолчанию, список приведен выше.
[--force] - удаление без дополнительного подтверждения (опциональный параметр).

Примеры:

/domain/test_domain/sip/user/clean sip 42005@test_domain keep_alive_control 
[clean] Set parameters to default value
continue: yes/no ?> yes
1 make users list ...
[**********************************************************************] 20mks    
clean to 1 interfaces ...
[**********************************************************************] 19ms     
Executed on the sip1@ecss1
complete

/domain/test_domain/sip/user/clean test 4201* qop-authentication 
[clean] Set parameters to default value
continue: yes/no ?> yes
11 make users list ...
[**********************************************************************] 34mks    
clean to 10 interfaces ...
[**********************************************************************] 105ms    
Executed on the sip1@ecss1
complete

declare

Команда декларации абонента (группы абонентов).

При декларации создаются соответствующие интерфейсы и алиасы.

При требовании аутентификации для абонента (абонентов) можно сразу прописать параметры аккаунта (логин, пароль).

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

/domain/<DOMAIN>/sip/user/declare

Синтаксис:

declare <ROUTING_CONTEXT> <GROUP> <USER_INTERFACE> <ALIAS> <QOP_AUTH> <LOGIN> <PASSWORD>

Параметры:

<ROUTING_CONTEXT> - название существующего контекста маршрутизации;
<GROUP> - название группы пользователей (может быть задана существующая или новая группа пользователей);
<USER_INTERFACE> - интерфейс создаваемого SIP-абонента в формате <НОМЕР>@<DOMAIN>.

Номер может быть задано шаблоном: Prefix_Symbols{Start_Digits-Stop_Digits}.

<ALIAS> - альтернативный номер абонента, при указании значения "none" создается sip-абонент без алиаса; при указании значения "alias-as-user " - создается SIP-абонент с алиасом
<QOP_AUTH> - поддержка QOP-аутентификации (повышенный уровень защиты). Опциональный параметр:

no_qop_authentication - не использовать QOP-аутентификацию;
qop_authentication - использовать QOP-аутентификацию.

<LOGIN> - имя декларируемого пользователя. Опциональный параметр. Имя пользователя может быть впоследствии добавлено/изменено как терминальными командами, так и на LDAP-сервере:

login_as_number - в качестве имен пользователей использовать декларируемые номера;
none - не назначать параметры авторизации при декларации;
common_login <LOGIN> - общее имя <LOGIN> для всех декларируемых абонентов.

<PASSWORD> - пароль декларируемых пользователей. Не указывается, если в качестве <LOGIN> выбрано "none". Пароли проверяются на соответствие требованиям, установленным в профиле безопасности (/system/security/profile/), параметр restrictions.

auto_generation - каждому декларируемому абоненту генерируется персональный пароль. Полученные пароли можно будет посмотреть командами "user info" или "user authentication";
публичный пароль (символьная строка) - всем декларируемым абонентам будет назначен единый заданный пароль.

Пример:

Декларация одного абонента с номером 240815 без требования аутентификации:

/domain/test_domain/sip/user/declare default_routing sip 42002 alias-as-user no_qop_authentication login-as-user 42002        
Executed on the sip1@ecss1
Intermediate (incomplete) result:
Declaration for range: 42002@test_domain..42002@test_domain (1)
...
1 interfaces check for existing ...
[**********************************************************************] 23mks    
1 users interfaces declaration ...
[**********************************************************************] 26ms     
1 users divided into 1 parts to declare ...
[**********************************************************************] 4mks     
1 users aliases declaration ...
[**********************************************************************] 4ms      
1 users trying licence packages activating ...
[**********************************************************************] 5ms      
13 interfaces recall to base
[**********************************************************************] 17ms     
Executed on the sip1@ecss1
┌────────────────────────┐
│ declared 1 subscribers │
└────────────────────────┘

Декларация 10 абонентов с требованием аутентификации при регистрации, qop требуется, сразу создаются аккаунты с автоматической генерацией паролей:

/domain/test_domain/sip/user/declare default_routing sip 4201{0-9} alias-as-user qop_authentication login-as-user auto-generation 
Executed on the sip1@ecss2
Intermediate (incomplete) result:
Declaration for range: 42010@test_domain..42019@test_domain (10)
...
10 interfaces check for existing ...
[**********************************************************************] 143mks   
10 users interfaces declaration ...
[**********************************************************************] 207ms    
10 users divided into 1 parts to declare ...
[**********************************************************************] 44mks    
10 users aliases declaration ...
[**********************************************************************] 7ms      
10 users trying licence packages activating ...
[**********************************************************************] 4ms      
23 interfaces recall to base
[**********************************************************************] 12ms     
Executed on the sip1@ecss2
┌─────────────────────────┐
│ declared 10 subscribers │
└─────────────────────────┘

errors

Команда просмотра информации об ошибках в регистрации абонентов.

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

/domain/<DOMAIN>/sip/user/errors

Синтаксис:

errors <PARAMETER> [VALUE]

Параметры:

<PARAMETER> - назначаемое действие, принимает значение:

clear-table - удаление всех записей об ошибках регистрации;
set-limit <LIMIT> - установление максимального количества записей (<LIMIT>), значение должно быть целым;
uri <URI> - просмотр информации об ошибках для определенного URI;
all - просмотр информации обо всех ошибках;
known - просмотр информации об ошибках регистрации известных абонентов;
unknown - просмотр информации об ошибках регистрации неизвестных абонентов;

<VALUE> - значение.

Примеры:

/domain/test_domain/sip/user/errors set-limit 5
Executed on the sip1@ecss1
Changed limit: 1000 -> 5

/domain/test_domain/sip/user/errors 
Executed on the sip1@ecss1
┌─────────────────────┬─────────────────────┬────────────────────────────────────────────────────────────────────────────────┐
│         Uri         │   Last event time   │                                     Event                                      │
├─────────────────────┼─────────────────────┼────────────────────────────────────────────────────────────────────────────────┤
│ 10.0.20.35:5060 udp │ 2025-08-11 10:55:10 │ sip:vasja@test_domain : No interface detected (first: 2025-08-11 10:55:10, 1/1 │
│                     │                     │time(s))                                                                        │
│ 42005@test_domain   │ 2025-08-12 09:07:10 │ Wrong authentication (first: 2025-08-12 09:07:10, 2/2 time(s))                 │
└─────────────────────┴─────────────────────┴────────────────────────────────────────────────────────────────────────────────┘

info

Команда для просмотра информации о параметрах абонентского интерфейса (группы абонентских интерфейсов).

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

/domain/<DOMAIN>/sip/user/info

Синтаксис:

info <GROUP> [<USER_INTERFACE>] [<OPTIONS>]

Параметры:

<GROUP> - название группы пользователей. Символ "*" используется для указания всех групп; <USER_INTERFACE> - название интерфейса, задается в формате: Имя_пользователя@Домен_SIP_регистрации. Символ "*" используется для указания всех интерфейсов;
<OPTIONS>:

--ldap-account - выполнять запрос на LDAP-сервер (отображение логина и пароля). По умолчанию запрос не выполняется - отображается только требование авторизации;
--show-password - показывать логин и пароль.

Если в профиле безопасности (/system/security/profile/) параметр show_password_at_cli = off, то в выводе пароль скрывается, и вместо него показываются ********. В случае, если <USER_INTERFACE> = '*' то для отображения пароля в режиме on_request нужно ввести дополнительный флаг --show-password. Если был указан определенный пользователь, то в режиме on_request пароль покажется автоматически

Примеры:

Информация по одному абоненту:

/domain/test_domain/sip/user/info sip 42007@test_domain 
1 make users list ...
[**********************************************************************] 24mks    
1 users information read ...
[**********************************************************************] 18ms     
Executed on the sip1@ecss1
┌─────────────────────┬────────────────────────────────────────────────────────────────────────────────┐
│        User         │                               42007@test_domain                                │
├─────────────────────┼────────────────────────────────────────────────────────────────────────────────┤
│internal iface name  │06da428bec13ff40                                                                │
│isActive             │true                                                                            │
│group                │sip                                                                             │
│authentication       │42007:42007 (ds) use qop: true                                                  │
│contacts definition  │q: 1.0; ip-set: test_set; on port: 5060; sip                                    │
│                     │ node control: sip1@ecss1                                                       │
│                     │ gate: {gate_amqp,<<>>,<<"acp.sip.sip1.0a00141f.init.q">>}                      │
│                     │ sip transport: udp                                                             │
│                     │ user-agent: VP-15P/2.7.6.34 sofia-sip/1.12                                     │
│                     │ <sip:42007@10.0.20.134:5060>;expires=511                                       │
│                     │                                                                                │
│access_group         │all                                                                             │
│alarm_enable         │false                                                                           │
│aliases activities   │42007:true                                                                      │
│allow                │INVITE, ACK, BYE, CANCEL, OPTIONS, PRACK, MESSAGE, SUBSCRIBE, NOTIFY, REFER, UPD│
│                     │ATE, INFO                                                                       │
│allow events         │none                                                                            │
│auto-answer-version  │Alert-Info: Auto Answer (default by domain)                                     │
│category_to_sip      │default                                                                         │
│client-profile       │none                                                                            │
│compact-form         │defaut (force_long)                                                             │
│digest               │true                                                                            │
│display-name-encoding│default                                                                         │
│dtmf-duration        │100                                                                             │
│dtmf-relay           │false                                                                           │
│fork-mode            │all-contacts, allow repeated IP: true                                           │
│keep_alive_control   │disable (options)                                                               │
│last via             │SIP/2.0/UDP 10.0.20.134;received=10.0.20.134;rport=5060                         │
│my_from              │test_domain                                                                     │
│nat_traversal        │false                                                                           │
│original-cdpn-to     │true                                                                            │
│published presence   │none                                                                            │
│referred-by-as-cgpn  │false                                                                           │
│register-expire-max  │3600                                                                            │
│register-expire-min  │90                                                                              │
│host-to-invite       │registered-domain                                                               │
│registrator          │node: sip1@ecss1 port: udp 10.0.20.31:5060                                      │
│regs_time            │12.08.2025 08:57:02                                                             │
│remote-ctr-indication│rpi                                                                             │
│req100rel            │supported                                                                       │
│rfc-4028-control     │force                                                                           │
│routing.context      │default_routing                                                                 │
│sip-domain           │test_domain                                                                     │
│sip-modifications    │[]                                                                              │
│supported            │[req100rel]                                                                     │
│symbol_hash_as_is    │false                                                                           │
│sip-transit          │[]                                                                              │
│trusted-ip           │unassigned                                                                      │
│user agent           │VP-15P/2.7.6.34 sofia-sip/1.12                                                  │
└─────────────────────┴────────────────────────────────────────────────────────────────────────────────┘

Сводная общая информация о всех sip-абонентах:

/domain/test_domain/sip/user/info                                
2 group check for lookup active users ...
[**********************************************************************] 10ms     
Executed on the sip1@ecss2
┌─────────┬─────────┬────────────────────────────────────────────────────────────────────────────────┐
│  Group  │ Dynamic │                                   Parameters                                   │
├─────────┼─────────┼────────────────────────────────────────────────────────────────────────────────┤
│ sip     │ false   │ 'number of users' = 10                                                         │
│         │         │ 'number of registered users' = 5                                               │
│         │         │ domain = "test_domain"                                                         │
│         │         │ gate = {gate_amqp,<<"acp.adapter.init.ex">>,                                   │
│         │         │                  <<"acp.sip.sip1.test_set.init.rk">>}                          │
│         │         │ group = {gate_amqp,<<"acp.adapter.init.ex">>,                                  │
│         │         │                   <<"acp.sip.sip1.test_set.init.rk">>}                         │
│         │         │ owner = "sip1"                                                                 │
│         │         │                                                                                │
│ test    │ false   │ 'number of users' = 11                                                         │
│         │         │ 'number of registered users' = 0                                               │
│         │         │ domain = "test_domain"                                                         │
│         │         │ gate = {gate_amqp,<<"acp.adapter.init.ex">>,                                   │
│         │         │                  <<"acp.sip.sip1.test_set.init.rk">>}                          │
│         │         │ group = "test"                                                                 │
│         │         │ owner = "sip1"                                                                 │
│         │         │                                                                                │
│ summary │ ------- │ 'number of users' = 21                                                         │
│         │         │ 'number of registered users' = 5                                               │
└─────────┴─────────┴────────────────────────────────────────────────────────────────────────────────┘

Регистрационная информация по абонентам из диапазона:

/domain/test_domain/sip/user/info sip 4200{5-9}@test_domain 
5 make users list ...
[**********************************************************************] 121mks   
3 users information read ...
[**********************************************************************] 38ms     
Executed on the sip1@ecss1
┌───────────────────┬────────┬─────────────────┬───────┬──────────────────┬────────────────────────────────────────────────────────────┬───────────────────────────────────────┐
│       User        │ Number │ Is active on DS │ Group │      Login       │                        Registration                        │         Extended information          │
├───────────────────┼────────┼─────────────────┼───────┼──────────────────┼────────────────────────────────────────────────────────────┼───────────────────────────────────────┤
│ 42005@test_domain │ 42005  │ true            │ sip   │ 42005:42005 (ds) │ q: 1.0; ip-set: test_set; on port: 5060; sip               │ internal iface name: 06d0e917ee2cc392 │
│                   │        │                 │       │                  │  node control: sip1@ecss1                                  │ sip domain: test_domain               │
│                   │        │                 │       │                  │  gate: {gate_amqp,<<>>,<<"acp.sip.sip1.0a00141f.init.q">>} │                                       │
│                   │        │                 │       │                  │  sip transport: udp                                        │                                       │
│                   │        │                 │       │                  │  user-agent: Twinkle/1.10.2                                │                                       │
│                   │        │                 │       │                  │  <sip:42005@10.0.20.35>;expires=591                        │                                       │
│                   │        │                 │       │                  │                                                            │                                       │
│ 42007@test_domain │ 42007  │ true            │ sip   │ 42007:42007 (ds) │ q: 1.0; ip-set: test_set; on port: 5060; sip               │ internal iface name: 06da428bec13ff40 │
│                   │        │                 │       │                  │  node control: sip1@ecss1                                  │ sip domain: test_domain               │
│                   │        │                 │       │                  │  gate: {gate_amqp,<<>>,<<"acp.sip.sip1.0a00141f.init.q">>} │                                       │
│                   │        │                 │       │                  │  sip transport: udp                                        │                                       │
│                   │        │                 │       │                  │  user-agent: VP-15P/2.7.6.34 sofia-sip/1.12                │                                       │
│                   │        │                 │       │                  │  <sip:42007@10.0.20.134:5060>;expires=359                  │                                       │
│                   │        │                 │       │                  │                                                            │                                       │
│ 42009@test_domain │ 42009  │ true            │ sip   │ 42009:42009 (ds) │ q: 1.0; ip-set: test_set; on port: 5060; sip               │ internal iface name: 06da42f374eea5e5 │
│                   │        │                 │       │                  │  node control: sip1@ecss1                                  │ sip domain: test_domain               │
│                   │        │                 │       │                  │  gate: {gate_amqp,<<>>,<<"acp.sip.sip1.0a00141f.init.q">>} │                                       │
│                   │        │                 │       │                  │  sip transport: udp                                        │                                       │
│                   │        │                 │       │                  │  user-agent: VP-15P/2.7.6.34 sofia-sip/1.12                │                                       │
│                   │        │                 │       │                  │  <sip:42009@10.0.20.138:5060>;expires=1033                 │                                       │
└───────────────────┴────────┴─────────────────┴───────┴──────────────────┴────────────────────────────────────────────────────────────┴───────────────────────────────────────┘
┌─────────────┐
│ elements: 3 │
└─────────────┘

is-elph

Команда для проверки, есть ли у пользователя SIP, свойства Elph и может ли он их установить.

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

/domain/<DOMAIN>/sip/user/is-elph

Синтаксис:

is-elph <GROUP_NAME> <SIP_URI>

Параметры:

<GROUP_NAME> - имя группы интерфейсов, логическая привязка интерфейсов в определенной виртуальной АТС;
<SIP_URI> - SIP URI абонента, задается в виде: username@host, где username – номер абонента; host – название SIP-домена;

Примеры:

/domain/test_domain/sip/user/is-elph sip *        
┌──────────────────────────────┬──────────────────────────────┬──────────────────────────────┬────────────────────────────────────────┐
│            Group             │             User             │         Is Elph user         │        Can be set to Elph user         │
├──────────────────────────────┼──────────────────────────────┼──────────────────────────────┼────────────────────────────────────────┤
│sip                           │42000@test_domain             │false                         │true                                    │
│sip                           │42001@test_domain             │false                         │true                                    │
│sip                           │42002@test_domain             │true                          │false - Already is Elph user            │
│sip                           │42003@test_domain             │false                         │true                                    │
│sip                           │42005@test_domain             │false                         │true                                    │
│sip                           │42007@test_domain             │false                         │true                                    │
│sip                           │42009@test_domain             │false                         │true                                    │
│sip                           │50000@test_domain             │false                         │true                                    │
│sip                           │50001@test_domain             │false                         │true                                    │
└──────────────────────────────┴──────────────────────────────┴──────────────────────────────┴────────────────────────────────────────┘

list

Команда для просмотра списка пользователей по указанному правилу.

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

/domain/<DOMAIN>/sip/user/list

Синтаксис:

list <KEY> | <GROUP> <KEY> | <GROUP> <KEY> <IFACE_TEMPLATE>

Параметры:

<KEY> - название параметра, по которому формировать список :

--active - зарегистрированные абоненты;
--inactive - незарегистрированные абоненты
--forbidden - авторизация запрещена;

<GROUP> - название группы пользователей. Символ "*" используется для указания всех групп;
<IFACE_TEMPLATE> - шаблон имени интерфейса. Символ "*" используется для указания маски интерфейсов.

Примеры:

domain/test_domain/sip/user/list --active      
10 users check for active ...
[**********************************************************************] 803mks   
11 users check for active ...
[**********************************************************************] 397mks   
Executed on the sip1@ecss2
┌─────┬─────────────────┬─────────────────────────────────────────┐
│group│      user       │           current contact(s)            │
├─────┼─────────────────┼─────────────────────────────────────────┤
│sip  │42005@test_domain│<sip:42005@10.0.20.35>;expires=120       │
│sip  │42007@test_domain│<sip:42007@10.0.20.134:5060>;expires=1153│
│sip  │42009@test_domain│<sip:42009@10.0.20.138:5060>;expires=1052│
│sip  │50000@test_domain│<sip:50000@10.0.20.136:5060>;expires=843 │
│sip  │50001@test_domain│<sip:50001@10.0.20.136:5060>;expires=485 │
└─────┴─────────────────┴─────────────────────────────────────────┘
┌─────────────┐
│ elements: 5 │
└─────────────┘

/domain/test_domain/sip/user/list --forbidden    
Executed on the sip1@ecss1
┌────────────────────┬───────────────────────┬────────────────────────────────────────────────────────────────────────────────┐
│request by transport│time of the last trying│                                      info                                      │
├────────────────────┼───────────────────────┼────────────────────────────────────────────────────────────────────────────────┤
│10.0.20.35:5060 udp │2025-08-11 10:55:10    │sip:vasja@test_domain : No interface detected (first: 2025-08-11 10:55:10, 1/1 t│
│                    │                       │ime(s))                                                                         │
│42005@test_domain   │2025-08-12 09:43:33    │Wrong authentication (first: 2025-08-12 09:10:52, 0/110 time(s))                │
└────────────────────┴───────────────────────┴────────────────────────────────────────────────────────────────────────────────┘
┌─────────────┐
│ elements: 2 │
└─────────────┘

registered

Команда для просмотра списка зарегистрированных в данный момент абонентов.

Просмотр доступен по всей группе, по маске, по определенному абоненту.

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

/domain/<DOMAIN>/sip/user/registered

Синтаксис:

registered [<GROUP> [<USER_INTERFACE>]]

Параметры:

<GROUP> - название группы пользователей. Символ "*" используется для указания всех групп;
<USER_INTERFACE> - название интерфейса, задается в формате: Имя_пользователя@Домен_SIP_регистрации. Символ "*" используется для указания всех интерфейсов или маски номера.

Пример:

/domain/test_domain/sip/user/registered sip 4200*
10 make users list ...
[**********************************************************************] 86mks    
7 users information read ...
[**********************************************************************] 2ms      
Executed on the sip1@ecss1
┌───────────────────┬────────┬─────────┬─────────────────────────────────────────────────────┬─────────────────────────────────────────────────────┐
│     Interface     │ Number │ Dynamic │                       Contact                       │                  Registration info                  │
├───────────────────┼────────┼─────────┼─────────────────────────────────────────────────────┼─────────────────────────────────────────────────────┤
│ 42005@test_domain │ 42005  │ false   │ q: 1.0; ip-set: test_set; on port: 5060; sip        │ registered on:                                      │
│                   │        │         │  node control: sip1@ecss1                           │   node: sip1@ecss1 port: udp 10.0.20.31:5060        │
│                   │        │         │  gate: {gate_amqp,<<>>,<<"acp.sip.sip1.0a00141f.init│ last via list:                                      │
│                   │        │         │.q">>}                                               │   SIP/2.0/UDP 10.0.20.35;received=10.0.20.35;rport=5│
│                   │        │         │  sip transport: udp                                 │060                                                  │
│                   │        │         │  user-agent: Twinkle/1.10.2                         │ last user agent:                                    │
│                   │        │         │  <sip:42005@10.0.20.35>;expires=1970                │   Twinkle/1.10.2                                    │
│                   │        │         │                                                     │                                                     │
│ 42007@test_domain │ 42007  │ false   │ q: 1.0; ip-set: test_set; on port: 5060; sip        │ registered on:                                      │
│                   │        │         │  node control: sip1@ecss1                           │   node: sip1@ecss1 port: udp 10.0.20.31:5060        │
│                   │        │         │  gate: {gate_amqp,<<>>,<<"acp.sip.sip1.0a00141f.init│ last via list:                                      │
│                   │        │         │.q">>}                                               │   SIP/2.0/UDP 10.0.20.134;received=10.0.20.134;rport│
│                   │        │         │  sip transport: udp                                 │=5060                                                │
│                   │        │         │  user-agent: VP-15P/2.7.6.34 sofia-sip/1.12         │ last user agent:                                    │
│                   │        │         │  <sip:42007@10.0.20.134:5060>;expires=1391          │   VP-15P/2.7.6.34 sofia-sip/1.12                    │
│                   │        │         │                                                     │                                                     │
│ 42009@test_domain │ 42009  │ false   │ q: 1.0; ip-set: test_set; on port: 5060; sip        │ registered on:                                      │
│                   │        │         │  node control: sip1@ecss1                           │   node: sip1@ecss1 port: udp 10.0.20.31:5060        │
│                   │        │         │  gate: {gate_amqp,<<>>,<<"acp.sip.sip1.0a00141f.init│ last via list:                                      │
│                   │        │         │.q">>}                                               │   SIP/2.0/UDP 10.0.20.138;received=10.0.20.138;rport│
│                   │        │         │  sip transport: udp                                 │=5060                                                │
│                   │        │         │  user-agent: VP-15P/2.7.6.34 sofia-sip/1.12         │ last user agent:                                    │
│                   │        │         │  <sip:42009@10.0.20.138:5060>;expires=535           │   VP-15P/2.7.6.34 sofia-sip/1.12                    │
└───────────────────┴────────┴─────────┴─────────────────────────────────────────────────────┴─────────────────────────────────────────────────────┘
┌─────────────┐
│ elements: 3 │
└─────────────┘

elph-registered

Команда для просмотра списка зарегистрированных в данный момент абонентов, использующих Elph.

Просмотр доступен по всему домену либо по группе.

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

/domain/<DOMAIN>/sip/user/elph-registered

Синтаксис:

registered [<GROUP> ]

Параметры:

<GROUP> - название группы пользователей. Символ "*" используется для указания всех групп.

Пример:

/domain/test.domain/sip/user/elph-registered *
Executed on the sip1@ecss1
┌──────────────────┬────────┬─────────┬──────────────────────────────────────────────┬─────────────────────────────────────────────────────────┐
│    Interface     │ Number │ Dynamic │                   Contact                    │                    Registration info                    │
├──────────────────┼────────┼─────────┼──────────────────────────────────────────────┼─────────────────────────────────────────────────────────┤
│ 1006@test.domain │ 1006   │ false   │ q: 1.0; ip-set: lab.ims; on port: 5060; sip  │ registered on:                                          │
│                  │        │         │  registered by node: sip1@ecss1              │   node: sip1@ecss1 port: tcp 10.25.88.84:5060           │
│                  │        │         │  sip transport: tcp                          │ last via list:                                          │
│                  │        │         │  user-agent: Elph-desktop 2.1.136            │   SIP/2.0/TCP 192.168.114.122;received=95.167.221.157   │
│                  │        │         │  <sip:1006@95.167.221.157:12702>;expires=603 │ last user agent:                                        │
│                  │        │         │                                              │   Elph-desktop 2.1.136                                  │
└──────────────────┴────────┴─────────┴──────────────────────────────────────────────┴─────────────────────────────────────────────────────────┘
┌─────────────┐
│ elements: 1 │
└─────────────┘

remove

Данной командой выполняется удаление абонента (группы абонентов).

При удалении удаляются соответствующие интерфейсы и алиасы.

Удаление применяется к конкретному URI абонента, к диапазону URI (начинающихся с одной комбинации символов), ко всей группе абонентов.

При удалении будет предложено удалить также и аккаунт(ы) на LDAP-сервере.

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

/domain/<DOMAIN>/sip/user/remove

Синтаксис:

remove <GROUP> <USER_INTERFACE> [--force]

Параметры:

<GROUP> - название группы пользователей. Символ "*" используется для указания всех групп;
<USER_INTERFACE> - название удаляемого интерфейса, задается в формате: Имя_пользователя@Домен_SIP_регистрации;

Имя пользователя может быть задано шаблоном: Prefix_Symbols{Start_Digits-Stop_Digits}.

[--force] - удаление без дополнительного подтверждения (опциональный параметр).

Пример:

Удаление одного абонента:

/domain/test_domain/sip/user/remove test 42010@test_domain
[remove] Remove interfaces. Undo will be impossible
continue: yes/no ?> yes
1 make users list ...
[**********************************************************************] 44mks    
1 interfaces check for existing ...
[**********************************************************************] 7mks     
1 read users binary id ...
[**********************************************************************] 94mks    
1 users leave ...
[**********************************************************************] 5ms      
10 interfaces recall to base
[**********************************************************************] 7ms      
Executed on the sip1@ecss1
Complete

Удаление диапазона абонентов:

/domain/test_domain/sip/user/remove test 4201{1-9}@test_domain --force 
9 make users list ...
[**********************************************************************] 62mks    
9 interfaces check for existing ...
[**********************************************************************] 15mks    
9 read users binary id ...
[**********************************************************************] 384mks   
9 interfaces divided into 1 parts to remove from SIP ...
[**********************************************************************] 7mks     
9 users leave ...
[**********************************************************************] 78ms     
9 interfaces divided into 1 parts to remove from DS ...
[**********************************************************************] 10mks    
9 interfaces and aliases remove from DS ...
[**********************************************************************] 93ms     
1 interfaces recall to base
[**********************************************************************] 4ms      
Executed on the sip1@ecss2
Complete

Удаление всей группы абонентов:

/domain/test_domain/sip/user/remove test *                                                                                                         
[remove] Remove interfaces. Undo will be impossible
continue: yes/no ?> yes
11 interfaces check for existing ...
[**********************************************************************] 84mks    
11 read users binary id ...
[**********************************************************************] 479mks   
11 interfaces divided into 1 parts to remove from SIP ...
[**********************************************************************] 8mks     
11 users leave ...
[**********************************************************************] 93ms     
11 interfaces divided into 1 parts to remove from DS ...
[**********************************************************************] 8mks     
11 interfaces and aliases remove from DS ...
[**********************************************************************] 256ms    
Executed on the sip1@ecss1
Intermediate (incomplete) result:
Group test has been removed (all interfaces in this group was removed)
...
Executed on the sip1@ecss1
Complete

set

Данной командой выполняется настройка параметров абонентов и группы.

Пароли проверяются на соответствие требованиям, установленным в профиле безопасности (/system/security/profile/), параметр restrictions.

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

/domain/<DOMAIN>/sip/user/set

Синтаксис:

set <GROUP_NAME> <SIP_URI> <PARAMETER> <VALUE>

Параметры:

<GROUP_NAME> - имя группы интерфейсов, логическая привязка интерфейсов в определенной виртуальной АТС;
<SIP_URI> - SIP URI абонента, задается в виде: username@host, где username – номер абонента; host – название SIP-домена;

Список может быть задан диапазоном {a-b} или перечислением {a,b}, где a,b – натуральные числа.
Пример. Интерфейсы 1111@eltex.local, 1112@eltex.local, 1113@eltex.local можно задать в виде 111{1-3}@eltex.local или 111{1,2,3}@eltex.local или {1111,1112,1113}@eltex.local.

<PARAMETER> - имя изменяемого параметра, список приведен выше;
<VALUE> - значение изменяемого параметра, список приведен выше.

Пример:

/domain/test_domain/sip/user/set sip 50002@test_domain category_to_sip category     
1 make users list ...
[**********************************************************************] 13mks    
set for 1 users ...
[**********************************************************************] 6ms      
Executed on the sip1@ecss1

Пример назначения профиля (режима):

Значения могут быть:

auto - автоматическое определение (по заголовку User-Agent);
none - режим профилей игнорируется (сейчас используется по умолчанию этот режим);
coral - для абонентов Coral;
PROFILE_NAMES - список имеющихся профилей, из которых выбирается лишь один.

set-elph

Данной командой выполняется установка свойства Elph для пользователя SIP.

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

/domain/<DOMAIN>/sip/user/set-elph

Синтаксис:

set-elph <GROUP_NAME> <SIP_URI>

Параметры:

<GROUP_NAME> - имя группы интерфейсов, логическая привязка интерфейсов в определенной виртуальной АТС;
<SIP_URI> - SIP URI абонента, задается в виде: username@host, где username – номер абонента; host – название SIP-домена;

Команда выполняется индивидуально, задать список невозможно.

Пример:

/domain/test_domain/sip/user/set-elph sip 42002@test_domain 
Success: Elph properties are set for users in "sip" group(s): 
["42002@test_domain"]

stop-registration

Данной командой производится принудительное завершение регистрации.

Сброс регистрации применяется как к конкретному URI абонента, так и к диапазону по маске.

Может понадобиться, например, для выведения шлюза из работы (для его замены).

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

/domain/<DOMAIN>/sip/user/stop-registration

Синтаксис:

stop-registration <GROUP> <USER_INTERFACE> [--force]

Параметры:

<GROUP> - название группы пользователей. Символ "*" используется для указания всех групп;
<USER_INTERFACE> - название интерфейса или шаблон;

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

Пример:

/domain/test_domain/sip/user/stop-registration sip 42007@test_domain --force 
1 make users list ...
[**********************************************************************] 23mks    
stop registration to 1 interfaces ...
[**********************************************************************] 11ms     
1 users divided into 1 parts to declare ...
[**********************************************************************] 9mks     
set 1 interfaces to inactive state on DS ...
[**********************************************************************] 10ms     
Executed on the sip1@ecss1
1 users are de-registered (directly expired): 06da428bec13ff40 (42007@test_domain) ... 06da428bec13ff40

subscription-list

Команда предназначена для просмотра статистики подписок пользователя.

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

/domain/<DOMAIN>/sip/user/subscription-list

Синтаксис:

subscription-list
subscription-list where Column =|/=|<|>|<=|>= Value
subscription-list where Column =|/=|<|>|<=|>= Value order_by Column asc|desc
subscription-list order_by Column asc|desc

Параметры:

full - полный вывод;
debug - показывает последний event, пришедший с ядра;
order_by - сортировка;
where - фильтры.

Пример:

/domain/test_domain/sip/user/subscription-list                   
┌────────────────────────────────┬─────────────────┬────────────────────┬────────────────────┬──────────┐
│               ID               │      Event      │        From        │         To         │ Expires  │
├────────────────────────────────┼─────────────────┼────────────────────┼────────────────────┼──────────┤
│34ded4e5d848f7446880d7839b7f1b84│blf              │42007               │42005               │1718      │
│a10e3d5a5ee940790e57d9658a067720│blf              │42007               │42009               │1585      │
│be13a7a0f4d7df0bfecb46cd5ffcfc1f│blf              │42009               │42005               │1716      │
└────────────────────────────────┴─────────────────┴────────────────────┴────────────────────┴──────────┘

Total subscribers: 3

subscription-monitor

Команда предназначена для мониторинга подписок на абонента.

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

/domain/<DOMAIN>/sip/user/subscription-monitor

Синтаксис:

monitor event = <TypeService> <Address1> <Address2> ...

Прерывание мониторинга - Ctrl+C

Параметры:

<Address> - используемый адрес домена;
<TypeService> - мониторинг услуг blf, voicemail или *.

Пример:

/domain/test_domain/sip/user/subscription-monitor event = * 42005
trying          : ypggxszulseijsn@abf.eltex           : 
early           : ypggxszulseijsn@abf.eltex           : sub_A_42005:42005 -> тестер:50001
terminated      : ypggxszulseijsn@abf.eltex           : sub_A_42005:42005 -> тестер:50001
trying          : undefined                           : 
early           : 06e6ee98bc329ea2                    : sub_A_42005:42005 <- sub_C_42009:42009
confirmed       : 06e6ee98bc329ea2                    : sub_A_42005:42005 <- sub_C_42009:42009
terminated      : 06e6ee98bc329ea2                    : sub_A_42005:42005 <- sub_C_42009:42009
trying          : ptjwzmapwoztyfm@abf.eltex           : 
early           : ptjwzmapwoztyfm@abf.eltex           : sub_A_42005:42005 -> sub_B_42007:42007
confirmed       : ptjwzmapwoztyfm@abf.eltex           : sub_A_42005:42005 -> sub_B_42007:42007
terminated      : ptjwzmapwoztyfm@abf.eltex           : sub_A_42005:42005 -> sub_B_42007:42007
Command has been canceled: interrupted

subscription-stop

Команда предназначена для остановки подписок пользователя.

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

/domain/<DOMAIN>/sip/user/subscription-stop

Синтаксис:

subscription <SRC_USER_INTERFACE><TYPE><DST_USER_INTERFACE> [--force]

Параметры:

<SRC_USER_INTERFACE> - название интерфейса подписчика. Символ "*" используется для указания всех пользователей;
<TYPE> - тип подписки (blf, conference-info, presence, ss-info, voicemail). Символ "*" используется для указания всех типов;
<DST_USER_INTERFACE> - название интерфейса, на который подписан пользователь. Символ "*" используется для указания всех пользователей.

Пример:

/domain/test_domain/sip/user/subscription-stop 42009@test_domain blf 42005@test_domain
[subscription-stop] record(s) will be removed
continue: yes/no ?> yes
Executed on the sip1@ecss1
1 subscriptions are stoped