Файловый Сервис
Инфраструктурный файловый сервис Атомкод предназначен для взаимодействия с файловым хранилищем. Файловый сервис при получении запроса производит изменения на сервере MiniO (протокол S3) и регистрирует изменения в БД: добавляет и удаляет записи в таблице структур хранений или таблице объектов.
Для корректной работы сервиса должен быть запущен сервер MiniO.
Методы API файлового сервиса используются для:
- CRUD операций для структур хранений (Bucket) с занесением информации в БД;
- CRUD операций для объектов (Object) с занесением информации в БД;
- Скачивания объектов;
- Генерации ссылок для скачивания объектов.
Подробнее о структурах хранения в MiniO можно прочитать здесь.
Необходимые параметры конфигурации приведены в таблице ниже.
| Параметр | Описание | Формат значения | Пример |
|---|---|---|---|
| MinIO:Endpoint | Адрес Endpoint сервера MiniO | string | http://127.0.0.1:9000 |
| MinIO:Login | Логин пользователя для доступа к MiniO | string | minioadmin |
| MinIO:Password | Пароль пользователя для доступа к MiniO | string | minioadmin |
| FileParam: FileBlackList | Список запрещённых расширений файлов | string | exe |
| FileParam: FileWhiteList | Список разрешённых расширений файлов | string | txt,pdf,jpg,png,zip |
| FileParam: SizeListInMb | JSON с параметрами максимального размера файла для каждого типа (в МБ). Доступные типы данных используются из FileParam: FileWhiteList | string | { "types": [ { "typename": "exe", "maxfilesize": "15" }, { "typename": "docx", "maxfilesize": "2" }, { "typename": "xlsx", "maxfilesize": "10" }, { "typename": "csv", "maxfilesize": "2" } ] } |
| FileParam: MaxSizeInMb | Максимально разрешённый общий размер файла (в МБ) | int | 100 |
| CheckRightType | Тип проверки прав Security (Basic или BucketsAndObjects) | string | BucketsAndObjects |
| UserNameSpace | Namespace Security пользователей | string | User |
| SecureNameSpace | Namespace файлов и бакетов в Security | string | Files |
| UrlOptions: ChangeUrlPrefix | Параметр, регулирующий, нужно ли менять префикс ссылки для скачивания объекта (по умолчанию true) | bool | true |
| UrlOptions:UrlPrefix | Префикс генерируемых ссылок (по умолчанию /fss) | string | /fss |
| X-Amz-Expires | Время жизни сгенерированных ссылок (в секундах) | int | 86400 |
Для мониторинга файлового хранилища используется сервис диагностики хранилища.
Доступ к объектам файлового сервиса
Чтобы пользователь мог корректно использовать объекты ф айлового сервиса, этот пользователь должен быть включен в профиль System.Fileservice.
Чтобы дать права пользователю на использование объектов файлового сервиса следует:
- перейти в административную консоль в раздел Security на вкладку Namespace;
- выбрать namespace User и перейти в него;
- выбрать из списка пользователей пользователя, которому требуется назначить права на работу с объектами файлового сервиса;
- нажать на пользователя или на значок Карандаш справа в строке пользователя и в открывшейся карточке Edit Subject перейти на закладку Member Of;
- нажать на значок + для добавления профиля в список Member Of List;
- ввести FilesService в окно поиска в открывшемся списке Select Element;
- нажать кнопку Save Subject.
Теперь пользователь может использовать объекты файлового сервиса.