Описание изменений в документации VK Teams

Ниже представлены изменения, которые были внесены в документацию VK Teams в релизах 23.4-25.2 и вне релизов.

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

ИюньМай, релиз 25.2АпрельМартРелиз 24.9ФевральАрхив 2024Архив 2023

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

Изменение лимитов на количество участников в звонке

Библиотека VK Teams Bridge

Добавлены примеры входных и выходных данных. Добавлено описание новых методов:

GetAuth
GetMinniappConfig
GetPlatformVersion
SetBadge
ButtonPressed

Учтены изменения в релизе 25.2

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

Инструкция по настройке интеграции с DLP-системой — в документе описан механизм отправки запросов в DLP-системы Solar Dozor, SearchInform и InfoWatch, а также процесс настройки отправки данных в DLP-систему для версии 25.2 и выше. Документ предназначен для использования системными администраторами.
Плагин VK Teams для создания конференций в почтовом клиенте MS Outlook — в документе описан плагин для создания конференций и процесс его установки. Документ предназначен для администраторов организации.
Плагин VK Teams в MS Outlook для создания конференций — документ для конечных пользователей по созданию конференций при помощи плагина.

Общее

Во всей документации скорректированы команды: premsetup.py → im_deployer.

Архитектура и описание системы VK Teams

Скорректирован раздел «Типы развертки сервисов» — сервисы Feedog и Krtek теперь развернуты в k8s(k3s).
Скорректирован раздел «Настройки DNS-зоны» — из списка доменных имен удален di-dark.vkteams.mycorp.com vkteams.mycorp.com. Поддомен сервиса Keycloak для версий до 25.2 — di.vkteams.mycorp.com vkteams.mycorp.com, для версии 25.2 и выше — kc.vkteams.mycorp.com vkteams.mycorp.com.
Описаны сервисы, обеспечивающие интеграцию VK Teams с DLP-системами для версии 25.2 и выше.

Инструкция по установке VK Teams на одну виртуальную машину

Скорректированы разделы «Настройки DNS-зоны» для установки из консоли и при помощи графического интерфейса — из списка доменных имен удален di-dark.vkteams.mycorp.com vkteams.mycorp.com. Поддомен сервиса Keycloak для версий до 25.2 — di.vkteams.mycorp.com vkteams.mycorp.com, для версии 25.2 и выше — kc.vkteams.mycorp.com vkteams.mycorp.com.

Инструкция по установке кластера VK Teams

Скорректирован раздел «Настройки DNS-зоны» — из списка доменных имен удален di-dark.vkteams.mycorp.com vkteams.mycorp.com. Поддомен сервиса Keycloak для версий до 25.2 — di.vkteams.mycorp.com vkteams.mycorp.com, для версии 25.2 и выше — kc.vkteams.mycorp.com vkteams.mycorp.com.
Скорректирован раздел «Требования к L7-балансировщику» — скорректирован перечень заголовков, которые балансировщик должен проставлять при проксировании запросов, приведен пример конфига Nginx.

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

Скорректирован раздел «Шаг 3. Регистрация провайдеров аутентификации в сервисах VK Teams» — скорректированы команды для создания таблицы с данными провайдеров для доменных имен «kc» и «di».

Руководство по администрированию VK Teams

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

Инструкция по установке обновлений VK Teams на одну виртуальную машину

При обновлении до версии 25.2 и выше сервис Keycloak переместится с поддомена "di." на "kc.". Для его корректной работы необходимо настроить DNS-зону и, если включена SSO-аутентификация, добавить новую таблицу с провайдерами аутентификации.

Как установить приложение VK Teams

Скорректирован раздел с описанием установки VK Teams на ОС Linux. Описана установка VK Teams при помощи графического инсталлятора, а также при помощи DEB- и RPM-пакетов.

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

Скорректирован раздел «Шаг 2. Укажите настройки интеграции веб-интерфейсе установщика Почты» — скорретирован адрес сервера VK Teams, где находится Grafana:

Для версии VK Teams 24.2 и ниже:
stentor.<домен VK Teams>/myteam-grafana

Для версий VK Teams 24.3 и 24.9:
stentor.<домен VK Teams>/grafana

Начиная с версии VK Teams 25.2:
stentor.<домен VK Teams>/dashboards

Мониторинг VK Teams

Скорректирован раздел «Сервисы VictoriaMetrics / Grafana» — скорректированы адреса, по которым доступен сервис Grafana:

Для версии VK Teams 24.2 и ниже:
https://admin.<DOMAIN>/myteam-grafana

Для версий VK Teams 24.3 и 24.9
https://admin.<DOMAIN>/grafana

Начиная с версии VK Teams 25.2
https://admin.<DOMAIN>/dashboards

Внерелизные изменения

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

Вопросы и ответы. Мини-аппы
Создание мини-аппа
Инструкция по интеграции с АТС

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

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

Скорректирована последовательность команд в разделе «Конфигурирование с использованием KATA».
Скорректирован раздел «Режим проверки отправляемых файлов» — добавлена команда для применения установленного режима проверки. В случае кластерной инсталляции режим проверки файлов необходимо настраивать на каждой ноде кластера.

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

Настройка интеграции с кластерной установкой панели администратора VK WorkSpace — в документе описана настройка интеграции VK Teams версии 24.9 и выше и кластерной инсталляцией панели администратора VK WorkSpace версии 1.24. Документ предназначен для использования администраторами организации.
Требования к каналам связи — описаны требования к пропускной способности каналов связи на стороне сервера VK Teams и на стороне клиентского приложения.

Настройка интеграции с панелью администратора VK WorkSpace

Добавлены требования к SSL-сертификату.
Обновлен раздел «Шаг 4. Создайте учетную запись с доступом в окружение администратора VK Teams» в части настроек файла myteam-admin.yml.

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

Размеще ответ на вопрос «Будет ли работать Android-приложение с Self-Signed сертификатом?».

Инструкция по установке VK Teams на одну виртуальную машину

Скорректированы разделы «Шаг 8. Настройки DNS-зоны» для установки VK Teams при помощи программы-установщика и при помощи консоли:

Из списка имен удален «di», вместо него корректное имя — «kc».
Скорректировано имя домена «files-b», вместо него корректное имя — «files-n».

Инструкция по установке кластера VK Teams

Скорректирован раздел «Шаг 8. Настройки DNS-зоны»:

Из списка имен удален «di», вместо него корректное имя — «kc».
Скорректировано имя домена «files-b», вместо него корректное имя — «files-n».

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

Скорректирован раздел «Шаг 3. Регистрация провайдеров аутентификации в сервисах VK Teams» — скорректировано доменное имя «di.» в команде для добавления таблицы с данными провайдеров. Новое доменное имя — «kc.». Также доменное имя скорректировано в примечании с полезными командами в rlwrap.

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

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

«Конфигурирование с использованием ICAP» — скорректирован шаг 4, добавлен шаг 5.
«Конфигурирование с использованием KATA» — скорректирован шаг 8, добавлены шаги 9, 10.

Руководство по администрированию VK Teams

Скорректирован раздел «Голосовые и видеозвонки» — скорректированы команды для изменения количества UDP-портов, которые используются для звонков.

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

Скорректирован раздел «Голосовые и видеозвонки» — скорректированы команды для изменения количества UDP-портов, которые используются для звонков.

Размещен новый документ «Развертывание и настройка сервисов групповых политик» — в документе описаны шаги для развертывания и включения сервисов следующих групповых политик: политика доступности разделов меню VK Teams, политика обязательных чатов и каналов VK Teams, политика привилегий.

Архитектура и описание системы VK Teams

Добавлен раздел «Групповые политики» — описаны сервисы, обеспечивающие функциональность групповых политик на стороне VK Teams и VK WorkSpace. Добавлена схема архитектуры. Не является частью публичной документации, обратитесь к представителю VK Tech, чтобы ознакомиться с документом.

Инструкция по установке обновлений VK Teams на одну виртуальную машину

При обновлении системы и клиентских приложений до версии 24.9 убедитесь, что:
1. После обновления в конфигурационном файле /usr/local/nginx-im/html/myteam/myteam-config.json есть поля services.config.tasks.is-public и services.config.orgstructure.is-public.
2. В данных полях проставлены значения false.
При отсутствии данных настроек могут быть проблемы в работе мини-аппов.

Вопросы и ответы. Установка и обновление

Добавлен вопрос «После обновления VK Teams до версии 24.9 не работают мини-аппы».

Руководство по администрированию VK Teams

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

Архитектура и описание системы VK Teams

Добавлено описание сервисов:

Spamy.
Survey.

Как работать в VK Teams

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

Поддерживаемые версии веб-браузеров и ОС

В перечень поддерживаемых операционных систем добавлена Glibc версии 2.28 или выше.
Из перечня поддерживаемых браузерров удален Safari.

Как работать в VK Teams

Инструкция расформирована на отдельные документы:

«Как работать в мессенджере VK Teams».
«Как работать с задачами в VK Teams».
«Видеоконференции в VK Teams».
«Организационная структура в VK Teams».

Подключение структуры организации

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

«Шаг 4. Выпустите SSL-сертификаты для поддоменов оргструктуры».
«Шаг 5. Настройте Nginx VK Teams».

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

Добавлен раздел «Предварительная настройка на сервере Active Directory» для настройки SSO по протоколу Kerberos.

Архитектура и описание системы VK Teams

В описание сервисов звонковой части добавлена информация об автоматическом эхоподавлении, шумоподавлении и автоматической адаптации к каналу связи.

Инструкция по установке кластера VK Teams

Удален раздел «Шаг 16. Рестарт машины».

Релиз 23.11Релиз 23.10Релиз 23.9Релиз 23.8Релиз 23.7Релиз 23.6Релиз 23.5Релиз 23.4

Руководство по администрированию VK Teams

Добавлены разделы:
- «Включить оргструктуру организации» — добавлено описание настроек, которые необходимо произвести для отображения оргструктуры организации в клиентском приложении;
- «Настроить витрину чатов» — добавлено описание конфигурирования витрины чатов — добавление чатов в витрину, удаление чатов из витрины, смена порядка чатов в витрине, удаление витрины чатов;
- «Включить папки в клиентском приложении» — добавлено описание конфигурирования функциональности папок в клиентском приложении;
- «Разрешить изменение имени контакта» — добавлено описание конфигурирования возможности изменять имена контактов в мессенджере.

Как работать в VK Teams

Добавлены разделы:
- «Оргструктура» — добавлено описание работы с функциональностью организационной структуры в клиентском приложении;
- «Папки чатов» — добавлено описание работы с папками в мессенджере — создание, редактирование, удаление папко, смена порядка папок и добавление чата в папку.

Инструкция по установке кластера VK Teams

Добавлены разделы:
- «Кластерные настройки»;
- «Настройки DMZ»;
- «Установка кластера с DMZ».

Логи VK Teams

Скорректирован раздел «Cбор серверных логов» — добавлено описание ключей для скрипта сбора логов report.sh.

Инструкция по установке клиентского приложения VK Teams через msi- и exe- файлы

Добавлен и скорректирован раздел «Поддерживаемые версии веб-браузеров и ОС».

Инструкция по установке VK Teams на одну виртуальную машину

Удален раздел «Клиентское приложение»;
Скорректирован раздел «Описание дистрибутива и технические требования» в части требований к серверу для продуктивной установки;
Скорректирован раздел «Шаг 14. Запуск скрипта конфигурации» в части команды для запуска скрипта конфигурации.

Инструкция по установке обновлений VK Teams на одну виртуальную машину

Скорректированы разделы «Подготовка к обновлению» (для обновления мессенджера при помощи тестовой виртуальной машины и без тестовой виртуальной машины) — описаны настройки, которые необходимо произвести в конфигурационном файле mytem-config.json при обновлении мессенджера до версии 23.10 и выше.

Инструкция по установке кластера VK Teams

Удален раздел «Клиентское приложение».

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

Инструкция по установке клиентского приложения VK Teams через msi- и exe- файлы.

Как работать в VK Teams

Скорректирован раздел «Задачи» — добавлено описание поиска, просмотра, редактирования, обсуждения задач, настройки наблюдения за задачей, описаны статусы задач и работа с фильтрами;
Добавлен раздел «Реакции» — добавлено описание, как поставить и удалить реакцию, а также просмотр списка реакций для сообщения.

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

Скорректирован раздел «Шаг 4. Настройка внешней аутентификации» — скорректрована команда для применения настроек, указанных в файле myteam-config.json. Добавлена команда для получения имени пода.

Как работать в VK Teams

Добавлен раздел «Статусы»;
Добавлен раздел «Размытие фона в звонке»;
Удален раздел «Структура компании и список сотрудников».

Мини-аппы в VK Teams

Добавлен раздел «CreateChat».

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

Удален раздел «Изменения в DNS»;
Добавлен раздел «Обновление мессенджера без использования тестовой виртуальной машины».

Как работать в VK Teams

Добавлены разделы:
- «Чат в звонке» — добавлено описание чатов в звонке, которые позволяют обмениваться информацией, ссылками и комментировать происходящее в реальном времени;
- «Управление звонком» — добавлено описание функциональности, позволяющей настраивать зал ожидания, режим вебинара, камеры и микрофоны участников звонка, назначать участника звонка модератором. Также добавлены различные роли участников: Создатель, Модератор, Участник, Слушатель;
- «Запись звонка» — добавлено описание функциональности записи звонка;
- «Экономия трафика» — добавлено описание функциональности, позволяющей отключить входящее видео в звонке для экономии трафика.
Скорректированы разделы:
- «Оформление» — добавлена возможность изменения цвета оформления клиентского приложения;
- «Демонстрация экрана» — добавлено ограничение демонстрации экрана модератором звонка.
Раздел «Опросы» переименован в «Голосования».

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

Скорректирован раздел «Режим проверки отправляемых файлов» в части расположения конфигурационного файла сервиса Go-files.

Руководство по администрированию

Скорректирован раздел «Мониторинг базовых (системных) параметров» — добавлена дополнительная команда для просмотра очереди на отправку OTP-сообщений postqueue -p.
Добавлен раздел «Отключение кэша файлов, передаваемых через сервис Go-files».

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

Скорректирован раздел «Поддерживаемые версии веб-браузеров и ОС».

Инструкция по установке кластера VK Teams

Скорректирован раздел «Поддерживаемые версии веб-браузеров и ОС».

VK Teams Bot API

В раздел с интеграциями портала добавлена ссылка для перехода на лендинг с инструкцией по работе с ботами в VK Teams.

Мини-аппы в VK Teams

Добавлен раздел «Публикация мини-аппа при помощи API мини-аппов».

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

Скорректирован раздел «Добавление нового LDAP-подключения»: добавлено описание формата yaml-файла для добавления нового LDAP-соединения.

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

Добавлен раздел «Настройка SSO-аутентификации по протоколу Kerberos в Microsoft Active Directory».

Руководство по администрированию

Добавлен раздел «Настройка обратной связи»;
Добавлен раздел для управления пользователями без контроллера домена через kccli-утилиту — «Через kccli-утилиту».

Как работать в VK Teams

Добавлен раздел «Избранное» — добавлено описание процесса добавления файлов и сообщений в Избранное;
Скорректировано описание разделов:
- «Написание писем» — при нажатии левой кнопкой мыши на email пользователя в чате будет открываться создание письма во вкладке «Почта»;
- «Проверка орфографии» — добавлена проверка орфографии для ОС Linux;
- «Оформление» — появился новый раздел «Вид списка чатов», при помощи которого можно сменить режим отображения списка чатов: «Расширенный», «Стандартный» или «Компактный».

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

Инструкция по настройке интеграции с антивирусом;
Инструкция по настройке интеграции с DLP-системой;
Инструкция по подключению к внешней системе мониторинга;
Инструкция по подключению внешнего S3-хранилища;
Инструкция по настройке интеграции с SIEM-системой;
Инструкция по интеграции с контроллером домена по протоколу LDAP.

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

Скорректирован раздел «3. Предварительные условия для установки» в части портов/протоколов, к которым необходимо разрешить подключение на пользовательских ПК;
Добавлены разделы «Настройка сервиса записи звонков» для установки мессенджера из консоли и из графического интерфейса.

Руководство по администрированию

Добавлен раздел «Несоответствие логина пользователя и адреса сервера (API endpoints)»;
Добавлен раздел «Состояние профилей (Active Directory + Keycloak конфигурация)»;
Удалены разделы:
- «Антивирусная проверка» — сформирован новый документ «Инструкция по настройке интеграции с антивирусом», в котором удален раздел «Мониторинг сервиса антивирусной проверки»;
- «Отправка данных в DLP-систему» — сформирован новый документ «Инструкция по настройке интеграции с DLP-системой», в котором добавлено описание интеграции с поставщиками DLP-систем (разделы «SearchInform» и «InfoWatch»), скорректирован раздел «Настройка отправки данных в DLP-систему» в части команд для указания ключей в ETCD;
- «Подключение к внешней системе мониторинга» — сформирован новый документ «Инструкция по подключению к внешней системе мониторинга»;
- «Подключение внешнего S3-хранилища» — сформирован новый документ «Инструкция по подключению внешнего S3-хранилища»;
- «Настройка интеграции с SIEM-системой» — сформирован новый документ «Инструкция по настройке интеграции с SIEM-системой»;
- «Управление параметрами синхронизации LDAP» — сформирован новый документ «Инструкция по интеграции с контроллером домена по протоколу LDAP», в котором скорректирован раздел «Добавление нового LDAP-подключения» в части путей к каталогам.
Удален раздел «Отправка диагностических данных».

Логи клиентских приложений

Добавлены разделы:
- «Инструменты сбора логов»;
- «Расположение логов».

Как работать в VK Teams

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

Инструкция по установке кластера

Скорректирован раздел «3. Предварительные условия для установки» в части портов/протоколов, к которым необходимо разрешить подключение на пользовательских ПК;
Добавлен раздел «Настройка сервиса записи звонков».

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

Сформирован отдельный документ «Инструкция по установке обновлений на одну виртуальную машину», в нем скорректирован раздел «Создание тестовой виртуальной машины» — удален шаг 7 (выполнение команды для инициализации всех сервисов premsetup.py –init).

Руководство по администрированию

Добавлены разделы:
- «Подключение внешнего S3-хранилища»;
- «Подключение к внешней системе мониторинга»;
- «Состояние профилей (AD + Keycloak конфигурация)».
Скорректированы разделы:
- «Добавление нового LDAP-подключения» — шаги 3, 5;
- «Голосовые и видео-звонки» в части возможности изменения количества UDP-портов, используемых для звонков;

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

Удален раздел «Публикация мини-аппа».