# Начальная настройка

Учётная запись олицетворений – специальная учётная запись на сервере Microsoft Exchange, которой разрешено "от имени" других пользователей просматривать их календари и выполнять действия. Данная запись создаётся администратором сервера Microsoft Exchange.

Перед настройкой необходимо сгенерировать зашифрованный пароль для учётной записи олицетворения выполнив команду:

Windows

C:\Program Files\TrueConf\Calendar\tc_calendar.exe --hash_pass <password>

Linux

sudo /opt/trueconf/calendar/bin/calendar/tc_calendar --hash_pass <password>

где <password> – пароль от учётной записи олицетворения Microsoft Exchange. Если паролей несколько, укажите их разделяя пробелом (pass1 pass2 .... pass n).

На каждый пароль будет сгенерирована его уникальная версия. Каждая строка с зашифрованным паролем соответствует порядку их указания в командной строке: Your encrypted data: dGNf....

# Описание конфигурационного файла

Для конфигурирования TrueConf Calendar Connector используется файл, расположенный по пути: /opt/trueconf/calendar/etc/calendar/config.json.

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

# Настройка БД и сетевого порта

{
  "wsPort": 4315, 
  "dbConnectionConfig": {
    "host": "localhost",
    "port": 5441,
    "user": "bridge",
    "password": "",// по умолчанию, пароля для доступа к базе данных нет, но если его установят, то здесь необходимо прописать зашифрованный пароль созданный ранее для учётной записи олицетворения
    "database": "calendar"
  },

"wsPort" – порт для работы WebSocket сервера, если не был указан иной во время установки, редактирования не требует.
"dbConnectionConfig" – секция конфигурирования подключения к базе данных. Параметры в этой секции автоматически генерируются при установке и их НЕЛЬЗЯ менять вручную.

# Настройка конференций

"launchConference": true,
"temporalConfParticipantsMode": false,
"cache": {
  "autoSync": false,
  "backward": 2,
  "forward": 3
}

"launchConference" – отвечает за автоматический запуск конференции. TrueConf Calendar Connector отправляет запрос в TrueConf Server во время начала события в Microsoft Exchange.
"temporalConfParticipantsMode" – отвечает за добавление участников в список "запланированных". Если false - все участники событий, которые не отказались будут добавлены как запланированные.
"cache" – секция используемая для настройки параметров автоматической синхронизации:
- "autoSync" – если выбрано значение true, производится полная синхронизация событий из календаря. Если указано false, ранее созданные события не будут отображаться синхронизироваться в выбранном временном периоде, остальные события;
- "backward" – количество месяцев назад от текущей даты для отображения повторяющихся событий;
- "forward" – количество месяцев вперед от текущей даты для отображения повторяющихся событий.

# Конфигурирование доступа к TrueConf Server

"productWhitelist": {
    "tcs": ["server.trueconf.name#vcs"]
 }

"server.trueconf.name#vcs" - необходимо указать адрес (или доменное имя) TrueConf Server, который будет иметь доступ к TrueConf Calendar Connector.

# Конфигурирование доступа к Microsoft Exchange

На стороне Microsoft Exchange необходимо заранее создать учетные записи олицетворений, которым разрешено "от имени" других пользователей просматривать календари.

  "calendarProviders": [
    {
      "host": "exchange.domen.com", 
      "path": "/EWS/Exchange.asmx", 
      "port": 443, 
      "type": "ews", 
      "credentials": [
        {
          "login": "test",
          "password": "зашифрованный_пароль"
        } 
        ],
      "users": [
        "name@domen.com"
      ]
    }
  ]
}

"calendarProviders" - секция для указания конфигураций внешних сервисов синхронизации календарей;
"host" - домен, где расположен сервер Microsoft Exchange;
"path" - путь для доступа к EWS API (указан путь по умолчанию);
"port" - стандартный порт для подключения к EWS;
"type" - название внешнего сервиса (поддерживается только Microsoft Exchange) ;
"credentials" - секция для указания данных учетной записи олицетворения на сервере Exchange;
- "login" - логин корпоративного аккаунта Exchange;
- "password" - зашифрованный пароль от учетной записи. Генерируется с помощью терминала;
"users" - секция "users" является обязательной. Здесь указывается список email для отправки данных о мероприятии в клиентские приложения Труконф.

# Обслуживание TrueConf Calendar

Управление TrueConf Calendar Connector в ОС Windows происходит при помощи диспетчера задач.

# Запуск календаря

После указания необходимых параметров описанных выше, запустите TrueConf Calendar Connector при помощи команды:

sudo systemctl start trueconf-calendar.service

Если будет превышен лимит запуска выполните:

sudo systemctl reset-failed trueconf-calendar.service

# Проверка работы календаря

Для проверки работы TrueConf Calendar Connector выполните:

sudo systemctl status trueconf-calendar.service

После чего получите один из ответов:

active (running) – TrueConf Calendar Connector работает штатно.

failed – TrueConf Calendar Connector НЕ работает. В этом случае попробуйте перезапустить службу при помощи команды описанной выше.

В случае неполадок обратитесь в нашу техническую поддержку.

← Установка и регистрация Работа с календарем →