В текущем разделе описываются команды управления учётными записями пользователей cocon- и web-конфигуратора на уровне домена.

Описание по управлению пользователями приведено в разделе Управление пользователями или во вкладке ниже.

add-user

Команда для создания новой учетной записи пользователя:

• имя пользователя (login);
• пароль пользователя(enter password/confirm password);
• группа пользователей.

Группы пользователей:

• ECSS-DOMAIN-ADMIN – группа администраторов виртуальной АТС (Administrator of <domain_name>). Содержит команды управления определенной виртуальной АТС.
• ECSS-DOMAIN-USER – группа пользователей виртуальной АТС (User of <domain_name>). Содержит команды мониторинга определенной виртуальной АТС.

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

/domain/<DOMAIN>/cocon/add-user

Синтаксис:

add-user  [--expire-password] [<UserName>] [--force]

Параметры:

--expire-password - пароль должен быть изменен при первом входе в систему;

<UserName> - имя пользователя;

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

Пример:

Добавить пользователя "bsk" как администратора домена

admin@ds1@ecss1:/$ domain/biysk.local/cocon/add-user bsk
Enter password: 
Confirm password: 
ECSS biysk.local administrator: [n]/y ?> y
User bsk has been successfully created

[exec at: 16.02.2021 08:46:30, exec time: 16s 926ms, nodes: ds1@ecss1 v.3.14.7.585]

add-user-to-group

Данной командой пользователю назначается группа пользователей домена, команды которой он сможет исполнять.

Группы пользователей:

• ecss-<domain_name>-domain-admin – группа администраторов виртуальной АТС с именем <domain_name>. Содержит команды управления виртуальной АТС с именем <domain_name>.
• ecss-<domain_name>-domain-user – группа пользователей виртуальной АТС с именем <domain_name>. Содержит команды мониторинга виртуальной АТС с именем <domain_name>.

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

/domain/<DOMAIN>/cocon/add-user-to-group

Синтаксис:

add-user-to-group <USER> <GROUP>

Параметры:

<USER> - имя пользователя;

<GROUP> - группа пользователя.

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/cocon/add-user-to-group bsk ecss-biysk.local-domain-admin
Successful

[exec at: 16.02.2021 08:47:31, exec time: 29ms, nodes: ds1@ecss1 v.3.14.7.585]

admin@ds1@ecss1:/$ domain/biysk.local/cocon/add-user-to-group bsk ecss-biysk.local-domain-user    
Successful

[exec at: 16.02.2021 08:47:51, exec time: 27ms, nodes: ds1@ecss1 v.3.14.7.585]

del-user

Команда для удаления учетной записи из системы. Команда работает только если пользователь входит в группы ecss-<domain_name>-domain-admin и/или ecss-<domain_name>-domain-user.

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

/domain/<DOMAIN>/cocon/del-user

Синтаксис:

del-user <UserName> [--force]

Параметры:

<UserName> - имя пользователя;

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

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/cocon/del-user operator   
[del-user] You are going to delete CoCon user operator.
Are you sure?: yes/no ?> yes
User "operator" has been successfully deleted

[exec at: 16.02.2021 08:51:34, exec time: 2s 860ms, nodes: ds1@ecss1 v.3.14.7.585]

del-user-from-group

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

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

/domain/<DOMAIN>/cocon/del-user-from-group

Синтаксис:

add-user-to-group <USER> <GROUP>

Параметры:

<USER> - имя пользователя;

<GROUP> - группа пользователей.

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/cocon/del-user-from-group bsk ecss-biysk.local-domain-user 
Successful

[exec at: 16.02.2021 08:50:12, exec time: 26ms, nodes: ds1@ecss1 v.3.14.7.585]

list

Отображается список пользователей cocon- и web-конфигураторов, а также принадлежность пользователя к группе пользователей.
Записи в таблице могут быть упорядочены и отфильтрованы по любому параметру по убыванию или возрастанию, ограничены по количеству выводимых строк.

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

/domain/<DOMAIN>/cocon/list

Синтаксис:

list users|groups [where <filter>] [order by <column> [asc|desc]] [last|first <N>]

Параметры:

[where <filter>] - при указании команды "where" задается условие отбора записей в таблице:
<filter> - условие отбора записей, задается в виде <сolumn> = <value> [, <filter>], где<column> - название колонки, по которой производится отбор, принимает значения:

login - имя пользователя;

group - группа пользователей.

<value> - значение, по которому совершается отбор.

[order by <column> [asc|desc]] - при указании команды "order by" задается условие сортировки записей в таблице:<column> - название колонки, по которой будет сортировка записей, принимает значения: login, group.

[asc|desc] - способ сортировки:

• asc - по возрастанию;
• desc - по убыванию.

[last|first <N>] - ограничение по количеству выводимых строк:

last - выводить последние N-строк таблицы;

first - выводить первые N-строк таблицы;<N> - количество строк.

Пример:

admin@ds1@ecss1:/$ domain/biysk.local/cocon/list users                                                           
┌────────┬─────────────────────────────┬─────┐
│ Login  │           Groups            │Roles│
├────────┼─────────────────────────────┼─────┤
│txtuser │ecss-biysk.local-domain-admin│     │
│        │ecss-biysk.local-domain-user │     │
│operator│ecss-biysk.local-domain-user │     │
│bsk     │ecss-biysk.local-domain-admin│     │
│        │ecss-biysk.local-domain-user │     │
│admin   │ecss-biysk.local-domain-admin│     │
│        │ecss-biysk.local-domain-user │     │
└────────┴─────────────────────────────┴─────┘

[exec at: 16.02.2021 08:49:20, exec time: 21ms, nodes: ds1@ecss1 v.3.14.7.585]

passwd

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

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

/domain/<DOMAIN>/cocon/passwd

Синтаксис:

passwd [<UserName>]

Параметры:

<UserName> - имя пользователя.

Пример:

Изменить пароль для пользователя bsk

admin@ds1@ecss1:/$ domain/biysk.local/cocon/passwd bsk
[passwd] Changing password for bsk
Enter new password: 
Confirm new password: 
Password for user "bsk" has been successfully changed

[exec at: 16.02.2021 08:52:27, exec time: 11s 361ms, nodes: ds1@ecss1 v.3.14.7.585]