Роли и организации¶
Кто работает в портале¶
В портале два вида пользователей. Пользователи платформы работают у провайдера; пользователи организации работают в клиентской организации.
| Роль | Вид | Что делает |
|---|---|---|
| Супер-администратор | платформа | Все права в портале: пользователи и роли, настройки, любые согласования и действия. |
| Менеджер ресурсов | платформа | Согласует новые проекты (даёт имя, размещает на площадке и кластере, подтверждает ресурсы), изменения ресурсов, изменения сетей и удаления; согласует новые организации и назначает их пользователей платформы; переносит проект в другую организацию. |
| Инженер поддержки | платформа | Согласует корпоративные проекты, когда этот шаг отмечен; задаёт VLAN L2-каналов, меняет размер интернет-шлюзов, ведёт работы на платформе. |
| Менеджер по продажам | платформа | Менеджер организации: полные права над организациями, которые он ведёт, и всеми их проектами (ниже); согласует её новые проекты и её регистрацию, когда включено согласование продаж, а также проект, переносимый в её организацию. |
| Ключевой менеджер | платформа | Контакт организации по обслуживанию: организация для него только для чтения, кроме того, что он приглашает, блокирует и разблокирует её пользователей и управляет ресурсами её проектов (ниже). Необязателен. |
| Администратор организации | организация | Всё в организации: заказывает проекты и запрашивает их изменение и удаление, управляет её пользователями и выдаёт роль администратора проекта; получает данные доступа к её новым проектам. |
| Администратор проекта | организация | Выданные ему проекты: запрашивает изменения их ресурсов и сетей, видит данные доступа, приглашает пользователей проекта. Проект не удаляет. |
| Пользователь проекта | организация | Видит выданные ему проекты, ничего не меняет. |
| Только чтение | организация | Видит все проекты организации, ничего не меняет. |
У человека может быть несколько ролей; с несколькими ролями он согласует один раз за все.
Менеджер по продажам и ключевой менеджер задаются в организации. Менеджер ресурсов и инженер поддержки задаются в проекте: если у проекта своих нет, действуют назначенные организации.
У каждого проекта есть один администратор проекта как контактное лицо: пользователь его организации, выбранный при заказе проекта и меняемый в «Изменить проект». Он получает данные доступа к проекту, когда тот развёрнут.
flowchart LR
subgraph provider ["Пользователи платформы — провайдер"]
SA[Супер-администратор]
RM[Менеджер ресурсов]
SE[Инженер поддержки]
SR[Менеджер по продажам]
KAM[Ключевой менеджер]
end
subgraph client ["Пользователи организации — клиент"]
OA[Администратор организации]
PA[Администратор проекта]
PU[Пользователь проекта]
RO[Только чтение]
end
OA -- заказывает, меняет, удаляет --> T[(Проекты)]
PA -- ресурсы выданных проектов --> T
PU -. видит выданные проекты .-> T
RO -. видит все .-> T
RM -- согласует, размещает, переносит --> T
SR -- полные права над своими организациями --> T
SE -- VLAN L2, размер шлюза --> T
KAM -- пользователи, ресурсы --> T
SA -- все права --> Tflowchart LR
subgraph provider ["Пользователи платформы — провайдер"]
SA[Супер-администратор]
RM[Менеджер ресурсов]
SE[Инженер поддержки]
SR[Менеджер по продажам]
KAM[Ключевой менеджер]
end
subgraph client ["Пользователи организации — клиент"]
OA[Администратор организации]
PA[Администратор проекта]
PU[Пользователь проекта]
RO[Только чтение]
end
OA -- заказывает, меняет, удаляет --> T[(Проекты)]
PA -- ресурсы выданных проектов --> T
PU -. видит выданные проекты .-> T
RO -. видит все .-> T
RM -- согласует, размещает, переносит --> T
SR -- полные права над своими организациями --> T
SE -- VLAN L2, размер шлюза --> T
KAM -- пользователи, ресурсы --> T
SA -- все права --> T
Что может каждая роль¶
Права над организацией и её проектами. У менеджера по продажам и ключевого менеджера они есть только в организациях, в которых они заданы; у администратора организации и администратора проекта — только в своей организации.
| Право | Супер-администратор, менеджер ресурсов | Менеджер по продажам | Ключевой менеджер | Администратор организации | Администратор проекта |
|---|---|---|---|---|---|
| Добавить организацию | да | да (становится её менеджером по продажам) | — | — | — |
| Изменить организацию | да | да | — (только чтение) | — | — (только чтение) |
| Сменить её менеджера по продажам, ключевого менеджера или менеджера ресурсов | да | — | — | — | — |
| Приглашать, блокировать и разблокировать её пользователей | да | да | да | да | — |
| Отправлять её пользователей в архив и возвращать их | да | — | — | да | — |
| Выдавать роль администратора проекта | да | да | — | да | — |
| Заказать проект | да | да | — | да | — |
| Добавить, изменить или удалить ресурсы проекта | да | да | да | да | да (свои проекты) |
| Удалить проект | да | да | — | да | — |
Заказы, изменения и удаления — это запросы: они ждут согласований, описанных на странице Согласования.
Менеджер по продажам, ключевой менеджер и менеджер ресурсов организации имеют полные права на её ресурсы: те же действия, что у супер-администратора над проектами этой организации. На странице организации они также приглашают её пользователей, блокируют и разблокируют их; менеджер по продажам и менеджер ресурсов там же меняют их роли.
На странице организации + Пригласить пользователя отправляет приглашение с ролями. Пока в Настройки → Клиент → Клиенты → Новые пользователи («пользователей можно добавлять до приглашения») это включено, там есть и + Добавить пользователя: он записывает пользователя (имя, e-mail, телефон, город) без входа, а в строке пользователя затем появляется Пригласить, которое отправляет приглашение с ролями, когда придёт время. Выключение настройки убирает добавление, но не приглашение.
Удаление проекта запрашивает администратор организации, менеджер по продажам организации, менеджер ресурсов или супер-администратор. Ключевой менеджер и администратор проекта управляют ресурсами, а не самим проектом, и удалить его не могут.
Менеджер по продажам и ключевой менеджер видят панель менеджера ресурсов по организациям, в которых они заданы, и их проектам.
Хотя бы один активный человек на роль¶
У каждой роли всегда есть хотя бы один активный пользователь платформы (принявший приглашение и способный войти). Портал отказывает в изменении ролей, блокировке или архивировании, после которых роль осталась бы без него.
Супер-администраторы¶
У супер-администратора есть все права, какие бы роли у него ни были отмечены. Отмеченные роли решают, какие согласования и уведомления к нему приходят: супер-администратора без роли менеджера ресурсов не просят согласовывать как менеджера ресурсов (запроса нет в «Ждут меня», письмо не приходит), но согласовать он всё равно может. Никто не привязан к тому, что был первым пользователем: роли любого супер-администратора можно править, в том числе свои.
Выдача или снятие роли супер-администратора требует согласия других супер-администраторов. Супер-администратор ставит или снимает флажок SA (супер-администратор) в строке пользователя платформы в Администрирование → Пользователи → Платформа; это открывает запрос:
- число супер-администраторов, которые должны согласиться, фиксируется при создании запроса по числу активных супер-администраторов на тот момент (таблица ниже); просящий супер-администратор считается одним из них;
- все супер-администраторы и тот, о ком речь, получают письмо;
- никто не снимает роль с себя сам, и тот, с кого снимают роль, не может это подтвердить;
- запрос истекает через 48 часов, и один отказ закрывает его, даже если подтверждение другого супер-администратора приходит в тот же момент; роль тогда остаётся как была;
- роль выдаётся или снимается, только когда согласилось достаточно супер-администраторов. Поэтому и выдача роли происходит не сразу;
- портал никогда не снимает роль с последнего супер-администратора.
| Активных супер-администраторов | Должны согласиться |
|---|---|
| 1 | 1 (просящий: выполняется сразу) |
| 2 | 2 |
| 3 | 2 |
| 4 и больше | 3 |
Ожидающие запросы показаны вверху Администрирование → Пользователи → Платформа: кто уже подтвердил и кнопки «Подтвердить» / «Отклонить» для тех, кто решает.
Снятие роли супер-администратора с B по просьбе другого супер-администратора A:
stateDiagram-v2
state "Запрошено" as Requested
state "Снято" as Done
state "Отклонено" as Declined
state "Истекло" as Expired
[*] --> Requested: A снимает отметку «Супер-администратор» у B
Requested --> Done: согласилось достаточно супер-администраторов (≤ 48 ч), A считается одним из них
Requested --> Declined: один из них отклонил
Requested --> Expired: прошло 48 часов
Done --> [*]: у B остаются другие отмеченные роли
Declined --> [*]: B остаётся супер-администратором
Expired --> [*]: B остаётся супер-администраторомstateDiagram-v2
state "Запрошено" as Requested
state "Снято" as Done
state "Отклонено" as Declined
state "Истекло" as Expired
[*] --> Requested: A снимает отметку «Супер-администратор» у B
Requested --> Done: согласилось достаточно супер-администраторов (≤ 48 ч), A считается одним из них
Requested --> Declined: один из них отклонил
Requested --> Expired: прошло 48 часов
Done --> [*]: у B остаются другие отмеченные роли
Declined --> [*]: B остаётся супер-администратором
Expired --> [*]: B остаётся супер-администратором
Действовать как пользователь. Супер-администратор может видеть портал ровно так, как его видит другой пользователь: «Действовать как» (Act as) вверху панели, рядом с приветствием, перечисляет всех пользователей, кроме архивных. Пока он действует как пользователь, баннер называет этого пользователя, а «Прекратить» (Stop acting) завершает режим. Режим — только чтение: любое действие можно открыть и отправить, но ничего не выполняется и не сохраняется (портал сообщает «Acting as a user is read-only — nothing was changed»).
Организации и их пользователи платформы¶
Организация — юридическое лицо со своей страной и налоговым номером (одна организация на налоговый номер в стране; в Казахстане — ИИН или БИН). Её тип — облачный клиент или корпоративная; только корпоративные организации заказывают корпоративные проекты и корпоративную сеть.
Согласуя зарегистрированную организацию, менеджер ресурсов назначает её пользователей платформы: менеджера ресурсов и инженера поддержки (всегда обязательны), менеджера по продажам (обязателен для облачных организаций) и ключевого менеджера (необязателен; только для облачных организаций).
- В организации («Изменить организацию»): менеджер по продажам и ключевой менеджер.
- В проекте: менеджер ресурсов и инженер поддержки (инженер поддержки — в «Изменить проект»). Если у проекта своих нет, действуют назначенные организации; если нет и их, действовать может любой менеджер ресурсов или инженер поддержки.
Когда организация создана, её тип, страна, налоговый номер и юридическое название не меняются. «Изменить организацию» меняет её краткое имя (только пока у неё нет проектов), менеджера по продажам и ключевого менеджера, заметки.
У корпоративной организации может быть менеджер по продажам (необязателен) с адресом e-mail корпоративного домена (Настройки → Клиент → Клиенты); ключевого менеджера у неё нет. У корпоративной организации может не быть своих пользователей: пользователи платформы с адресом корпоративного домена могут действовать как её пользователи. Пользователь платформы может быть администратором корпоративного проекта, и его можно сделать администратором организации корпоративной организации («Изменить организацию»).
flowchart TB
subgraph cloud ["Облачная организация, например acme"]
c_sr[Менеджер по продажам — обязателен]
c_kam[Ключевой менеджер — по желанию]
end
subgraph corp ["Корпоративная организация"]
k_sr[Менеджер по продажам — по желанию,<br/>e-mail корпоративного домена]
k_none[Нет ключевого менеджера,<br/>её администратором и пользователями могут быть<br/>пользователи платформы с корпоративным e-mail]
end
t["Каждый проект: менеджер ресурсов и инженер поддержки,<br/>свои или назначенные организации"]
cloud --> t
corp --> tflowchart TB
subgraph cloud ["Облачная организация, например acme"]
c_sr[Менеджер по продажам — обязателен]
c_kam[Ключевой менеджер — по желанию]
end
subgraph corp ["Корпоративная организация"]
k_sr[Менеджер по продажам — по желанию,<br/>e-mail корпоративного домена]
k_none[Нет ключевого менеджера,<br/>её администратором и пользователями могут быть<br/>пользователи платформы с корпоративным e-mail]
end
t["Каждый проект: менеджер ресурсов и инженер поддержки,<br/>свои или назначенные организации"]
cloud --> t
corp --> t
На странице организации в её сведениях есть кнопки «Изменить», «В архив», «Вернуть из архива» и «+ Проект». Организацию можно отправить в архив, только когда все её проекты в архиве. Вместе с ней в архив уходят её пользователи: они не могут войти, теряют роли и открытые приглашения. Возврат организации из архива не возвращает её пользователей.
Проект можно перенести в другую организацию («Изменить проект» → «Перенести в другую»); перенос ждёт согласования (см. Согласования).
Пользователей организации приглашает администратор организации, менеджер по продажам или ключевой менеджер организации, менеджер ресурсов или супер-администратор, или они регистрируются сами (см. Регистрация организации). Администратор проекта может приглашать в свой проект пользователей проекта. У каждого проекта организации с пользователями есть администратор проекта; если его нет, им назначается пользователь организации (в первую очередь администратор организации).
У каждого пользователя есть город, вводимый текстом (обязателен во всех формах создания и изменения пользователя), и мобильный номер в международном формате, начиная с «+». Супер-администратор дополняет данные пользователя, ещё не принявшего приглашение, — e-mail, ФИО, мобильный, город — и задаёт его роли (администратор организации, только чтение, администратор выбранных проектов) в Администрирование → Пользователи → Организации.
Списки пользователей¶
Супер-администраторы видят всех пользователей в Администрирование → Пользователи, на двух вкладках: Платформа и Организации. Администратор организации видит пользователей организации в Организация → Пользователи. В каждом списке есть e-mail, имя, состояние (активен, заблокирован, приглашён, неактивен, в архиве) и роли; у пользователей организаций также организация и проекты. В Администрирование → Пользователи кнопка «архивные» (archived) добавляет пользователей в архиве.
«Пригласить» отправляет приглашение с ролями. Приглашение пользователя платформы с ролью супер-администратора запрашивает эту роль так же, как изменение чьих-либо ролей: остальные роли даются с приглашением, а роль супер-администратора — только когда согласится достаточно супер-администраторов (сразу, если супер-администратор один). Страницы технического администрирования не могут менять ничьи роли. Приглашения нельзя создавать или менять на страницах технического администрирования. Принятие приглашения само по себе никогда не делает человека супер-администратором: роль запрашивается и даётся, когда согласится достаточно супер-администраторов. Только первый супер-администратор, созданный из консоли при установке портала, получает роль вместе с приглашением. Страницы технического администрирования показывают людей и приглашения, но не меняют их: роли, e-mail, вход и двухфакторная аутентификация человека меняются только на собственных страницах портала. «Добавить» (супер-администраторы, когда это разрешено в Настройки → Платформа → Новые пользователи) создаёт запись без входа, чтобы пригласить позже. У каждого пользователя:
- «Отправить приглашение» / «Отправить приглашение снова» приглашает того, кто ещё не принял приглашение; «Пригласить снова» возвращает пользователя из архива только с ролями, выданными сейчас. Приглашённый снова входит как обычно, как только примет приглашение. Если его учётную запись заблокировали после отправки приглашения, она остаётся заблокированной. Возвращённая учётная запись сохраняет двухфакторную аутентификацию: приняв приглашение, человек задаёт новый пароль, а затем вводит код из приложения-аутентификатора (или использует ключ доступа), как при каждом входе;
- «Заблокировать» / «Разблокировать» закрывает или возвращает вход и ничего больше не меняет;
- роли — это флажки в строке пользователя; отметка «администратор проекта» запрашивает проекты;
- «В архив» убирает человека: без входа, без ролей, без открытого приглашения. Пользователи никогда не удаляются: пользователь в архиве сохраняется для учёта и истории ресурсов. Отправка супер-администратора в архив забирает роль супер-администратора, поэтому требует того же согласия, что и снятие роли: человек отправляется в архив, когда согласится достаточно супер-администраторов (сразу, если супер-администратор один). Страницы технического администрирования не могут блокировать, архивировать или удалять пользователей.
Портал не даёт заблокировать или отправить в архив последнего активного обладателя роли платформы (сначала передайте роль другому). Никто не блокирует и не архивирует свою учётную запись.
Список организаций показывает налоговый номер, тип, пользователей и проекты каждой организации, ожидающие согласования, её менеджера по продажам и ключевого менеджера, а также «регистрация ожидает» для ещё не согласованной организации.
Далее: Заказ и развёртывание, Согласования, Жизненный цикл проекта.