Справочные материалы по интеграции службы календаря гибридного типа Cisco Webex с Календарем Google

Функции

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

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

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

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

Справочные материалы по интеграции службы календаря гибридного типа Cisco Webex с Office 365
Справочные материалы по интеграции службы календаря гибридного типа Cisco Webex с Microsoft Exchange (для развертываний соединителя календаря на основе Expressway)

Информацию о новейших функциях и развертывании см. в 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	Чтение состояния отсутствия на рабочем месте.

Полномочие

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

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

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

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

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

https://www.googleapis.com/auth/gmail.settings.basic

Чтение состояния отсутствия на рабочем месте.

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

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

С помощью данных учетной записи службы приложение получает от сервера авторизации Google маркеры доступа уровня пользователя для доступа к календарям пользователей.
Маркер доступа используется приложением в 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	Отображение состояния доступности пользователя, а также его состояния "Свободен" или "Занят" в указанном интервале времени.