
Данный раздел описывает процесс входа в систему **Закрома.Диск**, типы ролей, их права, а также базовые операции по управлению пользователями и группами доступа.
## Авторизация

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

- поле для ввода логина;
- поле для ввода пароля;
- кнопку **Войти**.

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

> Аутентификация реализована с помощью сервиса Keycloak.

После авторизации в **Закрома.Диск** автоматически открывается последний проект, с которым работал пользователь.
###  Авторизация через SSO

В **Закрома.Диск** также доступен вход через корпоративную систему единой аутентификации (SSO).

Если для организации включена аутентификация через SSO, при входе в **Закрома.Диск** пользователь перенаправляется на корпоративную страницу авторизации. Для входа используются корпоративные учётные данные. После успешной проверки доступа пользователь автоматически возвращается в систему и получает доступ к своим проектам.

>[!warning] Если страница авторизации через SSO не открывается, необходимо обратиться к администратору для проверки настроек.
## Типы ролей и права доступа

В системе предусмотрены четыре основных типа ролей пользователей, каждая из которых определяет доступ к операциям в рамках проекта:

<table style="width: 100%; border-collapse: collapse;">
  <thead>
    <tr>
      <th style="width: 20%; text-align: left; padding: 6px;">Роль</th>
      <th style="width: 80%; text-align: left; padding: 6px;">Доступные действия</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td style="padding: 6px;"><b>Читатель</b></td>
      <td style="padding: 6px;">Просмотр файлов и структуры проекта. Без возможности изменения.</td>
    </tr>
    <tr>
      <td style="padding: 6px;"><b>Редактор</b></td>
      <td style="padding: 6px;">Чтение, переименование, удаление файлов и папок.</td>
    </tr>
    <tr>
      <td style="padding: 6px;"><b>Владелец</b></td>
      <td style="padding: 6px;">Все права редактора, а также управление доступом и настройками проекта.</td>
    </tr>
    <tr>
      <td style="padding: 6px;"><b>Администратор</b></td>
      <td style="padding: 6px;">Полный доступ ко всем проектам. Может управлять пользователями и ролями.</td>
    </tr>
  </tbody>
</table>


> [!warning] Права доступа устанавливаются на уровне проекта. Установка прав доступа к отдельным папкам или файлам **не поддерживается**.

Настройка прав доступа осуществляется при создании проекта или через его контекстное меню. Владелец проекта может открыть управление доступом, выбрать пользователей или группы и назначить им соответствующие роли.
## Управление пользователями и группами

Управление доступом выполняется через интерфейс **Закрома.Диск**, в связке с системой Keycloak.

Чтобы назначить роли пользователям (на уровне проекта):

1. Наведите курсор на проект в списке.
2. Нажмите на иконку контекстного меню `...`.
3. Выберите **Настройки доступа**.
4. Добавьте пользователя или группу.
5. Назначьте одну из ролей: *Читатель*, *Редактор*, *Владелец*. 
6. При смене пользовательской роли также доступен вариант **Закрыть доступ**.

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

>Только пользователи с ролью *Владелец или Администратор системы* могут управлять доступом других участников.





Как войти в систему и управлять правами пользователей

Авторизация и доступ

Работа с Диском

Хранение данных в **Закрома.Диск** осуществляется в **Проектах**. В каждом проекте пользователь работает с папками и файлами, которые расположены в виде дерева. 
Внутри проекта пользователь может разграничивать доступ, создавать папки, загружать и просматривать файлы и их историю.

## Создание проекта

Создание проекта доступно из главного интерфейса. Для этого предусмотрена кнопка `Создать проект`, расположенная под списком существующих проектов.

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

1. Нажмите `Создать проект`.
2. В открывшейся форме укажите:
   - Название проекта (обязательное поле);
   - Бакет, с которым будет связан проект (выбирается из выпадающего списка) или создается новый;
   - Включить или не включать версионирование (если такая опция отображается);
   - Имя бакета S3 (если необходимо создать новый).
   - Сколько дней необходимо хранить версию файлов. Если нужно убрать ограничение на количество версий, установите 0.
1. Нажмите `Сохранить`. 

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

После сохранения проект отобразится в общем списке.

## Настройки и удаление проекта

Каждое название проект сопровождается иконкой контекстного меню `...`.

Выбор строки меню **Удалить** — удаляет проект. Действие необратимо и требует подтверждения.  

Выбор строки меню **Настройки** открывает окно **Параметры проекта**, в котором можно изменить название проекта, а также добавлять, удалять или изменять теги. 

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

> Всплывающее окно с информацией о бакете позволяет администратору быстро уточнить наименование бакета, связанного с проектом. 
#### Настройки

Окно «Параметры проекта» включает несколько вкладок:

1. **Настройки проекта** – здесь указывается:
    - _Наименование проекта_
    - _Теги проекта_ – ключевые слова, которые помогают систематизировать и ускорять поиск данных. Для добавления тега нажмите иконку `+`.
        Теги могут редактироваться и удаляться, возможно использовать цветовую маркировку тега для наглядности.

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

2. **Настройки доступа** – управление пользователями и их правами:
    - Пользователям можно назначать роли: *Читатель, Редактор*, *Владелец*.
    - Пример: пользователь "admin" имеет права *Владельца*, а "techwritter" – *Редактора*.
    - Доступ можно выдавать как отдельным пользователям, так и целым группам.
    
![image](https://storage.yandexcloud.net/zakroma-ru/media/38066d4e5c2e510fb3531c78202f272d.png)    

3. **Настройки бакета** – определяются параметры хранения:
    - **Версионирование** – возможность хранить несколько версий одного файла.
    - **Ограничение** количества хранимых версий.
    - **Квота** – максимальный объём данных, доступный для проекта.  При необходимости квота может быть изменена или снята.

![image](https://storage.yandexcloud.net/zakroma-ru/media/72e78cb4cba505de13b1390ce9dd9578.png)
## Информация о бакете

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

Бакет определяет уровень хранения данных, наличие версионирования, а также технические параметры.  
Выбор бакета осуществляется при создании проекта и отображается в интерфейсе.

> [!warning] После создания проекта изменить связанный с ним бакет невозможно.

> [!info] Управление бакетом S3
> О том как управлять бакетом, Вы можете почитать в документации по [Закрома.Хранение](https://zakroma.ru/knowledgeBase/storage/article/buckets)

## Доступ к проекту

Доступ к проекту управляется через то же контекстное меню — пункт **Настройки доступа**.  
Пользователь с достаточными правами может:

- просматривать список участников проекта;
- назначать роли;
- добавлять пользователей и группы.

Подробности — см. раздел [Авторизация и доступ](https://zakroma.ru/knowledgeBase/disk/article/access?version=1.3).

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

В верхней части списка доступных проектов есть строка поиска. Достаточно ввести часть названия проекта (без учёта регистра), и список сразу отфильтруется. Это позволяет быстрее находить нужный проект среди большого количества доступных.

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

Проекты

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

## Структура и отображение

Пользователь может выбрать удобный вариант просмотра содержимого:
- **Список** — компактный режим, где отображаются все файлы и папки с деталями (имя, дата, размер). Удобен для работы с большим количеством объектов.
- **Плитка** — наглядный режим, где элементы показаны в виде карточек с иконками или превью. Подходит, если важно быстро ориентироваться по визуальному виду файла (например, изображений или документов).
Переключение между режимами выполняется с помощью кнопок ![image](https://storage.yandexcloud.net/zakroma-ru/media/26fe28afd631b7947f6c3b4e4ae0eaee.png)в правом верхнем углу области списка.

В каждой строке присутствует:

- для папок:
  - название объекта
  - иконка удаления `корзина`
  - иконка контекстного меню `...` для действий: *переименовать, переместить, копировать*. 

- для файлов:
  - название объекта
  - дата последнего изменения
  - размер 
  - автор 
  - иконки действий (*скачать файл, детали, удалить*)
  - иконка контекстного меню `...` для действий: *переименовать, переместить, копировать*.

![image](https://storage.yandexcloud.net/zakroma-ru/media/a27090ef526fe99f2ad1bb0cae729245.png)
На разных устройствах (особенно на экранах с небольшой диагональю) пользователям может быть неудобно работать с таблицей в стандартном виде. Иногда какие-то столбцы оказываются неважными, а другие, наоборот, требуют больше места для комфортного просмотра. Поэтому система позволяет настраивать таблицу под себя, нажатием на иконку ![image](https://storage.yandexcloud.net/zakroma-ru/media/94ae736e9223bf41917266346164a8f0.png):
- скрывать ненужные поля;
- изменять ширину столбцов, чтобы они занимали оптимальное пространство;
- расставлять приоритеты в отображении данных.

![image](https://storage.yandexcloud.net/zakroma-ru/media/3c56e061f1fa3ac73890730ec34f3f20.png)
## Создание файлов и папок

>Функция доступна пользователям с ролями *Редактор, Владелец* или *Администратор* в рамках проекта, в котором создаётся папка.

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

Для создания новых элементов используйте кнопку `Создать`. Система предложит следующие варианты:

- **Создать папку** — позволяет добавить новую папку в текущем разделе.
- **Создать документ** — создаёт новый файл прямо в системе.

Если выбрать пункт **Создать документ**, откроется список доступных форматов:

- OpenDocument Format (`.odt`)
- Microsoft Word (`.docx`)
- OpenDocument Presentation (`.odp`)
- Microsoft PowerPoint (`.pptx`)
- OpenDocument Spreadsheet (`.ods`)
- Microsoft Excel (`.xlsx`)
- Markdown (`.md`)    

После выбора формата система создаст новый документ, который сразу будет доступен для редактирования и дальнейшей работы.

Для создания папки выберите пункт **Создать папку**. В открывшемся окне введите название папки и нажмите `Создать`. После этого папка отобразится в текущем каталоге.

![image](https://storage.yandexcloud.net/zakroma-ru/media/52a8c2dfdfd744cdafb92b8c8277475e.png)
## Загрузка файлов

Чтобы добавить данные в систему, нажмите кнопку `Загрузить`. В открывшемся меню доступны два варианта:

- **Загрузить файл** — если нужно добавить один или несколько файлов.
- **Загрузить папку** — если требуется загрузить целую папку со всем её содержимым. Структура директорий загруженной папки сохраняется.

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

Также для добавления файлов можно просто перетащить файл в область содержимого (поддерживается _drag & drop_). После загрузки файл появится в списке.

Система поддерживает загрузку файлов любых форматов.
## Предпросмотр

Для офисных документов и распространенных типов файлов доступен **предпросмотр** файла без скачивания. Для открытия файла нажмите на него в списке левой клавишей мыши.

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

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

Ниже представлены поддерживаемые для предпросмотра типы файлов:
#### Документы:

`docx, doc, pdf, txt, rtf, odt, pptx, xlsx, xls, csv`
#### PDF и текстовые файлы:

`pdf, txt, json`
#### Таблицы:

`xlsx, ods, csv, xls, xlw, xlt, xml, pxl, wb2, wq1`
#### Изображения:

`jpg, jpeg, png, gif, webp, bmp, svg`
#### Видео:

`mp4, webm`
#### Аудио:

`mp3, wav, ogg`
## Редактирование документов онлайн

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

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

**Как это работает:**
1. Выберите нужный файл в списке и кликните по нему. Для редактирования доступны файлы с расширениями `.xlsx` `.docx` `.pptx` `.ods` `.odt` `.odp` `.txt` `.md` и некоторые другие. 
2. Документ откроется в режиме **просмотра**.
3. Чтобы перейти к внесению изменений, нажмите кнопку `Редактировать` в верхней панели. Документ откроется в онлайн-редакторе. Здесь можно сразу вносить изменения в текст, форматирование и содержимое.
4. После нажатия кнопки `Закрыть редактирование` изменения сохраняются и документ остаётся доступен для дальнейшей работы.

**Дополнительные возможности:**
- Несколько сотрудников могут редактировать один и тот же файл одновременно.
- Система синхронизирует изменения и предотвращает конфликты — ваши правки не будут «переписаны» действиями коллег.
- При необходимости можно вернуться в режим просмотра или скачать актуальную версию документа.
## Детали

При нажатии на иконку `i` **Детали** пользователь видит всплывающее окно с вкладками: **«Информация»**, **«Поделиться»**, **«Версии»**, **«Комментарии»**.

![image](https://storage.yandexcloud.net/zakroma-ru/media/e94eb7495934a32712599db97c5f259b.png)
### Информация

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

- **Название файла**  
  Отображается имя файла, например: `2025.png`.
- **Размер**  
  Указывается вес текущей версии файла, например: `1.62 MB`.
- **Дата загрузки**  
  Показывается точное время и дата добавления файла в систему, например: `28.03.2025, 12:43`.
- **Автор**  
  Имя пользователя, загрузившего файл.
- **MIME-тип**  
  Тип содержимого файла, например: `image/png`.
- **Полный путь**  
  Указывается путь до файла в структуре папок, например:  
  `/tech-writter/Первая папка/folder 2/2025.png`.
- **Теги**  
  Пользовательские метки, которые можно добавлять для быстрой фильтрации и поиска.
### Комментарии

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

Функционал вкладки включает:

- **Добавление комментария**  
  В текстовое поле вводится сообщение, после чего оно сохраняется с указанием автора, времени и версии файла.
- **Привязка к версии**  
  Каждый комментарий отображается с пометкой, к какой версии файла он относится.
- **Режим «Показывать только мои»**  
  Позволяет скрыть чужие записи и видеть только собственные комментарии.
- **Ответ на комментарий**  
  Под каждым сообщением доступна кнопка `Ответить`, что упрощает ведение диалога.

> Вкладка **«Комментарии»** помогает команде обмениваться контекстной информацией без использования сторонних чатов или почты.
### Версии

Если проект привязан к бакету с включённым режимом **версионирования**, система автоматически сохраняет все загруженные версии файла.

Как открыть историю:

1. Откройте папку, содержащую необходимый файл, нажмите иконку `i` **Детали**
2. В открывшемся окне выберите вкладку **«Версии»****;
3. В открывшемся окне отобразятся все сохранённые версии: дата, размер, автор;
4. Доступны действия:
   - скачать версию;
   - скопировать внутреннюю ссылку;
   - скопировать файл в другую папку;
   - удалить версию.

>История доступна только для файлов, загруженных в проект с активированным версионированием. Это настраивается через бакет при создании проекта.

## Поделиться 

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

Во вкладке **«Поделиться»** доступны следующие опции:

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

- **Скопировать внутреннюю ссылку**  
  Используется для обмена файлами внутри проекта. Такая ссылка работает только у авторизованных пользователей, имеющих доступ к текущему проекту или папке. Это обеспечивает дополнительную защиту и контроль доступа к корпоративным данным.

> При необходимости публичную ссылку можно деактивировать - после этого доступ по ней будет закрыт.
#### Как сгенерировать ссылку:

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

1. Откройте папку, содержащую необходимый файл, нажмите иконку `i` **Детали**
2. В открывшемся окне выберите вкладку **Поделиться**;

При выборе варианта **внутренняя ссылка** система покажет ссылку, которую можно скопировать. 
При выборе варианта **публичная ссылка** установите, при необходимости, дату и время окончания действия ссылки - не более 168 часов (8 дней). Далее система отображает окно с:

- сгенерированной короткой ссылкой;
- QR-кодом, ведущим по этой ссылке;
- кнопками для копирования ссылки или QR-кода.

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

Пользователь, получивший эту ссылку, сможет скачать файл на своё устройство без авторизации.

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


Работа с файлами, папками и версиями в интерфейсе Закрома.Диск

Файлы и папки

Обзор системы Закрома.Диск и её ключевых возможностей

Общее описание

Первые шаги пользователя в системе Закрома.Диск

С чего начать

Как подключить хранилище как сетевой диск в Windows

Подключение WebDAV

Ответы на популярные вопросы по работе с системой