Функции

В настоящий момент интеграция обеспечивает следующие важные функции.

  1. Возможность планирования конечными пользователями совместной работы на совещании с помощью любого клиента календаря, подключенного к календарю G Suite Google (Календарь Google) без необходимости установки подключаемых модулей или расширений. Для этого достаточно ввести ключевое слово в поле "Местоположение" (например, @webex or @meet).

  2. Показывать список совещаний пользователям вПриложение Webexприложения (настольные и мобильные) и на физических конечных точках.

  3. Всплывающее уведомление с кнопкой для присоединения, также известное как функция "Одно нажатие кнопки" (OBTP).

  4. Обновленные пользователиПриложение WebexОбновление состояния доступности Webex пользователя при включенном автоответчике в Gmail (иногда называемом состоянием отсутствия в офисе).

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

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

Информацию о новейших функциях и развертывании см. в https://www.cisco.com/go/hybrid-services-calendar.

Обработка данных

ЭлементКалендарь службы гибридного типаполучает сведения о совещании от системы календаря и анализирует такие параметры, как место проведения совещания и содержимое URI и URL, которые могут быть использованы для присоединения к совещаниям. Для заполнения списка совещаний в списке совещаний служба использует другую информацию, например время начала и окончания, и приглашенныеПриложение Webexи на некоторых устройствах, а также для обеспечения услуги "Одно нажатие кнопки" (OBTP). Конфиденциальная информация (например, описание и текст совещания или адреса электронной почты приглашенных) в незашифрованном виде не будет сохранена или отправлена службой ни при каких условиях. Отправка в облако Webex зашифрованных данных (а также хранение в зашифрованном виде) осуществляется для подготовки списков совещаний и работы функции OBTP.

Для шифрования данных вКалендарь службы гибридного типаиспользует ту же службу шифрования в облаке Webex, что иПриложение Webexиспользуется приложением . Таким образом, управление ключами обеспечивается облачной km management Server (KMS) или, если вы решили развернутьСлужба безопасности данных гибридного типа, в вашей локальной KMS. (Подробнее см. Приложение WebexДокумент безопасности.)

Аутентификация и авторизация при развертывании

ЭлементКалендарь службы гибридного типаиспользует процесс предоставления учетных данных клиента OAuth 2.0 серверу авторизации Google.

Процесс аутентификации приложения

ЭлементКалендарь службы гибридного типазарегистрирована в Google в качестве приложения. В связи с этим используется учетная запись службы с делегированием на уровне домена во избежание необходимости получения разрешения от пользователя. (Дополнительные сведения см. https://developers.google.com/identity/protocols/OAuth2ServiceAccount.)

ЭлементКалендарь службы гибридного типадолжна обладать следующими полномочиями приложения.

Полномочие

Использование

Управление календарями пользователя

https://www.googleapis.com/auth/calendar

  • Изменение текста совещания в соответствии со сведениями о присоединении.

  • Определения языка пользователя для целей локализации.

Управление базовыми настройками почты

https://www.googleapis.com/auth/gmail.settings.basic
  • Чтение состояния отсутствия на рабочем месте.

ВControl HubВ только администраторы с особым доступом могут выполнить подготовку организации клиента для использования .Календарь службы гибридного типа. Администратор должен скопировать и вировать ID клиента и области авторизации изControl Hubв раздел Управление доступом клиента API консоли администрирования домена Google G Suite.

Процесс включает следующие высокоуровневые действия.

  1. С помощью данных учетной записи службы приложение получает от сервера авторизации Google маркеры доступа уровня пользователя для доступа к календарям пользователей.

  2. Маркер доступа используется приложением в API-вызовах Календаря Google для получения доступа к информации календаря.

Процесс подготовки

Активация пользователей для доступа к календарю

После успешной подготовки Службы календаря гибридного типа в качестве зарегистрированного приложения администратор должен явно активировать пользователей, чтобы разрешить службе доступ к соответствующим календарям G Suite.

Чтобы успешно активировать пользователя для доступа к календарю необходимо выполнить следующие условия:

  • Адрес электронной почты пользователя в Control Hub должен совпадать с его учетной записью календаря Google в клиенте Google G Suite организации.

  • Администратор должен проверить домен в адресе электронной почты пользователя или пользователю необходимо проверить свой адрес электронной почты, выполнив вход в Webex.Приложение Webex.

При активации пользователя в службу календаря гибридного типа передается сообщение о том, что у нее имеются требуемые разрешения для доступа к календарю пользователя в G Suite.

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

Текущие операции

ЭлементКалендарь службы гибридного типаиспользует REST API Календаря Google. Этот API поддерживает целый ряд операций с Календарем Google. Вместе с тем,Календарь службы гибридного типаОднако использует только часть команд, которые имеют отношение к использованию календаря.

Таблица 1. Операции, которые используются службой календаря гибридного типа в данный момент

REST API

Использование

GET calendars/{calendarId}/events

Отображение списка событий календаря.

GET calendars/{calendarId}/events/{eventId}/instances

Отображение повторений определенных повторяющихся событий.

GET /calendars/{calendarId}/events/{eventId}

Предоставление информации об одном событии в календаре.

PATCH /calendars/{calendarId}/events/{eventId}

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

POST /calendars/{calendarId}/events/quickAdd

Создание события на основе простой текстовой строки.

POST /calendars/{calendarId}/events/watch

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

POST /channels/stop

Отмена подписки на уведомления об изменениях в календаре пользователя.

GET /users/me/settings/{setting}

Получение данных о местоположении пользователя.

GET /users/{userId}/settings/vacation

Получение настроек автоответчика пользователя.

POST /calendars/{calendarId}/acl

Создание правила для управления доступом.

DELETE /calendars/{calendarId}/acl

Удаление правила для управления доступом.

POST /calendars/{calendarId}/events

Создание события в календаре.

DELETE /calendars/{calendarId}/events/{eventId}

Удаление события из календаря.

GET /freeBusy

Отображение состояния доступности пользователя, а также его состояния "Свободен" или "Занят" в указанном интервале времени.