Изменения в документации

Размещены новые документы

• «Как работать с Ассистентом» — в документе описаны основные действия при работе с Ассистентом (сервис умного поиска информации в Мессенджере). Документ предназначен для конечных пользователей.

• «Включение Ассистента в распределенной инсталляции» — в документе описано включение и настройка Ассистента. Документ предназначен для администраторов.

• «Матрица совместимости продуктов VK WorkSpace» — в документе описана совместимость продуктов VK WorkSpace (Мессенджер, Почта, Диск, Доска) с системным ПО и сторонним ПО.

Инструкция по установке Мессенджера

Требования к инфраструктуре вынесены из инструкции по установке в отдельный документ «Требования к инфраструктуре Мессенджера».

Инструкция по подключению S3-хранилища

Добавлен раздел «Требования к S3-хранилищу».

Настройки Мессенджера

Добавлен раздел «Настройка ограничения редактирования и удаления сообщений».

Добавлен раздел «Включить расширенный набор реакций».

Развертывание и настройка сервисов групповых политик

Скорректированы разделы:

• «Включите политику доступности мини-аппов в приложении VK WorkSpace» – скорректированы настройки.

• «Включите политику запретов создания чатов/каналов в Мессенджер и ВКС» – скорректированы настройки.

• Из раздела обязательных чатов удалён шаг настройки сервиса Mchat-st.

Инструкция по обновлению Мессенджера

• Перед шагом «Запустите обновление» добавлено «Распределение продуктов Helm».
• Удалены плейбуки pre_upgrade и post_upgrade.
• Добавлены плейбуки ansible-vkteams-cluster и ansible-vkteams-puppet_modules (если их ещё нет).
• Добавлено предупреждение: во время обновления не используйте форсированное удаление подов (Ctrl+K / kubectl delete pod --force --grace-period=0), используйте плавное завершение (Ctrl+D).
• Добавлена информация: после обновления с 26.2 может не работать запись звонков — нужно удалить iprosmaps.teams.vk.com recorder и перевыкатить сервис recorder.

Примеры проблем и их решение

Добавлен раздел «Удаление образа из кэша registry».

Интеграция с Панелью администратора VK WorkSpace

Обновлена инструкция: настройки на стороне Мессенджера и ВКС переведены в веб-интерфейс установщика VK WorkSpace.

Инструкция по настройке SSO-аутентификации (Stroma, SWA)

Документы «Настройка SSO-аутентификации» и «Утилита SSO-CLI» объединены: справочник утилиты удалён, в инструкцию перенесён способ настройки через файл config.yaml.

Инструкция по интеграции с контроллером домена по протоколу LDAP

Добавлен раздел «Синхронизация статуса учетных записей с каталогом (AD/LDAP)».

Настройка ГОСТ TLS-шифрования

• Убрано упоминание ВКС.
• Добавлены разделы «Предварительные условия при включении ГОСТ TLS», «Действия в случае компрометации ключей или сертификата ГОСТ TLS», «Эксплуатация СКЗИ и требования безопасности».

Во всей документации удалено упоминание скрипта mon.sh. Вместо него используется сервис Grafana.

Инструкция по установке Мессенджера

Обновлена инструкция по установке Мессенджера в связи с релизом единого Установщика VK WorkSpace. Инструкции по установке на одну виртуальную машину и по установке кластера объединены в единую инструкцию по установке standalone-инсталляции и распределенной инсталляции.

Инструкция по настройке интеграции с DLP-системами

Добавлены настройки для отправки в DLP-систему информации о названии чата, количестве участников и списке участников — шаги 8 и 11 для проверки текстов и файлов соответственно.

Поддержка репликации данных Мессенджера

Скорректирован раздел «Проблемы с блокировкой повторного переключения ролей сервисов».

Как скачать Суперапп (инструкции для пользователей и администраторов)

Скорректированы способы скачивания Суперапп.

Инструкция по настройке SSO-аутентификации (Stroma, SWA)

• Удалены шаги 1, 2, 3.

• Добавлена настройка через веб-интерфейс установщика VK WorkSpace как основной способ.

• CLI и админ-панель описаны как запасные.

Развертывание и настройка сервисов групповых политик

• В Шаге 1 уточнена навигация.

• В разделе «Выполните предварительные действия» отредактирован Шаг 1 — настройка прав администратора переехала из конфигурационного файла в веб-интерфейс установщика, Шаг 4 переименован в «Настройте сервисы групповых политик» и вместо правки когфигурационного файла теперь настройка через веб-интерфейс установщика VK WorkSpace.

• Из шага «Разверните сервис Pacman» убраны первые три пункта.

Настройка Федерации

• Добавлен раздел «Получение tenantID без доступа к Панели администратора».

• Добавлен раздел «Как управлять правами пользователей Федерации».

• Вся настройка Федерации переведена из конфигов в веб-интерфейс установщика. Убраны ручные запуски установки и перезапуски сервисов.

Требования к каналам связи

• Раздел «Голосовые и видеозвонки» — правка UDP-портов переехала в веб-интерфейс установщика VK WorkSpace, удалена проверка подов.

• Раздел «Настройка трансляции UDP-трафика с белого IP-адреса на серый» и «Использование белого и серого IP для ВКС» — объединены в новый раздел «Настройка сетевых параметров звонков (UDP, IP)». Настройка через веб-интерфейс установщика VK WorkSpace.

• Добавлен раздел «Настройка функции шумоподавления» — новый переключатель в веб-интерфейсе установщика VK WorkSpace.

Инструкция по интеграции с АТС

• Вся интеграция с АТС переехала из конфигурационных файлов в веб-интерфейс установщика VK WorkSpace

• Удален Шаг 2. «Настройте сервис Sipgate».

В связи с релизом единого Установщика VK WorkSpace обновлены следующие документы:

• Настройки Мессенджера

• Работа с системой

• Настройка ГОСТ TLS-шифрования

• Инструкция по подключению к внешней системе мониторинга

• Инструкция по настройке интеграции с DLP-системами

• Инструкция по настройке интеграции с DLP-системами SearchInform и InfoWatch

• Инструкция по подключению S3-хранилища — Инструкция по подключению S3-хранилища Почты VK WorkSpace и Инструкция по подключению внешнего S3-хранилища объединены в единую инструкцию

• Инструкция по настройке интеграции с антивирусом

• Инструкция по интеграции с контроллером домена по протоколу LDAP

Размещен новый документ «Как установить связь чата Мессенджера с чатом MAX» — в документе описано, как создать связь между чатами приложений.

Вопросы и ответы. Эксплуатация

• Скорректирован FAQ «Как поменять владельца чата?».

• Добавлен FAQ «Как назначить пользователя администратором чата?».

Как работать в Мессенджере (для пользователей)

Скорректированы разделы:

• «Уведомления от чата/группы» — добавлена информация про уведомления о добавлении,вступлении и удалении участников в групповом чате.

• «Роли в группе или канале» — скорректирована информации о возможностях владельца.

По всему документу изменена роль «Создатель» на «Владелец».

Добавлен раздел «Статусы файлов».

Настройки Мессенджера (для администраторов)

Добавлены разделы:

• «Включить функциональность Retention Policy»

• «Включить Security-функции»

Настройка ГОСТ TLS-шифрования

Скорректирован раздел «Шаг 2. Обновите клиентские приложения» — обновлен пункт 1.

Скорректирован раздел «Шаг 4. Включите использование ГОСТ TLS-шифрования на клиентских приложениях» — скорректированы примеры регулярных выражений.

Развертывание и настройка сервисов групповых политик

• Удален раздел «Шаг 4. Настройте сервис Gbld-mchat» для настройки политики обязательных чатов и каналов.
• Добавлен раздел «5. Включите политику запретов создания чатов/каналов в Мессенджер и ВКС».

Настройка интеграции VK Teams и Почты VK WorkSpace

Скорректирован раздел «Шаг 9. Настройте CORS» — добавлена конфигурация для Доски VK WorkSpace.

Скорректирован раздел «Шаг 10. Настройте отображение сервисов в клиентском приложении VK Teams» — добавлена конфигурация для Доски VK WorkSpace.

Настройка Федерации

• Скорректирован раздел «Предварительные условия» — добавлена необходимость Python версии 3.0 и выше и менеджера пакетов pip.
• Добавлен раздел «Шаг 3. Получите скрипт для управления пользователями».
• Скорректирован раздел «1. Создайте файл с белым списком пользователей» — в шаге 2 добавлена команда для скрипта (для версии 26.1 и выше)
• Добавлен раздел «Как управлять правами пользователей Федерации»

Развертывание и настройка сервисов групповых политик

Добавлен раздел «5. Включите политику запретов создания чатов/каналов в Мессенджер и ВКС».

Инструкция по настройке интеграции с DLP-системами

Удалены настройки для интеграции с DLP-системами SearchInform и Zecurion.

Скорректирован раздел «Шаг 9. Настройте сервис Go-files» — добавлен пункт 5 для включения автоудаления.

Инструкция по настройке интеграции с DLP-системами SearchInform и InfoWatch

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

Групповые политики

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

Размещены новые документы

• Мессенджер. Общая информация — добавлено назначение продукта, основные понятия, описаны функциональные границы продукта для пользователя и администратора

• Как авторизоваться в Мессенджере

• Интерфейс управления

• Быстрый старт

• Глоссарий

Примеры проблем и их решение

Добавлен раздел «Блокировка целлов БД KUST» — описаны причины блокировки и способы, как разблокировать целлы БД.

Размещен новый документ «Инструкция по обновлению кластера Мессенджер и ВКС (на версию 25.3 и выше с версии 24.9 и выше)»

Настройка интеграции с Почтой VK WorkSpace

Скорректирован раздел «Шаг 10. Настройте отображение сервисов в клиентском приложении VK Teams» — добавлен пункт 3, скорректированы настройки секции services.config в пункте 4.

Инструкция по настройке Single Sign-On аутентификации

В раздел «Распространенные проблемы» добавлен способ решения ошибки на сервисе Front, которая может появиться, когда в инсталляции с SSO используются самоподписанные сертификаты.

Настройка ГОСТ TLS-шифрования

Раздел «Предварительные условия» дополнен уточняющей информацией о приобретении сертификатов ГОСТ TLS.

Требования к каналам связи

В документ добавлено два раздела: «Настройка трансляции UDP-трафика с белого IP-адреса на серый» и «Использование белого и серого IP для ВКС».

Инструкция по обновлению кластера Мессенджера и ВКС (на версию 25.3 и выше с версии 24.9 и выше)

В раздел «Перед обновлением» добавлена информация о том, что при обновлении с версии 25.3 и выше до 25.4 и выше нужно перенести настройки трансляции UDP-трафика с белого IP-адреса на серый и/или настройки использования одновременно белого и серого IP в конфигурационный файл calls.yml.

Инструкция по установке обновлений Мессенджера и ВКС 25.4 на одну виртуальную машину

В раздел «Подготовка к обновлению» добавлена информация о том, что при обновлении с версии 25.3 и выше до 25.4 и выше нужно перенести настройки трансляции UDP-трафика с белого IP-адреса на серый и/или настройки использования одновременно белого и серого IP в конфигурационный файл calls.yml.

Инструкция по настройке интеграции с АТС

Добавлены разделы:

• Настройка интеграции с АТС (с версии 25.2 до версии 25.4)
• Настройка интеграции с АТС (с версии 25.4 и выше)