Описание команд, используемых при настройке SIP-абонентов, приведено в справочнике команд CLI, раздел Команды управления конфигурацией абонентов SIP.

Добавление абонента

Для создания SIP-абонента используется команда:

/domain/<DOMAIN>/sip/user/declare <ROUTING_CONTEXT> <GROUP> <INTERFACE> [<ALIAS> [<QOP_AUTH> [<LOGIN> [<PASSWORD>]]]]

где

<DOMAIN> - имя виртуальной АТС;<ROUTING_CONTEXT> - имя контекста маршрутизации для данного абонента;
<GROUP> - название группы пользователей, логическое объединение интерфейсов в определенной виртуальной АТС. Может быть задана существующая или новая группа пользователей;
<INTERFACE> - название декларируемого интерфейса, задается в виде: username@host, где username – номер абонента; host – название SIP-домена регистрации. Список может быть задан диапазоном {a-b} или перечислением {a,b}, где a,b – натуральные числа.
Например, интерфейсы , , можно задать в виде 111{1-3}@eltex.local или 111{1,2,3}@eltex.local или {1111,1112,1113}@eltex.local.Может быть задан существующий домен SIP-регистрации или указан новый;
<ALIAS> - альтернативный номер абонента, при указании значения "none" альтернативный номер не используется. Параметр нужен для возможности использовать тестовые имена на уровне SIP. Например, нужно прописать в качестве интерфейса SIP-абонента "", но так как в системе ECSS-10 используется телефонная маршрутизация, текстовое имя в маршрутизации использовать запрещено. В этом случае SIP-абоненту назначается параметр <ALIAS> - цифровой (телефонный) номер;
<QOP_AUTH> - поддержка QOP-аутентификации (повышенный уровень защиты). Опциональный параметр:

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

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

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

<PASSWORD> - пароль декларируемых пользователей. Не указывается, если в качестве <LOGIN> выбрано "none".

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

Пример

Декларация одного абонента без указания параметров аутентификации, например, планируется указание доверенных IP-адресов (параметр "trusted-ip"):

domain/test.domain/sip/user/declare local smg 401@test.domain none no_qop_authentication

Настройка параметров абонента

Команды уровня администратора виртуальной АТС

Для изменения индивидуальных значений параметров абонента используются следующие команды:

  • Команда для изменения параметров определенного абонентского номера и интерфейса заданной виртуальной АТС:
    /domain/<DOMAIN>/alias/set <NUMBER> <GROUP> <INTERFACE> <PROPERTY> <VALUE>
  • Команда для изменения параметров всех абонентов с определенным интерфейсом заданной виртуальной АТС:
    /domain/<DOMAIN>/alias/set-for-iface <GROUP> <INTERFACE> <PROPERTY> <VALUE>
  • Команда для изменения параметров всех абонентов с определенным абонентским номером заданной виртуальной АТС:
    /domain/<DOMAIN>/alias/set-for-address <NUMBER> <PROPERTY> <VALUE>

где

<DOMAIN> - имя виртуальной АТС;
<NUMBER> - абонентский номер;
<GROUP> - имя группы интерфейсов, логическая привязка интерфейсов в определенной виртуальной АТС;
<INTERFACE> - имя интерфейса;
<PROPERTY> - имя изменяемого параметра, список приведен Приложении А. Набор параметров алиасов;
<VALUE> - значение изменяемого параметра, список приведен Приложении А. Набор параметров алиасов.

Для изменения значений параметров профиля виртуальной АТС абонента необходимо выполнить следующую команду:

/domain/<DOMAIN>/alias/set-for-domain <PROPERTY> <VALUE>

где

<DOMAIN> - имя виртуальной АТС;
<PROPERTY> - имя изменяемого параметра, список приведен Приложении А. Набор параметров алиасов;
<VALUE> - значение изменяемого параметра, список приведен Приложении А. Набор параметров алиасов.

Указанные выше команды используются для настройки общих параметров для всех абонентов системы: SIP-абонентов, абонентов H.248/megaco, виртуальных абонентов.

Для настройки параметров, специфичных только для SIP-абонентов, используется команда:

/domain/<DOMAIN>/sip/user/set <GROUP> <SIP_URI> <PROPERTY> <VALUE>

где

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

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

<PARAMETER> - имя изменяемого параметра, список приведен Приложении Б. Набор параметров интерфейса SIP;
<VALUE> - значение изменяемого параметра, список приведен Приложении Б. Набор параметров интерфейса SIP.

Команды уровня администратора системы

Для изменения значений индивидуальных параметров абонента необходимо выполнить следующую команду:

/cluster/storage/<CLUSTER>/alias/set-for-address <DOMAIN> <NUMBER> <PROPERTY> <VALUE>

Свойство будет назначено всем одинаковым номерам во всех виртуальных АТС.

Для изменения значений параметров профиля на уровне виртуальной АТС необходимо выполнить следующую команду:

/cluster/storage/<CLUSTER>/alias/set <DOMAIN> <PROPERTY> <VALUE>

где
<CLUSTER> - имя кластера хранения долговременных данных (DS). По умолчанию в системе присутствует кластера хранения долговременных данных с именем "ds1";
<NUMBER> - абонентский номер;
<DOMAIN> - имя виртуальной АТС (домена);
<PROPERTY> - имя изменяемого параметра, список приведен в Приложении А. Набор параметров алиасов;
<VALUE> - значение изменяемого параметра, список приведен в Приложении А. Набор параметров алиасов.

Удаление SIP-абонента

Для удаления SIP-абонента используется команда:

Команда удаляет одновременно интерфейс и алиас.

/domain/<DOMAIN>/sip/user/remove <GROUP> <SIP_URI> [--force]

где

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

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

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