База знаний UtiClock

Техническое описание интеграции с Exchange/Office365/Teams

Приложение UtiClock поддерживает синхронизацию событий с сервером Microsoft Exchange. Мы используем клиент-серверную архитектуру в нашем продукте. Планшет с программным обеспечением UtiClock выполняет роль толстого клиента, а сервер с календарём в этом случае является хранилищем данных.

Для корректной работы синхронизации требуется установить на Exchange сервер EWS-Managed-API. EWS-Managed-API является официальным модулем компании Microsoft, предоставляющий API для получения и добавления событий в корпоративный календарь Exchange.

Важно, что Exchange сервер располагается на ресурсах заказчика, и компания Utinet не имеет и не должна иметь к нему доступ.

Планшет UtiClock выполняет https-запросы на Exchange сервер заказчика под отдельной учётной записью, используя исключительно задокументированное Microsoft API. EWS и управляемый API EWS предоставляют широкий набор операций и методов, которые позволяют выполнять широкий спектр задач, связанных с календарем. Например, с помощью управляемого API EWS можно создать собрание и отправить приглашения участникам с помощью всего нескольких строк кода, как показано в следующем примере. api exchange example

Подробнее про EWS и управляемый API EWS можно ознакомиться на официальном сайте microsoft – https://learn.microsoft.com/ru-ru/exchange/client-developer/exchange-web-services/calendars-and-ews-in-exchange

Для корректной работы программного обеспечения UtiClock у учётной записи, из-под которой выполняются запросы, должны быть следующие права:

  • права на чтение и запись событий в своём календаре,
  • права на чтение и запись событий в календарях ресурсов,
  • права на чтение и запись событий в календарях сотрудников,
  • права на чтение всех ресурсов,
  • права на чтение списка сотрудников,
  • права на олицетворение почтового ящика Exchange
Подробнее про олицетворение можно ознакомиться на официальном сайте microsoft:
здесь Олицетворение и EWS в Exchange,

здесь Настроить олицетворение,

и здесь Добавление встреч с помощью олицетворения Exchange

Мы не добавляем на сервер клиента свой код, не встраиваем подозрительные модули или библиотеки, работаем исключительно с официальными библиотеками и используем штатный API системы с календарём. Никакие данные сотрудников и событий не передаются третьим лицам или на сторонние ресурсы.