Настройка интеграции с Proofpoint Security Awareness

Что передаёт эта интеграция

Proofpoint Security Awareness может передавать результаты обучения и симуляций фишинга. Среди проверенных примеров:

training.completed — проходит обучение по безопасности
phishing.simulation.attachment.opened — открывает вложения в рамках симуляции фишинга
phishing.real.reported — сообщает о реальных фишинговых письмах

Эти примеры показывают типы нормализованной активности, которые может использовать Living Security. См. раздел как данные интеграций преобразуются в сигналы.

Что необходимо для Living Security

Учётные данные	Описание
API token	Токен доступа, созданный на портале Proofpoint SAT
Regional results host	Имя хоста вашей среды Proofpoint SAT

Области доступа: доступ к конечным точкам отчётности Phishing (ThreatSim) и PhishAlarm Необходимая роль: Super Admin, Reporting Admin или Reporting API в Proofpoint SAT

Предварительные требования

Для создания токенов API в Proofpoint SAT необходим доступ Super Admin или Reporting Admin.
Токен должен быть связан с учётной записью, которой назначена одна из необходимых ролей.

Часть A. В Proofpoint SAT

Эти шаги выполняет администратор Proofpoint SAT.

Перейдите к настройкам токена API

Войдите на портал Proofpoint Security Awareness Training.
Нажмите на имя своей учётной записи или меню администратора в правом верхнем углу и выберите Settings.
В левой панели навигации найдите Integrations или API и откройте страницу Results API или Token Mart.

Точный путь навигации зависит от версии портала. Если параметр Token Mart или Results API отсутствует, обратитесь к администратору Proofpoint: для создания токенов может потребоваться включить соответствующую функцию платформы.

Создайте новый токен API

Нажмите Generate Token (или Create New Token).
Введите описательное имя (например, Living Security Platform).
Выберите подходящую роль или уровень доступа:

Роль	Описание
Super Admin	Полный доступ к платформе, включая все конечные точки отчётности
Reporting Admin	Доступ на чтение ко всем конечным точкам отчётности
Reporting API	Роль с минимально необходимыми привилегиями, ограниченная конечными точками отчётности

Рекомендация по минимальным привилегиям: используйте роль Reporting API, если она доступна. Она ограничивает токен доступом к отчётности только на чтение.

Сохраните токен.

Скопируйте и сохраните токен

Сразу скопируйте токен и надёжно сохраните его.

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

Определите региональный хост результатов

Выберите хост, соответствующий вашей среде Proofpoint SAT:

Регион	Региональный хост результатов
US	`results.us.securityeducation.com`
EU	`results.eu.securityeducation.com`
AP	`results.ap.securityeducation.com`

Укажите только хост — без префикса https:// и без завершающей косой черты.

Часть B. В Living Security Platform

Этот шаг выполняет владелец программы или системный администратор, если используется делегированная настройка.

Подключение к Proofpoint Security Awareness Training выполнено.

Устранение неполадок

401 Unauthorized

Токен недействителен или срок его действия истёк. Убедитесь, что:

Токен указан верно и не был отозван
Токен был создан с надлежащей ролью доступа

403 Forbidden

У токена нет доступа к необходимым конечным точкам отчётности. Убедитесь, что токен создан с ролью Super Admin, Reporting Admin или Reporting API.

Неверный региональный хост

Синхронизация данных завершится ошибкой, если региональный хост не соответствует вашей среде SAT. Проверьте следующее:

для учётных записей US используется results.us.securityeducation.com
для учётных записей EU используется results.eu.securityeducation.com
для учётных записей AP используется results.ap.securityeducation.com

Создание токена недоступно

Если в настройках отсутствует параметр Token Mart или Results API, возможно, эта функция не включена для вашей учётной записи. Обратитесь к администратору Proofpoint или менеджеру по работе с клиентами (Customer Success Manager).

Интеграции