/domain/<DOMAIN>/cocon/ - команды управления учётными записями пользователей
В текущем разделе описываются команды управления учётными записями пользователей 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@[sip1@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: 23.02.2019 19:54:19, exec time: 48s 961ms, nodes: ds1@ecss1]
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@[sip1@ecss1]:/$ domain/biysk.local/cocon/add-user-to-group bsk ecss-biysk.local-domain-admin Successful [exec at: 24.02.2019 11:15:09, exec time: 66ms, nodes: ds1@ecss2] admin@[sip1@ecss1]:/$ domain/biysk.local/cocon/add-user-to-group bsk ecss-biysk.local-domain-user Successful [exec at: 24.02.2019 11:15:18, exec time: 66ms, nodes: ds1@ecss2]
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 bsk2 [del-user] You are going to delete CoCon user bsk2. Are you sure?: yes/no ?> yes User "bsk2" has been successfully deleted [exec at: 26.02.2019 09:20:46, exec time: 3s 34ms, nodes: ds1@ecss1]
del-user-from-group
Данной командой осуществляется удаление пользователя из заданной группы пользователей.
Путь команды:
/domain/<DOMAIN>/cocon/del-user-from-group
Синтаксис:
add-user-to-group <USER> <GROUP>
Параметры:
<USER> - имя пользователя;
<GROUP> - группа пользователей.
Пример:
admin@[sip1@ecss1]:/$ domain/biysk.local/cocon/del-user-from-group bsk ecss-biysk.local-domain-user Successful [exec at: 24.02.2019 11:21:16, exec time: 100ms, nodes: ds1@ecss2]
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@[sip1@ecss1]:/$ domain/biysk.local/cocon/list users ┌─────────┬─────────────────────────────┬─────┐ │ Login │ Groups │Roles│ ├─────────┼─────────────────────────────┼─────┤ │txtuser │ecss-biysk.local-domain-admin│ │ │ │ecss-biysk.local-domain-user │ │ │support │ecss-biysk.local-domain-admin│ │ │ │ecss-biysk.local-domain-user │ │ │ssw_admin│ecss-biysk.local-domain-admin│ │ │ │ecss-biysk.local-domain-user │ │ │office │ecss-biysk.local-domain-admin│ │ │bsk │ecss-biysk.local-domain-admin│ │ │ │ecss-biysk.local-domain-user │ │ │admin │ecss-biysk.local-domain-admin│ │ │ │ecss-biysk.local-domain-user │ │ └─────────┴─────────────────────────────┴─────┘ [exec at: 24.02.2019 11:17:10, exec time: 83ms, nodes: ds1@ecss1]
passwd
Команда для изменения текущего пароля пользователя, используемого при входе в систему.
Путь команды:
/domain/<DOMAIN>/cocon/passwd
Синтаксис:
passwd [<UserName>]
Параметры:
<UserName> - имя пользователя.
Пример:
Изменить пароль для пользователя bsk
dmin@[sip1@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: 24.02.2019 11:19:32, exec time: 18s 747ms, nodes: ds1@ecss1,sip1@ecss1]