Конфигурация

Файл конфигурации TrueConf Calendar Connector находится по пути:

• Windows: C:/Program Files/TrueConf/Calendar/config.json

• Linux: /opt/trueconf/calendar/etc/calendar/config.json

Обратите внимание, чтобы TrueConf Calendar Connector мог работать с несколькими серверами Exchange, они должны быть объединены в кластер. Подробнее о кластере вы можете узнать в официальной документации Microsoft (opens new window).

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

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

• "wsPort" – порт для работы WebSocket сервера, если не был указан иной во время установки, редактирования не требует;

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

• "maxPoolSize" - параметр отвечает за количество соединений с базой данных. По умолчанию, равен 10. Параметр менять только при крайней необходимости после консультации с техподдержкой Труконф.

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

"launchConference": true,
"syncConferenceParticipants": true,
"showCancelledEventsMode": true,
"cache": {
  "autoSync": false,
  "backward": 2,
  "forward": 3,
  "depth": 6,
  "maxSyncWorkers": 10
}

• "launchConference" – отвечает за автоматический запуск конференции. TrueConf Calendar Connector отправляет запрос в TrueConf Server во время начала события в Microsoft Exchange;

• "syncConferenceParticipants" – отвечает за синхронизацию списка участников, если выбрано true, календарь будет синхронизировать участников конференции перед стартом, а также при любом изменении списка участников данной конференции. Если параметр false, синхронизации участников не будет (параметр до версии TrueConf Calendar Connector 2.0 назывался "temporalConfParticipantsMode");

• "showCancelledEventsMode" - отвечает за показ отмененных событий в личном кабинете пользователя. Если true - в списке будут отмененные события (доступно только для версии TrueConf Calendar Connector 2.0+);

• "cache" – секция используемая для настройки параметров автоматической синхронизации:

  • "autoSync" – если выбрано значение true, производится полная синхронизация событий из календаря. Если указано false, ранее созданные события не будут отображаться в выбранном временном периоде;

  • "backward" – количество месяцев назад от текущей даты для отображения повторяющихся событий;

  • "forward" – количество месяцев вперед от текущей даты для отображения повторяющихся событий;

  • "depth" - количество месяцев назад от текущей даты для фильтрации событий. По умолчанию 6;

  • "maxSyncWorkers" - количество потоков для синхронизации пользовательских календарей. Значение этого параметра должно меняться в зависимости от пикового онлайна пользователей в календаре. Рекомендуем использовать значение 10 и менять его при необходимости.

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

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

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

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

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

  "calendarProviders": [
    {
      "host": "exchange.example.com", 
      "path": "/EWS/Exchange.asmx", 
      "autodiscoverPath": "/autodiscover/autodiscover.svc",
      "port": 443, 
      "type": "ews", 
      "allowInsecureConnection": true,
      "credentials": [
        {
          "login": "test",
          "password": "зашифрованный_пароль"
        } 
        ],
      "users": [
        "name1@example.com",
        "name2@example.com",
        "name3@example.com"
      ]
    }
  ]
}

• "calendarProviders" - секция для указания конфигураций внешних сервисов синхронизации календарей;

• "host" - домен, где расположен сервер Microsoft Exchange;

• "path" - путь для доступа к EWS API (указан путь по умолчанию);

• "autodiscoverPath" - обязательный параметр, используется для работы с кластером Exchange серверов и содержит путь к файлу автообнаружения (opens new window), а именно "host"/"autodiscoverPath". Необходимо указывать даже если в у вас всего один сервер Exchange. Данный параметр нет необходимости менять, просто оставляйте его без изменений;

• "port" - стандартный порт для подключения к EWS;

• "type" - название внешнего сервиса (поддерживается только Microsoft Exchange);

• "allowInsecureConnection" - разрешает использование незащищённого соединения. По умолчанию false.

• "credentials" - секция для указания данных учётной записи олицетворения на сервере Exchange;

  • "login" - логин учётной записи олицетворения на сервере Microsoft Exchange;

  • "password" - зашифрованный пароль от учётной записи. Генерируется с помощью терминала;

• "users" - массив email адресов пользователей, календари которых нужно принудительно синхронизировать при запуске службы tc_calendar.