С внешним S3-хранилищем

В данном документе представлен процесс подключения внешнего S3-хранилища.

Документ предназначен для использования системными администраторами.

• Host-style доступ к объектам: http(s)://<host>/<bucket>/<key>.

• AWS Signature Version 4 (SigV4).

• На стороне S3-провайдера не должно быть ограничений на количество объектов внутри бакета.

• Диск позволяет пользователям загружать файлы размером до 100 ГБ. Ваш S3 должен поддерживать такую загрузку через MultipartUpload.

• Поддержка следующих методов API:

  • PutObject

  • CreateMultipartUpload

  • CompleteMultipartUpload

  • UploadPart

  • AbortMultipartUpload

  • HeadObject

  • GetObject, включая Range-запросы

  • DeleteObject

  • DeleteObjects

  • CopyObject

  • ListObjectsV2

Чтобы настроить отправку вложений чатов/групп во внешнее хранилище S3, выполните шаги, представленные ниже.

1. Перейдите в веб-интерфейс установщика VK WorkSpace по адресу http://<company_domain>:8888.

2. На главной странице нажмите Проекты и выберите vkteams.

   

3. В списке настроек нажмите на files и заполните параметры для подключения внешнего S3-хранилища:

   • S3AccessKey — ключ доступа.

   • S3Host — указывает доменное имя (эндпоинт) внешнего S3-хранилища.

   • S3Region — параметр, указывающий географический регион (дата-центр), в котором физически расположен бакет с данными.

   • S3SecretKey — секретный ключ доступа.

   • active_since — указывает, начиная с какой даты/времени файлы должны взаимодействовать с S3.

   • Кэш файлов – включает кеширование файлов для превью.

   • crashUploadS3Bucket — переменная, которая указывает название бакета в S3-хранилище, предназначенного для сбора и хранения отчетов о сбоях (крэш-логов).

   • customS3CaCert — SSL/TLS-сертификата (в формате PEM) для безопасного подключения к S3-хранилищу.

   • customS3CaEnabled — активирует или деактивирует использование пользовательского SSL/TLS сертификата для подключения к S3-хранилищу.

   • filesS3Bucket — целевой бакета, для автоматической загрузки и импорта файлов.

   • SIEM. Включить логи – включение/выключение системы сбора и анализа логов безопасности.

   • SIEM. Включить логирование чек-суммы – включение/выключение записи контрольной суммы (хэш-суммы) файла в лог аудита SIEM при каждой операции с вложением в S3-хранилище.

   • max_sticker_size — задает максимальный разрешенный размер файла (в байтах), загружаемого пользователем в бакет.

4. Нажмите Сохранить настройки.

5. На главной странице в веб-интерфейсе установщика нажмите на VK Teams для просмотра списка ролей.

6. В списке ролей найдите роль files1, перейдите в настройки, нажав , и запустите шаг up_container для применения изменений.

Технический писатель: Дерябин Дмитрий