Настройка интеграции с Панелью администратора (standalone)

В документе описана настройка интеграции Мессенджер и ВКС версии 25.2 и выше и Панели администратора VK WorkSpace версии 1.24 и выше. Документ предназначен для использования администраторами организации.

Условно процесс настройки интеграции Мессенджер и ВКС с Панелью администратора можно разделить на несколько шагов:

1. Выполните настройки на стороне Мессенджер и ВКС.

2. Разверните Панель администратора VK WorkSpace и интегрируйте ее с Мессенджер и ВКС.

3. Настройте интеграцию Панели администратора с ActiveDirectory.

4. Выключите синхронизацию пользователей через сервис Keycloak.

Подробное описание шагов представлено ниже.

После настройки интеграции пользователи Мессенджер и ВКС синхронизируются с ActiveDirectory через Панель администратора. Поэтому, если у вас настроена интеграция Мессенджер и ВКС с ActiveDirectory, настройте интеграцию Панели администратора с ActiveDirectory и после этого удалите LDAP-подключение Мессенджер и ВКС.

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

Инструкция по интеграции Мессенджер и ВКС с контроллером домена по протоколу LDAP — в инструкции описано управление параметрами синхронизации LDAP.

Что делать, если при входе в Панель администратора появляется ошибка «Неверный пароль»

Управление структурой организаций — в инструкции описана работа со структурой организаций в Панели администратора VK WorkSpace.

Развертывание и настройка сервисов групповых политик — в инструкции описаны шаги для развертывания и включения сервисов групповых политик.

Групповые политики — в инструкции описана работа с групповыми политиками в Панели администратора VK WorkSpace.

1. Если у вас еще не установлен Мессенджер и ВКС, установите его, пропустив настойку синхронизации пользователей с LDAP-сервером.

2. Выпустите SSL-сертификат — в сертификате укажите домен, на котором будет расположена Панель администратора. Можно использовать SSL-сертификат на один домен. Требования к сертификату:

   • CN — домен, на котором будет расположена Панель администратора.
   • Расширение san не нужно.
   • Тип DV (Domain Validation) — проверять только владение доменом.
   • extendedKeyUsage = serverAuth.
   • Public Key — нужен.

3. Подготовьте почтовый домен вашей корпоративной электронной почты. Если у вас нет корпоративной почты, создайте ее.

4. Создайте домен Панели администратора.

   Домен Панели администратора должен содержать поддомен biz, пример домена — biz.<ваш_домен>.ru.

   Создайте A- или CNAME-запись для данного домена в DNS. Возможна как A-запись, так и CNAME-запись, в зависимости от того, где будет развернута Панель администратора. Необходима запись, которая будет указывать на сервер VK WorkSpace, остальное зависит от ваших текущих настроек и Nginx (если он есть). Например, вы можете указать biz.example.ru. как CNAME-запись к example.ru, если для вашего Nginx настроена маршрутизация запросов. Если нет, то стоит создать А-запись для Панели администратора.

5. Доступ к виртуальной машине, на которой установлен Мессенджер и ВКС.

6. Получите у представителя VK данные для разворачивания Панели администратора VK WorkSpace:

   • Ссылка на скачивание дистрибутива Панели администратора VK WorkSpace.
   • Пароль от архива с дистрибутивом.
   • Лицензионный ключ.

7. Доступ к почтовому серверу по 25 порту, так как Панель администратора VK WorkSpace использует протоколы SMTP, ESMTP.

Поддерживаемые операционные системы для установки Панели администратора:

• Astra Linux SE Орел — версия 1.7.5+, версия ядра — 5.15.
• Astra Linux SE Орел — версия 1.8, версия ядра — 6.1.
• РЕД ОС — версия 7.3.5, версия ядра — 6.1.
• РЕД ОС — версия 7.3с (сертифицированная), версия ядра — 6.1.
• РЕД ОС — версия 8, версия ядра — 6.6 или 6.12.

Архитектура системы — x86_64.

Обновлять операционную систему можно только на поддерживаемую версию и только после консультации с представителем VK. Список поддерживаемых ОС может быть уточнен в рамках работ по индивидуальному проекту.

Продуктивная версия Панели администратора устанавливается на одну виртуальную машину со следующей конфигурацией:

• 12 vCPU.

• 24 GB RAM.

• 250 GB SSD.

Таблица совместимости

1. Перейдите в веб-интерфейс установщика VK WorkSpace по адресу http://server-ip-address:8888.
2. На главной странице установщика перейдите в Проекты → vkteams.
3. В окне Формы проекта vkteams выберите prismtokens. Нажмите кнопку + Добавить.
4. Активируйте переключатель AKES (Advanced Key Encryption Setting) и заполните поля:
   • Токен — укажите произвольную строку-токен;
   • Имя токена — укажите наименование токена.
5. Нажмите кнопку Сохранить настройки.
6. Перейдите на главную страницу веб-интерфейса установщика, нажав на логотип VK WorkSpace.
7. Разверните раздел Мессенджер VK WorkSpace. В строке с контейнером static-prismtokens-init1 нажмите на шестеренку:
8. В открывшемся окне нажмите кнопку Запустить для перезапуска выбранного контейнера.

1. На главной странице установщика перейдите в Проекты → vkteams.
2. В окне Формы проекта vkteams выберите apigw.
3. В поле admin_allow_list добавьте необходимые IP-адреса.
4. Нажмите кнопку Сохранить настройки.
5. Перейдите на главную страницу веб-интерфейса установщика, нажав на логотип VK WorkSpace.
6. Разверните раздел Мессенджер VK WorkSpace. В строке с контейнером apigwv21 нажмите на шестеренку:
7. В открывшемся окне нажмите кнопку Запустить для перезапуска выбранного контейнера.

1. На главной странице установщика перейдите в Проекты → vkteams.
2. В окне Формы проекта vkteams выберите nomail.
3. В поле Права доступа к myteam admin (myteam_admin) укажите CN нужной группы администраторов. По умолчанию в поле указано значение *.
4. Нажмите кнопку Сохранить настройки.
5. Перейдите на главную страницу веб-интерфейса установщика, нажав на логотип VK WorkSpace.
6. Разверните раздел Мессенджер VK WorkSpace. В строке с контейнером nomail1 нажмите на шестеренку:
7. В открывшемся окне нажмите кнопку Запустить для перезапуска выбранного контейнера.
8. Проверьте настройку командой:

    
   kubectl -n vkteams exec -it nomail-a-1 -c nomail-tarantool -- tarantoolctl connect 3301 <<< "cfg.otp_permission.apps"

1. На сервере Мессенджер и ВКС в любой удобной папке создайте файл users.yaml и заполните его данными учетной записи:

    
   users:    admin@admin.qdit:        email: admin@admin.qdit        firstName: admin        lastName: admin        attributes:            memberOf: ["myteam-admin","CN=vkteams_allowed"]

   где memberOf — название группы пользователей с доступом в окружение администратора.

   Объект users имеет тип Hash. При использовании расширенного формата yaml-файла username должен совпадать с email. В примере выше это admin@admin.qdit.

2. После создания users.yaml выполните в консоли команду:

    
   users.py --cmd add -c users.yaml

3. Получите значения adminSn и adminRid учетной записи администратора, выполнив команду:

    
   echo "show admin@admin.qdit" | nc prof-st.vkteams.svc.cluster.local 4020

4. На главной странице установщика перейдите в Проекты → vkteams.

5. В окне Формы проекта vkteams выберите mail_integrations.

6. В полях rid пользователя admin и SN пользователя admin укажите значения, полученные в п.3 текущего шага.

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

8. Перейдите на главную страницу веб-интерфейса установщика, нажав на логотип VK WorkSpace.

9. Разверните раздел Мессенджер VK WorkSpace. В строке с контейнером myteam-admin1 нажмите на шестеренку:

10. В открывшемся окне нажмите кнопку Запустить для перезапуска выбранного контейнера.

11. Проверьте изменения командой:

     
    kubectl -n vkteams exec -it $(kubectl -n vkteams get po -l app=myteam-admin | sed 1d | awk '{print $1}') -c myteam-admin -- cat /usr/local/etc/godmod/godmod.yaml

1. На главной странице установщика перейдите в Проекты → vkteams.
2. В окне Формы проекта vkteams выберите admin_panel.
3. Активируйте интеграцию.
4. Нажмите кнопку Сохранить настройки.
5. Перейдите на главную страницу веб-интерфейса установщика, нажав на логотип VK WorkSpace.
6. Разверните раздел Мессенджер VK WorkSpace. Перезапустите по очереди контейнеры myteam-config-json1, myteam-admin1 и apigwv21: в строке с каждым контейнером нажмите на шестеренку и в открывшемся окне — кнопку Запустить.

1. В командной строке на сервере Панели администратора VK WorkSpace выполните последовательность команд:

   Astra Linux

   РЕД ОС

   1. Задайте пароль и создайте пользователя deployer:

       
      sudo -iDEPLOYER_PASSWORD=PASSWORDuseradd -G astra-admin -U -m -s /bin/bash deployerecho deployer:"$DEPLOYER_PASSWORD" | chpasswd

      Проигнорируйте ошибку "НЕУДАЧНЫЙ ПАРОЛЬ: error loading dictionary", если она появилась.

   2. Авторизуйтесь под пользователем deployer:

       
      sudo -i -u deployer ssh-keygen -t rsa -N ""

   3. Нажмите на клавишу Enter (согласиться с вариантом по умолчанию).

   4. Скопируйте ssh-ключ в нужную директорию:

       
      cat /home/deployer/.ssh/id_rsa.pub >> /home/deployer/.ssh/authorized_keyschmod 600 /home/deployer/.ssh/authorized_keys

   5. Опционально: проверьте, что можно подключиться без пароля:

       
      ssh deployer@localhost

   6. exit

   1. Задайте пароль и создайте пользователя deployer:

       
      sudo -iDEPLOYER_PASSWORD=PASSWORDuseradd -G wheel -U -m -s /bin/bash deployerecho deployer:"$DEPLOYER_PASSWORD" | chpasswd

   2. Авторизуйтесь под пользователем deployer:

       
      sudo -i -u deployer ssh-keygen -t rsa -N ""

   3. Нажимите на клавишу Enter (согласиться с вариантом по умолчанию).

   4. Скопируйте ssh-ключ в нужную директорию:

       
      cat /home/deployer/.ssh/id_rsa.pub >> /home/deployer/.ssh/authorized_keyschmod 600 /home/deployer/.ssh/authorized_keys

   5. Опционально: проверьте, что можно подключиться без пароля:

       
      ssh deployer@localhost

   6. exit

2. Выполните команду sudo visudo.

3. В файле /etc/sudoers уберите # в начале следующей строки:

 
# %astra-admin       ALL=(ALL)       NOPASSWD: ALL

 
# %wheel        ALL=(ALL)       NOPASSWD: ALL

То же самое можно сделать с помощью редактора nano:

 
sudo EDITOR=nano visudo# Находим нужную строку, удаляем # в ее начале# Выходим из nano c сохранением изменений

Распакуйте дистрибутив под пользователя deployer (в директорию /home/deployer). Вы можете распаковать архив с дистрибутивом и в другую папку или создать подпапку.

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

Установщик onpremise-deployer_linux рекомендуется запускать как сервис. При таком запуске не придется прибегать к дополнительным мерам (screen, tmux, nohup), позволяющим установщику продолжить работу в случае потери соединения по SSH.

Чтобы запустить установщик как сервис, выполните команду (подходит для Astra Linux, РЕД ОС):

 
sudo ./onpremise-deployer_linux -concurInstallLimit 5  \  -serviceEnable -serviceMake -serviceUser deployer

По умолчанию выставлен лимит в 5 потоков, при необходимости вы можете увеличить количество потоков до 10, однако это увеличит и нагрузку на систему. Использование более чем 10 потоков не рекомендуется.

Ответ в случае успешного запуска установщика выглядит следующим образом:

 
deployer.service was added/updatessee status: <systemctl status deployer.service>can`t restart rsyslog services: [exit status 5]OUT: Failed to restart rsyslog.service: Unit rsyslog.service not found.deployer.service was enable and startedsee status: <systemctl status deployer.service>

 
The authenticity of host 'localhost (::1)' can't be established.ED25519 key fingerprint is SHA256:g8siO32KUsRU9oC/MHro9WaTNKj4R+DkmVnVa7QsYCo.This key is not known by any other names# Введите "yes" и нажмите Enter, чтобы подтвердить подключениеAre you sure you want to continue connecting (yes/no/[fingerprint])?

Перейдите в веб-интерфейс установщика Панели администратора по адресу http://server-ip-address:8888. Если перейти по этому адресу не удается, убедитесь, что firewall был отключен.

На стартовой странице нажмите на кнопку Установка.

Включите флаг Административная панель.

В открывшемся списке выберите нужные вам компоненты:

Система групповых политик — если в дальнейшем планируется настраивать сервисы групповых политик.

Kafka внутри инсталляции — если при настройке групповых политик НЕ будет использован внешний сервис Kafka.

Интеграция с Мессенджер и ВКС — обязательный компонент.

Система мониторинга — опциональный компонент. Не используется совместно с компонентом Система сбора и отправки метрик.

Система сборка и отправки метрик — опциональный компонент. Не используется совместно с компонентом Система мониторинга.

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

1. Нажмите на кнопку Добавить.

2. В выпадающем меню выберите Сервер:

   

   Откроется окно добавления гипервизора:

   

3. Заполните поля:

   • Роль — hypervisor.

   • IP — адрес машины, на которую производится установка.

   • SSH-порт — стандартный для SSH, выбран по умолчанию, менять его не нужно.

   • Имя сервера — укажите имя сервера или оставьте поле пустым. В случае если вы оставите поле незаполненным, имя гипервизора будет взято из hostname -s и добавится автоматически. В документации будет использовано имя hypervisor1.

   • Имя пользователя — укажите имя того пользователя, под которым запущен установщик. В рассматриваемом примере это пользователь deployer.

   • Пароль — необходимо ввести пароль пользователя, под которым запущен установщик, если он был задан при создании.

4. В поле Метки, напротив server, в выпадающем меню выберите опцию docker.

   

5. Добавьте SSH-ключ (также можно оставить авторизацию по паролю):

   1. В поле Приватный ключ выберите Добавить новый ключ:

      

   2. В поле Имя ключа введите название ключа для его дальнейшей идентификации, например: deployerRSA.

   3. Перейдите в консоль, выполните команду cat ~/.ssh/id_rsa и скопируйте ключ.

   4. Затем вставьте его в поле Приватный ключ. Его нужно указать полностью, включая:

      -----BEGIN RSA PRIVATE KEY----- и -----END RSA PRIVATE KEY-----

   5. Поле Пароль ключа оставьте пустым.

   6. Кликните по кнопке Сохранить.

6. При необходимости настройте дополнительные поля:

   • Пропустить проверку некритичных требований — если отметить чекбокс, будет пропущена проверка версии ядра и флагов процессора (sse2, avx). В большинстве случаев выбор чекбокса не требуется.
   • Сервер во внешней (dmz) зоне — Оставьте чекбокс пустым.

7. После заполнения полей нажмите на кнопку Добавить — гипервизор отобразится в веб-интерфейсе установщика.

8. Нажмите на зеленую кнопку Далее в правом верхнем углу для перехода к следующему шагу.

Установщик автоматически вычисляет некоторые сетевые параметры. Эти параметры необходимо проверить и дополнить, если не все из них были определены.

1. Укажите DNS-сервер.

2. Убедитесь, что:

   • Подсеть, используемая Панелью администратора на серверах имеет доступ на 80 или 443 порт.

   • Подсеть, используемая внутри контейнеров полностью свободна, уникальна и принадлежит только Панели администратора VK WorkSpace.

   Поле MTU сети контейнеров заполняется автоматически. Если вы хотите изменить размер MTU, обратитесь к представителю VK.

   Флаг НЕ использовать IP-in-IP и BIRD в большинстве случаев должен оставаться неактивным. Если на машине используется динамическая маршрутизация и необходимо включение опции, обратитесь к представителю VK.

3. Нажмите на кнопку Сохранить и перейдите к следующему шагу:

   

1. На вкладке Доменные имена нажмите на иконку и укажите:

   • Основной домен для сервисов — домен, созданный для Панели администратора выше.
   • Домен, по которому будет доступен интерфейс администрирования — biz.<основной домен>.
   

2. Нажмите на кнопку Сохранить.

3. Нажмите на кнопку Добавить сертификат под заголовком SSL-сертификаты.

4. В открывшейся форме введите сертификат и ключ. Их необходимо указать полностью, включая:

   -----BEGIN CERTIFICATE----- и -----END CERTIFICATE-----
   и
   -----BEGIN PRIVATE KEY----- и -----END PRIVATE KEY-----.

5. Кликните по кнопке Сохранить:

   

   Есть второй вариант:

   1. Нажмите на кнопку Выбрать файл.
   2. Укажите путь к файлу с сертификатом .crt.
   3. Укажите путь к файлу с ключом .key.
   4. Кликните по кнопке Сохранить.

Если все верно, в интерфейсе не будет отображаться ошибок и красной подсветки. Нажмите на зеленую кнопку Далее в правом верхнем углу.

1. Нажмите на логотип в левом верхнем углу веб-интерфейса, чтобы перейти к общей строке состояния.

2. Кликните по иконке рядом с общей строкой состояния в верхней части экрана:

   

3. Подтвердите запуск автоматической установки, нажав на кнопку Запустить:

   

4. Дождитесь завершения установки гипервизора:

   

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

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

1. В случае моноустановки нажмите на кнопку Сгенерировать автоматически, чтобы добавить по одному контейнеру для каждой роли:

   

   В случае распределенной установки:

   1. Нажмите на кнопку **Добавить **→ Несколько контейнеров.
   2. Установите фильтр Установлено не более 0.
   3. Распределите недостающие контейнеры по гипервизорам с учетом дублируемости.
   4. Нажмите на кнопку Добавить.

   На экране начнут появляться сгенерированные контейнеры. В случае появления ошибок используйте раздел Логи и полезные команды.

   Через некоторое время в правом верхнем углу появится кнопка Далее, напротив гипервизора появится иконка :

   

2. Кликните по иконке напротив гипервизора.

3. Подтвердите автоматический запуск задач на гипервизоре, нажав на кнопку Запустить:

   

4. На генерацию требуется время. Подождите, пока исчезнет иконка напротив гипервизора.

5. Нажмите на кнопку Далее для перехода к следующему шагу.

Кликните по значку и перейдите в раздел Описание сервисов, чтобы посмотреть развернутую информацию о назначении ролей, их дублируемости и зависимостях. В этом же выпадающем меню вы найдете дополнительную документацию, сможете включить или выключить продукты (внутри раздела Продукты) и обновить лицензионный ключ.

При появлении ошибок на гипервизоре на нем появится тег Не отвечает, а на контейнерах, относящися к этому гипервизору — Не отвечает гипервизор.

Затем перейдите в командную строку и устраните ошибку. По завершении необходимо нажать на шестеренку в строке гипервизора и еще раз на странице списка шагов на гипервизоре.

В окне настроек гипервизора нажмите на кнопку Обновить.

Повторно запустите автоматическую установку.

На вкладке Шардирование и репликация БД нажмите на кнопку Далее.

Шардирование (сегментирование) БД используется в кластерной установке для обеспечения отказоустойчивости и масштабируемости, в моноинсталляции не используется.

На вкладке Настройки компонентов выберите нужный домен и нажмите на иконку . После включения флага Ограничить доступ к домену появится раздел с более детальными настройками:

Ограничить доступ к домену — если включен только этот флаг, в поле ниже нужно будет ввести IP/подсети, которым будет разрешен доступ к домену. Также вы можете добавить комментарии, если это необходимо.

Режим запрета — запрещать следующим IP/подсетям — если включены оба флага (ограничение доступа и режим запрета), доступ к доменам будет запрещен IP/подсетям, введенным в поле.

Не забудьте повторить шаги на гипервизоре (нужные шаги уже отмечены желтым). Также можно нажать на иконку в общей строке состояния. Для этого перейдите к списку шагов, кликнув по логотипу в левом верхнем углу веб-интерфейса.

Административные домены — с помощью кнопки Добавить по одному введите домены (до знака @), которым нужно выдать максимальные права:

Количество дней перед удалением пользователя — количество дней, по прошествии которых пользователь будет удален из Панели администратора VK WorkSpace. Изменение настройки по умолчанию актуально при одновременном использовании Панели администратора VK WorkSpace c Active Directory. По умолчанию выставлен срок 5 дней, то есть пользователь будет удален из Панели администратора VK WorkSpace через 5 дней после его удаления из Active Directory.

Не проверять актуальность включенного функционала (фич) — при включенном флаге установщик будет пропускать шаг bizf → addBizFeatures.

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

1. Введите email и имя отправителя.
2. Введите адрес и порт сервера рассылки.
3. Сохраните изменения.
4. Перейдите к списку ролей и запустите автоматическую установку, чтобы применить настройки.

Если вы используете прокси-сервер при подключении клиентов к Панели администратора VK WorkSpace, включите флаг Перед VK WorkSpace есть прокси-сервер, чтобы контейнер, отвечающий за HTTPS-соединение, мог принимать трафик без шифрования.

Список IP прокси-серверов — введите в поле список IP-адресов, с которых VK WorkSpace будет принимать заголовки с оригинальными IP клиента и оригинальным протоколом подключения.

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

HTTP-заголовок прокси с оригинальным протоколом подключения клиента — для корректной работы VK WorkSpace введите заголовок оригинального протокола подключения.

1. На главной странице установщика перейдите в Настройки → Интеграции.

2. Выберите вкладку Интеграция Почты с мессенджером VK WorkSpace.

3. Войдите в режим редактирования, нажав иконку .

4. Включите компонент Использовать SSL-шифрование для межсерверных запросов.

5. Заполните поля:

   Название поля	Значение
   Адрес API VK Teams для добавления/удаления пользователей	stentor.<домен Супераппа VK WorkSpace>
   Адрес API управления VK Teams	admin.<домен Супераппа VK WorkSpace>
   Токен API управления VK Teams	Нажмите на серую кнопку в поле, чтобы сгенерировать токен
   Адрес API бинарных данных VK Teams	ub.<домен Супераппа VK WorkSpace>
   Адрес клиентского API VK Teams	u.<домен Супераппа VK WorkSpace>
   Адрес веб-версии VK Teams	webim.<домен Супераппа VK WorkSpace>
   Адрес Mini App API	files-n.<домен Супераппа VK WorkSpace>
   Адрес API звонков (ссылок на звонок)	call.<домен Супераппа VK WorkSpace>
   Адрес сервера документации VK Teams	Укажите адрес портала организации, по которому доступно клиентское приложение Супераппа VK WorkSpace и инструкции к нему, например: dl.<домен>
   Адрес сервера VK Teams, где находится Grafana	Для версии Супераппа VK WorkSpace 24.2 и ниже: stentor.<домен Супераппа VK WorkSpace>/myteam-grafana. Для версий Супераппа VK WorkSpace 24.3 и 24.9: stentor.<домен Супераппа VK WorkSpace>/grafana. Начиная с версии Супераппа VK WorkSpace 25.2: stentor.<домен Супераппа VK WorkSpace>/dashboards
   Путь URL-адреса для Grafana в домене панели администрирования	myteam-grafana
   Токен VK Teams для получения структуры организаций в панели администрирования	Значение key из шага «Создайте токен biz-admin»
   Пользователь ClickHouse VK Teams	biz
   Пароль пользователя ClickHouse VK Teams	Чтобы получить пароль, выполните команду на машине с установщиком: cat /home/deployer/secrets/vkteams/secrets.yaml | grep clickhouse_metrics_biz_password -A 1
   Домен Keycloak VK Teams для двухфакторной авторизации	di.<домен Keycloak VK WorkSpace>
   Токен VK Teams для получения списка активных сессий (2fa)	Полный prism-token вида otp_bot_<секрет>. Создайте токен по аналогии с шагом «Создайте токен biz-admin», указав имя токена otp_bot и метод session/listUser
   Список IP адресов/подсетей VK Teams (для ACL в SWA)	<IP-адрес сервера Супераппа VK WorkSpace>

6. При необходимости включите компонент VK Teams поддерживает внешнюю авторизацию.

7. Нажмите кнопку Сохранить.

8. Перейдите на главную страницу веб-интерфейса установщика, нажав на логотип VK WorkSpace.

9. Перезапустите контейнеры, напротив названий которых появились желтые метки, например:

   

Скорректируйте конфигурацию etcd:

1. Пропишите в etcd Мессенджер и ВКС токен API управления Мессенджер и ВКС, сгенерированный на шаге выше:

    
   etcdctl --endpoints etcd.im-etcd.svc.cluster.local:2379 put '/vars/services/godmod//private/service/auth/secret/secret' <token>

   где token — это токен API управления Мессенджер и ВКС.

2. Укажите подсети для сетевого соединения Панели администратора и Мессенджер и ВКС:

    
   etcdctl --endpoints etcd.im-etcd.svc.cluster.local:2379 put '/vars/services/godmod//private/service/auth/secret/ip_subnets' '["192.0.2.0/24","203.0.113.0/24"]'

   где 192.0.2.0/24 и 203.0.113.0/24 — примеры подсетей.

3. Далее выполните команды:

    
   etcdctl --endpoints etcd.im-etcd.svc.cluster.local:2379 put '/vars/services/godmod//private/service/auth/secret/enable' 'true'

    
   etcdctl --endpoints etcd.im-etcd.svc.cluster.local:2379 put '/vars/services/godmod//private/service/auth/mpop/enable' 'false'

В разделе производится настройка кастомных переменных Панели администратора.

Чтобы добавить кастомную переменную:

1. Нажмите на иконку и кнопку Добавить.

2. В выпадающем меню выберите название переменной.

3. Введите значение переменной. Значение переменной должно быть введено корректно, иначе установщик не позволит создать переменную.

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

5. Нажмите на кнопку Далее для перехода к следующему шагу.

1. В веб-интерфейсе установщика Панели администратора кликните по иконке рядом c общей строкой состояния в верхней части экрана.

2. Подтвердите запуск автоматической установки, нажав на кнопку Запустить.

   

   В зависимости от этапа установки будет меняться цвет индикатора:

   • Серый — в ожидании начала генерации.
   • Синий — в процессе генерации.
   • Желтый — шаг будет повторен (автоматически).
   • Красный — ошибка.

3. Ожидайте завершения установки. Пока процесс идет, рядом со строкой состояния будет отображаться красная кнопка Stop.

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

Для повторного запуска необходимо нажать на иконку в общей строке состояния в верхней части экрана или рядом с названием конкретного контейнера.

Когда установка Панели администратора будет завершена, соответствующий статус отобразится в строке состояния.

1. Нажмите на кнопку Далее в правом верхнем углу.

   

2. Введите имя почтового домена вашей корпоративной почты и нажмите на кнопку Добавить.

   

   Домен считается подтвержденным после добавления в Панель администратора.

   В адресную строку скопируйте адрес Панели администратора и введите данные:

   • Имя пользователя — admin@admin.qdit.
   • Пароль находится в файле — bizOwner.pass, для его просмотра введите в консоли команду: cat <путь до директории с установщиком>/bizOwner.pass.

   Если логин и пароль были введены правильно, вы попадете в Панель администратора.

При наличии ActiveDirectory настройте интеграцию в Панели администратора (см. инструкцию).

Если у вас нет ActiveDirectory:

1. Обратитесь в службу технической поддержки для подключения функциональности создания и управления пользователями в Панели администратора.
2. После подключения функциональности импортируйте пользователей при помощи CSV-файла (см. инструкцию).

Если у вас нет ActiveDirectory, интеграция с Панелью администратора считается завершенной. Если настроена интеграция Мессенджер и ВКС с ActiveDirectory, удалите LDAP-подключение (см. ниже).

1. Чтобы удалить LDAP-подключение, на сервере Мессенджер и ВКС выполните команды:

    
   >kccli ldap delete --name <имя вашего LDAP сервера> //удаление по имени>kccli ldap delete --id <id вашего LDAP сервера> //удаление по ID

   Используйте удаление по ID в случае, если ранее было заведено несколько LDAP-серверов с неуникальными именами. Получить ID подключений можно, выполнив команду:

    
   kccli ldap get

2. Выполните рестарт виртуальной машины:

    
   reboot

Интеграция с Панелью администратора считается завершенной.

Если вы планируете использовать несколько доменов, добавьте их с помощью кнопки Добавить домен:

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

1. Перезапуск установщика:

    
   sudo systemctl restart deployer

2. Логи установщика:

    
   sudo journalctl -fu deployer

3. Список запущенных контейнеров:

    
   docker ps

4. Логи конкретного контейнера:

    
   sudo journalctl -eu имя_контейнера

5. Статус контейнера:

    
   systemctl status имя_контейнера

6. Посмотреть список «сломанных» контейнеров:

    
   docker ps -a|grep Exit

7. Посмотреть список всех незапустившихся контейнеров:

    
   sudo systemctl | grep onpremise | grep -v running

8. Удалить контейнер:

    
   sudo docker rm имя_контейнера

Технический писатель: Белова Ирина