## Назначение
Группы пользователей позволяют централизованно управлять доступом к различным функциям системы. Они бывают двух типов:

- **Системные группы** – глобальные, действующие на уровне всей системы.
- **Локальные группы** – привязаны к конкретной рабочей области или бакету и управляют доступом только в рамках этих ресурсов.

Состав групп можно задавать вручную в системе **ЗАКРОМА.Хранение** или синхронизировать через Keycloak для интеграции с внешними системами управления доступом.
## Добавление группы пользователей

Чтобы создать новую группу пользователей, выполните следующие действия:

1. Перейдите в раздел **«Пользователи»** → выберите вкладку **«Группы пользователей»**.  
2. Нажмите кнопку **`Добавить группу`**.  
3. В открывшемся окне **Создание группы пользователей** заполните форму в зависимости от типа создаваемой группы.

![image](https://storage.yandexcloud.net/zakroma-ru/media/c14e917ae83ea99511101817e08ec5af.png)
### Вариант 1. Группа без синхронизации с Keycloak

1. Убедитесь, что переключатель *Синхронизировать с группой Keycloak* установлен в положение `Выкл`.  
2. Заполните поля:
   - **Наименование:** введите имя группы, например `new-group`.  
   - **Описание:** добавьте пояснение, например `Отдел продаж`.  
   - **Пользователи:** выберите участников группы из выпадающего списка.

3. Нажмите кнопку **`Сохранить`**.  
   После сохранения группа появится в списке **«Группы пользователей»**.

> [!success] Пример
> **Синхронизация:** `Выкл`  
> **Наименование:** `new-group`  
> **Описание:** `Отдел продаж`  
> **Пользователи:** `akabehova`, `anenahov` и ещё 3

### Вариант 2. Группа, синхронизируемая с Keycloak

1. Установите переключатель *Синхронизировать с группой Keycloak* в положение `Вкл`.  
2. Заполните поля:
   - **Наименование:** укажите имя группы в системе **ЗАКРОМА**, например `new-group`.  
   - **Описание:** добавьте пояснение, например `Отдел маркетинга`.  
   - **Наименование группы Keycloak:** введите имя существующей группы в Keycloak, например `group1`.
3. Нажмите кнопку **`Сохранить`**.

После сохранения система автоматически синхронизирует состав группы с указанной группой в Keycloak.  Изменения участников или параметров в Keycloak будут автоматически отражены в системе **ЗАКРОМА.Хранение**.

> [!success] Пример
> **Синхронизация:** `Вкл`  
> **Наименование:** `new-group`  
> **Описание:** `Отдел маркетинга`  
> **Наименование группы Keycloak:** `group1`

> [!note] Примечание
> Созданные группы можно использовать при назначении **политик доступа** и ролей **администраторов** на уровне рабочей области или бакета.

## Изменение группы пользователей 
1. Нажмите на иконку `>` группы пользователей, которую вы хотите отредактировать.
2. В развернутой карточке группы все поля доступны для редактирования.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/7619688f72e56780b0a397ec7a300e88.png)

3. Внесите необходимые изменения.    

>[!info] Наименование LDAP-группы
>При смене значения переключателя *Синхронизировать с группой Keycloak* со значения `Выкл` на `Вкл` необходимо заполнить обязательное поле *Наименование группы Keycloak*.

4. Для сохранения изменений нажмите кнопку `Сохранить`, для отмены – `Отменить`.

>[!info] Ручное изменение состава
>Добавление и удаление пользователей возможно только при выключенной синхронизации с группой Keycloak.

## Добавление пользователей в группу

1. Нажмите на кнопку `+ Добавить пользователя`.  
2. В открывшемся модальном окне выберите пользователей из списка. 

![image](https://storage.yandexcloud.net/zakroma-ru/media/65789d49f6033bf6ac55caee80996769.png)

3. Нажмите на кнопку `Добавить`, для отмены – `Отменить`.

### Удаление пользователей из группы

Удалить пользователей из группы можно двумя способами — массово или выборочно.

![image](https://storage.yandexcloud.net/zakroma-ru/media/f86bd38cc61c6e10bee3b632f1282262.png)
#### Вариант 1. Массовое удаление пользователей

1. Отметьте нужных пользователей, установив галочки в чекбоксах слева от их логинов (пример показан на скриншоте под номером **1**)
2. Нажмите кнопку **`Удалить выбранное`** над списком пользователей.
3. Подтвердите действие в открывшемся окне.

> [!info] Примечание  
> После удаления выбранные пользователи будут исключены из текущей группы, но их учетные записи сохранятся в системе.

### Вариант 2. Удаление отдельного пользователя

1. Найдите нужного пользователя в списке.  
2. Нажмите на иконку ![image](https://storage.yandexcloud.net/zakroma-ru/media/036fc8cdab36f01afe849e4f74919c00.png) справа от строки пользователя (пример показан на скриншоте под номером **2**)  
3. Подтвердите удаление в появившемся диалоговом окне.

> [!warning] Внимание  
> Если группа синхронизирована с Keycloak, удаление пользователя вручную будет невозможно.  
> В этом случае управление составом группы выполняется только через Keycloak.

>[!info] Для быстрого поиска пользователя можно воспользоваться строкой поиска по логину, а также настроить пагинацию.

## Удаление группы пользователей

Чтобы удалить группу пользователей, откройте список групп, наведите курсор на нужную группу, нажмите на иконку **`...`**, затем в контекстном меню выберите пункт **`Удалить`** и подтвердите действие.

![image](https://storage.yandexcloud.net/zakroma-ru/media/a14fbbc6ace6364b60b44eb2a2c6c8c7.png)

## Синхронизация группы пользователей

Группы пользователей, синхронизированные с **Keycloak**, позволяют автоматически обновлять свой состав в соответствии с одноимёнными группами, созданными в Keycloak.

На вкладке **«Группы пользователей»** для каждой синхронизируемой группы отображается **время последней синхронизации**.  
Эта информация помогает убедиться, что данные группы актуальны и совпадают с данными в Keycloak.

![image](https://storage.yandexcloud.net/zakroma-ru/media/a68fdc44b1f4917da96c1902d8237f51.png)
### Ручная синхронизация отдельной группы

Если требуется вручную синхронизировать конкретную группу:

1. Наведите курсор на нужную группу в списке.
2. Нажмите на иконку **`...`** справа от названия группы (пример показан на скриншоте под номером **1**)  
3. В контекстном меню выберите пункт **`Синхронизировать`**.

После выполнения операции система обновит состав группы в соответствии с данными из Keycloak.

### Синхронизация всех групп пользователей

Чтобы выполнить синхронизацию всех групп сразу:

1. Нажмите кнопку **`Синхронизировать`** в правом верхнем углу страницы (пример показан на скриншоте под номером **1**)  
2. Дождитесь завершения процесса — обновлённые данные отобразятся автоматически.


> [!warning] Важно
> Если при синхронизации возникла ошибка, группа пользователей будет подсвечена **жёлтым**.  
> Наведите курсор на значок **`i`** рядом с названием группы, чтобы просмотреть описание ошибки.  
>  
> Такие ошибки означают, что система не может подключиться к сервису **Keycloak** — он может быть временно недоступен или изменены параметры подключения.  
>  
> **Рекомендуется проверить состояние Keycloak и параметры интеграции**, чтобы восстановить корректную работу синхронизации.





Создание, редактирование и синхронизация групп пользователей системы

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

Доступ

## Назначение
Вкладка **«Администраторы»** предназначена для назначения пользователям ролей на уровне рабочей области или бакета.  
В зависимости от выбранной роли пользователю становятся доступны определённые действия.  
Ниже приведён полный перечень разрешений для каждой роли:

| Роль на уровне рабочей области | Роль на уровне бакета | Доступ |
| ------------ | ------------ | ------------ |
| Workspace-owner | Bucket-owner | Владелец - доступ к управлению |
| Workspace-maintainer | Bucket-maintainer | Редактор - доступ к редактированию политик доступа |
| Workspace-viewer | Bucket-viewer | Читатель - доступ только к просмотру |
## Управление

Для просмотра и настройки ролей перейдите на вкладку **«Рабочие области»** в главном меню и выберите необходимую рабочую область.

## Управление на уровне рабочей области

Для просмотра и управления ролями в выбранной рабочей области откройте вкладку **«Администраторы»**.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/6cacb45982bd6ad7e5f3ab3fde75dd69.png)
## Управление на уровне бакета

Для управления ролями на уровне бакета перейдите во вкладку **«Бакеты»**, выберите нужный бакет и откройте вкладку **«Администраторы»**.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/e5a9390eb800a1c7f4d442871d0c971e.png)

## Назначение роли

1. Нажмите кнопку **`+ Добавить доступ`**.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/db153898862f2e301d1cc7369bbcc7ea.png)

2. В поле *Роль пользователя* выберите значение из выпадающего списка.
3. В поле *Пользователь* или *Группа пользователей* выберите нужное значение из выпадающего списка.
4. Для сохранения назначения роли нажмите кнопку **`Сохранить`**, для отмены — **`Отменить`**.

> [!info] Наследование прав  
> Роли, назначенные на уровне рабочей области, также действуют на уровне бакета.  
> При этом одному пользователю можно назначить не более одной роли на каждом уровне.

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

Чтобы изменить роль пользователя, удалите текущую запись и назначьте новую роль.

### Удаление роли

Удалить назначенную роль можно двумя способами — массово или выборочно.

![image](https://storage.yandexcloud.net/zakroma-ru/media/ad2de372cd5b8c4677ea23745e4b7df6.png)

### Вариант 1. Массовое удаление ролей

1. Установите галочки напротив пользователей, чьи роли нужно удалить (пример показан на скриншоте выше под номером **1**)  
2. Нажмите ссылку **`Удалить выбранное`** над таблицей.  
3. В появившемся окне подтвердите действие.  

Этот способ удобен, если требуется удалить несколько записей одновременно.
### Вариант 2. Удаление роли у конкретного пользователя

1. Найдите нужного пользователя в списке.  
2. Нажмите на иконку **`корзина`** справа от его имени (пример показан на скриншоте выше под номером **2**)  
3. Подтвердите удаление в открывшемся окне.  

После подтверждения выбранная роль будет удалена, а пользователь потеряет соответствующие права доступа.

>[!info] Удаление владельца
>Пользователь с ролью владельца рабочей области не может удалять других пользователей с такой же ролью. Это может сделать пользователь с ролью `Суперадминистратор`.

# Доступы ролей
В таблице представлены доступы, которые есть у каждой роли.

|Доступ|Workspace-owner|Workspace-maintainer|Workspace-viewer|Bucket-owner|Bucket-maintainer|Bucket-viewer|
| :------------: | :------------: | :------------: | :------------: | :------------: | :------------: | :------------: |
|Просмотр рабочей области| **+** | **+** | **+** | **-** | **-** | **-** |
|Просмотр бакета| **+** | **+** | **+** | **+** | **+** | **+** |
|Удаление рабочей области| **+** | **-** | **-** | **-** | **-** | **-** |
|Удаление бакета| **+** | **-** | **-** | **+** | **-** | **-** |
|Редактирование администраторов рабочей области| **+** | **-** | **-** | **-** | **-** | **-** |
|Редактирование администраторов бакета| **+** | **-** | **-** | **+** | **-** | **-** |
|Работа с группами пользователей рабочей области| **+** | **-** | **-** | **-** | **-** | **-** |
|Работа с группами пользователей бакета| **+** | **-** | **-** | **+** | **-** | **-** |
|Редактирование политик доступа рабочей области| **+** | **+** | **-** | **-** | **-** | **-** |
|Редактирование политик доступа бакета| **+** | **+** | **-** | **+** | **+** | **-** |
|Добавление доступов в рабочей области| **+** | **-** | **-** | **-** | **-** | **-** |
|Добавление доступов в бакете| **+** | **-** | **-** | **+** | **-** | **-** |

Назначение и управление ролями администраторов в системе

Администраторы workspace/bucket

## Назначение

Фильтрация по IP позволяет **разрешить или ограничить доступ пользователей** к бакету на основании их IP-адресов.  
Настройка выполняется отдельно для каждого бакета и помогает защитить хранилище от несанкционированных подключений.
## Настройка фильтрации по IP

1. Перейдите в раздел **«Рабочие области»**.  
2. Выберите нужную рабочую область и бакет.  
3. Откройте вкладку **«Параметры»** в боковом меню.  
4. Пролистайте окно вкладки вниз до блока **Фильтрация по IP**.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/df6383c28f87c01a284e22b1606f4db1.png)
### Добавление разрешённого IP

1. В блоке **Разрешённый список** нажмите кнопку **`Добавить правило`**.  
2. Введите нужный IP-адрес в поле *IP адрес*.  
3. Поле *CIDR* заполнится автоматически.  
4. Нажмите кнопку **`Сохранить`**.
### Добавление запрещённого IP

1. В блоке **Запрещённый список** нажмите кнопку **`Добавить правило`**.  
2. Введите IP-адрес, которому необходимо запретить доступ.  
3. Нажмите кнопку **`Сохранить`**.

> [!warning] Важно  
> Один и тот же IP-адрес не может присутствовать в обоих списках.

### Удаление фильтрации по IP

1. Нажмите на иконку ![image](https://storage.yandexcloud.net/zakroma-ru/media/036fc8cdab36f01afe849e4f74919c00.png) напротив IP-адреса, который необходимо удалить.  
2. Подтвердите действие и нажмите кнопку **`Сохранить`**. 
3. IP-адрес будет удалён из списка, и правило фильтрации для него перестанет действовать.


Настройка разрешений и ограничений доступа по IP-адресам

Фильтрация по IP

## Назначение
Политики доступа предназначены для создания правил разграничения доступа пользователей к операциям S3.

Правило политики доступа - это набор S3-операций, разрешенных или запрещенных для пользователя или группы пользователей на уровне Рабочей области или Бакета.
## Управление правилами политики доступа
Для управления правилами политики доступа рабочей области перейдите на вкладку **Политики доступа** на странице просмотра Рабочей области.

![image](https://storage.yandexcloud.net/zakroma-ru/media/0fee704b5dfa9891cd2eba5d45803bbf.png)

Для управления правилами политики доступа бакета перейдите на вкладку **Политики доступа** на странице просмотра Бакета.

![image](https://storage.yandexcloud.net/zakroma-ru/media/41c506825824c38f12904b3ff729d115.png)

## Создание правила

1. Откройте вкладку **Политики доступа**.
2. Перейдите в раздел **«Рабочие области»** → выберите нужную область → вкладка **«Политика доступа»**.  Для настройки на уровне конкретного бакета откройте **«Бакеты»** → выберите бакет → вкладка **«Политика доступа»**.
3. Нажмите кнопку `Добавить политику`.

![image](https://storage.yandexcloud.net/zakroma-ru/media/65514941c3e154f4960816592c60c651.png)

3. В открывшемся окне **Создание правила** заполните поля:
   - **Наименование** — введите понятное название, например: `Доступ для редактирования`.
   - **Результат** — выберите действие:
     - `Разрешить` — чтобы предоставить доступ;
     - `Запретить` — чтобы ограничить.
   - **Пользователи / Группа пользователей** — выберите вариант:
     - `Все пользователи`;
     - `Выбрать пользователей / группу`, чтобы указать конкретных.
   - **Операции** — укажите доступные действия.  Чтобы разрешить все, включите чекбокс *«Все операции»*. Полный список операции см. в таблице ниже.
   - **Bucket** — имя бакета, к которому применяется правило. Поле недоступно для изменения.
   - **ObjectKey** — определите ключ или шаблон для объектов. Используйте `*` для всех объектов или задайте маску, например `/folder1/*`.  
3. Чтобы добавить связку **Bucket / ObjectKey**, нажмите кнопку `Добавить ресурс`.
4. После заполнения всех полей нажмите `Создать`.

> [!info] При выборе группы пользователей правило будет применено к каждому пользователю данной группы. Смотрите [подробнее о группе пользователей](https://zakroma.ru/knowledgeBase/storage/article/gruppy-polzovatelej-1?version=2.6).

### Использование маски

Для полей *Bucket* и *ObjectKey* работают маски:

| Символ | Назначение                                            |
| ------ | ----------------------------------------------------- |
| *****  | Заменяет любой набор символов в имени файла или папки |
| **?**  | Заменяет любой один символ                            |
| **/**  | В поле "ObjectKey" обозначает разделение по папкам    |

>[!info] Примеры масок
>Например, маска `/Folder/test.*` в поле *ObjectKey* будет действовать для объектов, находящихся в папке **Folder** с названием "test" и любым форматом.
Маска `???.doc` будет действовать для объектов, состоящих из трех любых символов в названии файла и форматом `doc`.

### Условия

После создания правила будет доступно добавление условия к правилу для некоторых операций.

![image](https://storage.yandexcloud.net/zakroma-ru/media/fd6df040f0032b4551b989dfe9d5f57c.png)

Для добавления условия:
1. Нажмите на кнопку `Добавить условие`.
2. Из выпадающего списка выберите параметр и оператор.
3. Введите значение
4. Для добавления еще одного и больше условий проделайте операцию повторно.
5. Для удаления условия нажмите иконку ![image](https://storage.yandexcloud.net/zakroma-ru/media/49091a73bcf40853827b3535476580bc.png) справа от условия.
6. Нажмите кнопку `Сохранить`.

> [!warning] Время на применение политик
> Политики вступают в силу с небольшой задержкой — примерно через 30 секунд после сохранения.

> [!example] Пример условия
> **Условие:** Ограничение на максимальное количество объектов, возвращаемых запросом *ListObjects*.  
> **Параметр:** `max-keys`  
> **Оператор:** Равно  
> **Значение:** `100`  
> **Результат:** Пользователь может запросить не более **100 объектов** за один раз.

### Полный список операций и условий

| Операция                | BucketName | ObjectKey | Условия                                    |
| ----------------------- | ---------- | --------- | ------------------------------------------ |
| AbortMultipartUpload    | +          | +         | -                                          |
| CompleteMultipartUpload | +          | +         | -                                          |
| CopyObject              | +          | +         | x-amz-copy-source; x-amz-tagging-directive |
| CreateBucket            | +          | -         | -                                          |
| CreateMultipartUpload   | +          | +         | -                                          |
| DeleteBucket            | +          | -         | -                                          |
| DeleteObject            | +          | +         | versionId                                  |
| DeleteObjectTagging     | +          | +         | versionId                                  |
| DeleteObjects           | +          | -         | -                                          |
| GetBucketVersioning     | +          | -         | -                                          |
| GetObject               | +          | +         | versionId                                  |
| GetObjectTagging        | +          | +         | versionId                                  |
| HeadBucket              | +          | -         | -                                          |
| HeadObject              | +          | +         | versionId                                  |
| ListBuckets             | -          | -         | -                                          |
| ListMultipartUploads    | +          | -         | -                                          |
| ListObjectVersions      | +          | -         | prefix delimiter max-keys                  |
| ListObjects             | +          | -         | prefix delimiter max-keys                  |
| ListObjectsV2           | +          | -         | prefix delimiter max-keys                  |
| ListParts               | +          | +         | -                                          |
| PutBucketVersioning     | +          | -         | -                                          |
| PutObject               | +          | +         | -                                          |
| PutObjectTaggin         | +          | +         | versionId                                  |
| UploadPart              | +          | +         | -                                          |

## Редактирование правила

1. Откройте вкладку `Политики доступа`.
2. Нажмите на правило, которое вы хотите отредактировать
3. Внесите изменения в правило.
4. Для сохранения правила нажмите кнопку `Сохранить`, для отмены кнопку `Отменить`.
## Удаление правила

1. Откройте вкладку `Политики доступа`.
2. Нажмите на иконку `...` контекстного меню справа от названия правила. 

![image](https://storage.yandexcloud.net/zakroma-ru/media/a8b5ffb209d821ae61a0b98a0c749be8.png)

3. Нажмите кнопку `Удалить` и подтвердите удаление в открывшемся окне.

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

Политики доступа

Управление пользователями выполняется через **Keycloak**.  
В административном интерфейсе **ЗАКРОМА.Хранение** можно просматривать информацию о пользователях и **генерировать ключ доступа (Secret key)** для работы с данными по протоколу **S3**.  

Подробнее о настройке групп пользователей см. раздел [«Группы пользователей»](https://zakroma.ru/knowledgeBase/storage/article/gruppy-polzovatelej-1?version=2.6).

## Просмотр списка пользователей

1. Перейдите в раздел **«Пользователи»** на боковой панели.  
2. Убедитесь, что выбрана вкладка **«Пользователи»**.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/d7b6e8532cf889f769afc90f2b5cc4cb.png)

На странице отображается список всех пользователей, синхронизированных с **Keycloak**, с указанием следующих данных:
- **Логин**  
- **Имя пользователя**

Для быстрого поиска нужного пользователя используйте строку поиска по логину.  
## Синхронизация пользователей

Список пользователей обновляется автоматически через заданные интервалы, указанные в конфигурации приложения.  
Чтобы выполнить синхронизацию вручную, нажмите кнопку **`Синхронизировать`** в правом верхнем углу страницы.

> [!info] Примечание  
> При синхронизации система загружает актуальные данные о пользователях из **Keycloak**.

## Добавление пользователя

1. Создайте пользователя в **Keycloak**.  
2. Дождитесь автоматической синхронизации данных или выполните её вручную.  
3. После синхронизации пользователь появится в списке **«Пользователи»** административной консоли **ЗАКРОМА.Хранение**.

## Просмотр карточки пользователя

1. Перейдите на страницу **«Пользователи»**.  
2. Нажмите на строку с нужным пользователем, чтобы открыть его карточку.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/42adc51c5fdc763c850e88830778e256.png)

В карточке пользователя отображается:
- **Логин**  
- **Фамилия и имя**  
- **Права доступа** по рабочим областям и бакетам  

В карточке пользователя также можно [установить ключ доступа](https://zakroma.ru/knowledgeBase/storage/article/upravlenie-klyuchami-dostupa?version=2.6) и выдать [право суперпользователя](https://zakroma.ru/knowledgeBase/storage/article/profil-polzovatelya?version=2.6).


Просмотр, синхронизация и управление пользователями

Пользователи

## Назначение

В профиле пользователя вы можете просматривать логин и ФИО авторизованного пользователя, а также устанавливать ключ доступа (*Access key* и *Secret key*).
## Просмотр логина и ФИО пользователя

1. В правом верхнем углу нажмите на Профиль пользователя
2. На открывшейся странице отобразится логин и ФИО пользователя, под учетной записью которого вы сейчас авторизованы

![image](https://storage.yandexcloud.net/zakroma-ru/media/4027deae9d5b7ffe7343c7df83824351.png)

3. Чтобы изменить параметры своего ключа доступа, нажмите на кнопку `Установить ключ доступа`

>[!info] Подробно ознакомиться с процессом установки ключа доступа можно в статье ["Управление ключами доступа"](https://zakroma.ru/knowledgeBase/storage/article/upravlenie-klyuchami-dostupa?version=2.6).

Просмотр профиля пользователя

Профиль пользователя

## Назначение

Роли предназначены для создания профилей разграничения прав пользователей.  
Роль — это набор разрешений, который может быть назначен пользователю или группе пользователей на уровне системы.

## Управление ролями

Для настройки ролей перейдите в раздел **«Роли»** в главном меню.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/f2c2520829ebda1f882564906ed9ea9c.png)
## Создание роли

1. Перейдите в раздел **«Роли»**.  
2. Нажмите кнопку **`Создать роль`**. 

![image](https://storage.yandexcloud.net/zakroma-ru/media/f219b5837e32b51b00eaf1639b923bb4.png)

3. Введите *Наименование* роли.  
4. Введите *Описание* роли.  
5. Для сохранения нажмите кнопку **`Сохранить`**, для отмены — **`Отменить`**.
## Добавление разрешений

1. Перейдите в раздел **«Роли»**.  
2. Нажмите на роль, к которой хотите добавить разрешение.  
3. В блоке **Разрешения** выберите разрешение из выпадающего списка нажмите кнопку **`Добавить разрешения`**.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/4c3920bdc415db6e5d2c9c1c53a329a8.png)

4. Выберите из списка необходимые разрешения.  Добавленные разрешения отобразятся в таблице ниже.  
5. Для удаления разрешения нажмите на иконку ![image](https://storage.yandexcloud.net/zakroma-ru/media/036fc8cdab36f01afe849e4f74919c00.png) напротив строки и  .  
6. Покиньте страницу — изменения сохраняются автоматически.

### Доступные разрешения

| **Наименование**      | **Действие**                                     |
| --------------------- | ------------------------------------------------ |
| **clusters**          | Доступ к информации о кластерах                  |
| **monitors**          | Полный доступ к мониторам                        |
| **operations**        | Чтение истории операций                          |
| **operations-delete** | Очистка истории операций                         |
| **roles**             | Полный доступ к управлению ролями                |
| **storages**          | Полный доступ к управлению хранилищами           |
| **users**             | Полный доступ к управлению правами пользователей |
| **webhooks**          | Полный доступ к управлению webhooks              |

## Редактирование роли

1. Перейдите на страницу **«Роли»**.  
2. Нажмите на роль, которую необходимо отредактировать.  
3. Измените нужные поля.  
4. Покиньте страницу — изменения сохраняются автоматически.

## Удаление роли

1. Перейдите на страницу **«Роли»**.  
2. Нажмите на иконку **`корзина`** напротив роли.  
3. В появившемся окне нажмите **`Да`** для подтверждения действия.  

## Назначение роли

1. Перейдите на страницу **«Роли»**.  
2. Нажмите кнопку **`Назначить роль`**.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/c997c3edbfe13e762865a7d8426917c9.png)

3. В открывшемся окне выберите вкладку:
   - **Пользователи** — для назначения роли отдельному пользователю;  
   - **Группа пользователей** — для назначения роли группе. Подробнее см. раздел [«Группы пользователей»](https://zakroma.ru/knowledgeBase/storage/article/gruppy-polzovatelej-1?version=2.6).
3. Выберите пользователя или группу из списка.  
4. Для сохранения нажмите кнопку **`Сохранить`**, для отмены — **`Отменить`**.

Если у пользователя не назначена ни одна роль, при входе в систему отображается пустая страница.

## Право суперпользователя

Пользователь с правом **суперпользователя** имеет доступ ко всем вкладкам меню и ко всем рабочим областям.  
Создание рабочей области доступно только при наличии этого права.

Чтобы выдать право суперпользователя:

1. Перейдите на страницу **«Пользователи»**.  
2. Откройте карточку нужного пользователя.  
3. Активируйте переключатель *Права суперпользователя*.  

Чтобы отозвать право суперпользователя — деактивируйте переключатель.

> [!warning] Нельзя отозвать право суперпользователя у текущего авторизованного пользователя.


Создание, настройка и назначение ролей пользователей системы

Роли

## Назначение

Временные ключи доступа используются для авторизации по протоколу **S3**.  
Доступ можно установить на ограниченное или неограниченное количество времени.  Работа с ключом доступа возможна в [профиле пользователя](https://zakroma.ru/knowledgeBase/storage/article/profil-polzovatelya?version=2.6) или в [карточке пользователя](https://zakroma.ru/knowledgeBase/storage/article/polzovateli?version=2.6).
## Установление ключа доступа

Рассмотрим установление ключа доступа на примере карточки пользователя:

1. Перейдите в раздел **«Пользователи»** и выберите нужного пользователя.  
2. Нажмите кнопку **`Установить ключ доступа`**.  
   При нажатии откроется модальное окно.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/808b0ea71b925308943c3a76a6cdd764.png)

3. В открывшемся окне заполните обязательное поле *Идентификатор ключа*.  
4. Введите значение в поле *Секретный ключ* (минимум 8 символов).  
   - Чтобы скопировать значение в буфер обмена, нажмите на иконку **копирования**.  
   - Чтобы показать или скрыть введённый ключ, используйте иконку **отображения**.  
   ![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/a1b5f75599d0176a48546182c05f2d53.png)
3. При необходимости укажите *Срок действия* ключа.  
   Оставьте поле пустым, если требуется создать бессрочный ключ.  
4. Для сохранения нажмите кнопку **`Установить`**, для отмены — **`Отменить`**.

> [!info] При установке нового ключа пользователя предыдущий ключ становится недействительным, независимо от ранее установленного срока его действия.

## Работа с ключом доступа в личном кабинете

Каждый пользователь может просмотреть и установить свой секретный ключ в личном кабинете.  

![image](https://storage.yandexcloud.net/zakroma-ru/media/dc436bdbefc26e9afcc4cd01ad34abcf.png)

- При установке ключа с бессрочным сроком действия он остаётся активным до создания нового.  
- Если указан ограниченный срок действия, в интерфейсе появится соответствующая отметка.  
  ![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/a372f21a7796cf409a8648e411372501.png)  
- После истечения срока запись подсвечивается **красным цветом**, а доступ по этому ключу становится недоступен.  
  ![image | 500](https://storage.yandexcloud.net/zakroma-ru/media/7ba5b151ba05edfa7e12b68c42823ed3.png)
## Работа с ключом доступа в карточке пользователя

Если пользователь имеет роль суперпользователя или роль с пермиссией *users*, он может установить ключ доступа, без права просмотра уже существующего ключа.

![image](https://storage.yandexcloud.net/zakroma-ru/media/087cd723d87ae038b364ff5fc673990a.png)

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


Создание и управление временными ключами доступа S3

Управление ключами доступа

Описание общей архитектуры решения и компонент

Архитектура решения

Первые шаги в приложении

Начало работы

Расчет требований к инфраструктуре

Требования

С чего начать

Установка Закрома.Хранение

Установка

Отслеживание задач и статуса системы

Мониторинг

Описание работы страницы с операциями

Операции

CLI (Command Line Interface, zcli)

Назначение и управление версионированием объектов в бакете

Версионирование

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

CORS

Работа с объектами внутри бакета

Просмотр бакета

Управление рабочими областями

Рабочие области

Управление воркерами и настройка шардирования данных бакета

Шардирование

Подключение ресурса хранения

Хранилища

Описание типов хранилищ

Типы хранилищ

Как создавать и настраивать бакеты

Бакет (bucket)

Удаление и восстановление бакетов в системе

Удаление бакета

Управление публичным доступом и видимостью объектов бакета

Публичные бакеты

Настройка хранения

Принцип работы кластерного режима

Мультикластер

Настройка конфигурации для kubernetes

Включение кластерного режима

Добавление кластера

Настройка конфигурации для пакетов

Управление

Путь хранения объектов бакета на подключенном хранилище

Формирование пути хранения данных

Механизм оповещения других систем о событиях в хранилище.

Webhooks

Правила жизненного цикла данных

Жизненный цикл

Как подключить хранилище с уже имеющимися данными в нем

Подключение хранилища с данными

Политика Зеркалирование позволяет настроить синхронную и асинхронную репликацию бакета

Зеркалирование

Политика Расширение позволяет объединить несколько ресурсов хранения

Расширение

Политики хранения

Перенос данных бакета из одного Хранилища в другое

Миграция данных

Отказоустойчивость

Описание возможностей масштабирования объёма хранения кластера

Масштабирование объёма хранения

Краткое описание схемы работы Erasure Coding

Поддержка методов AWS S3

Как загружать, скачивать, синхронизировать, удалять и просматривать объекты через S3 Browser

Пример работы c S3 через S3 Browser

Настройка подключения к Закрома Хранение

Подключение к Закрома.Хранение

Работа с S3 Browser

Использование

Что изменилось в приложении в текущем релизе