Как разрешить или заблокировать отправку вебхука

Эта функция доступна в версиях Business Starter, Business Standard, Business Plus, Enterprise Standard, Enterprise Plus, Education Fundamentals, Education Standard, Teaching and Learning add-on и Education Plus. Эта функция доступна в дополнении Google AI Pro for Education.

Эта функция находится на стадии ограниченного предварительного просмотра.

Вебхуки позволяют потокам отправлять или получать данные с помощью внешней ссылки или API. Шаг с вебхуком позволяет подключаться к внутренним и внешним ресурсам, которые напрямую не поддерживаются в Google Workspace Studio. Однако при предоставлении внешнего доступа к данным организации необходимо соблюдать осторожность. Передача данных по незашифрованному протоколу HTTP (http://) небезопасна. Используйте протокол HTTPS (https://).

Чтобы защитить данные организации, в Workspace Studio предусмотрено несколько мер безопасности:

  • Отключены по умолчанию. Вебхуки отключены, пока администратор не включит их для организационного подразделения.
  • Белый список URL. В поддерживаемых версиях вебхуки отправляют данные только в домены и конечные точки, указанные в белом списке URL организации.
  • Одобрение пользователя. По умолчанию каждый шаг вебхука должен быть проверен и подтвержден пользователем перед выполнением.
  • Данные журнала событий. Запросы на выполнение вебхуков записываются как события журнала Workspace Studio.

Шаг 1. Включите или отключите вебхуки

Подготовка. Если вам нужно подготовить отдел или группу для этого параметра, ознакомьтесь со статьей Как добавить организационное подразделение.

  1. В консоли администратора Google нажмите на значок меню > Приложения > Google Workspace > Workspace Studio.

    У вас должно быть право администратора "Настройки сервисов".

  2. Нажмите Настройки вебхуков.
  3. Чтобы применить параметр к отделу или команде, сбоку выберите организационное подразделение.
  4. Выберите ВКЛ., чтобы разрешить пользователям в выбранном организационном подразделении использовать шаги вебхуков в потоках, или ВЫКЛ., чтобы заблокировать шаги вебхуков.
  5. Нажмите Сохранить. Вы также можете нажать Переопределить для организационного подразделения.

    Чтобы вернуться к наследуемому значению, нажмите Наследовать.

Шаг 2. Ограничьте вебхуки белым списком URL (необязательно)

Эта функция доступна в версиях Business Plus, Enterprise Standard, Enterprise Plus, Education Standard и Education Plus. Ознакомьтесь со сравнением версий.

Вы можете ограничить шаги вебхука, чтобы отправлять или получать данные только из определенных доменов и URL, внесенных в белый список. Для этого используется общий белый список URL для Google Диска, Документов, Таблиц и Apps Script.

Примечание. В версиях, которые не поддерживают белые списки URL, вебхуки могут подключаться ко всем действительным URL, если эта функция включена.

Как управлять белым списком URL

  1. В консоли администратора Google нажмите на значок меню > Приложения > Google Workspace > Диск и Документы > Функции и приложения.

    У вас должно быть право администратора "Настройки сервисов".

  2. Нажмите Импорт и получение данных по URL.
  3. Выберите Разрешить импорт и получение данных только с помощью следующих URL.
  4. Введите авторизованные URL или домены (например, https://api.example.com).
  5. Нажмите Сохранить.

Одобрение пользователем шагов вебхука

Поскольку шаги вебхука взаимодействуют с внешними конечными точками, они считаются действиями, требующими повышенной безопасности. Если в процессе используется шаг вебхука, Workspace Studio требует, чтобы пользователь, который запускает или выполняет процесс, проверил и подтвердил действие перед его запуском.

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

Как отслеживать действия вебхуков с помощью событий журнала

Вы можете посмотреть данные об использовании вебхуков в событиях журнала Workspace Studio в консоли администратора.

Подготовка. Данные о событиях в журнале вебхуков включают конфиденциальный контент, например URL. Чтобы просматривать этот контент, вы должны быть суперадминистратором или ваш администратор должен включить параметр Просмотр конфиденциальных данных.

  1. В консоли администратора Google нажмите на значок меню > Отчеты > Аудит и анализ > События журнала Workspace Studio.

    Требуется право администратора Инструмент "Аудит и анализ".

  2. Нажмите Фильтр > Добавить фильтр > Название шага.
  3. Добавьте фильтр, используя одно из следующих значений:
    • Выберите Содержит и введите webhook.
    • Выберите Равно и введите Отправить вебхук.
  4. Проверьте параметры события:
    • URL запроса вебхука. Целевой URL, вызываемый шагом вебхука. URL считается конфиденциальными данными.