> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Подключите Proofpoint SAT для импорта данных о симуляциях фишинга и обучении.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Связанные ресурсы</h2>
    <ul>
      <li>
        <a href="/ru/signals/data-sources">Узнайте, как данные Интеграций преобразуются в Сигналы управления человеческими рисками</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Ознакомьтесь с Интеграциями Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Откройте Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Запросите демонстрацию Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Введите учётные данные в Living Security Platform">
    <p>
      Выполняется пользователем, имеющим доступ к Living Security: владельцем программы или
      системным администратором, если он был приглашён (делегированная настройка).
    </p>
    <ol>
      <li>
        Перейдите в раздел <strong>Настройки → Интеграции → Каталог</strong>, найдите плитку{' '}
        <strong>{tile}</strong> и нажмите <strong>Подключиться</strong>.
      </li>
      <li>
        Заполните поля ниже, затем нажмите <strong>Подключиться</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Это руководство предназначено для администратора {system}.</strong> В нём описано создание учётных данных API
      в {system}, для чего требуется доступ администратора к {system}, а не к
      Living Security Platform.
    </p>
    <p>
      Если вы являетесь <strong>владельцем программы</strong> Living Security и не администрируете {system},
      передайте эту страницу тому, кто им занимается. Этот сотрудник выполнит часть A и передаст учётные данные вам
      (или введёт их самостоятельно, если вы пригласили его в платформу).
      {recommendDelegated && <>
          {' '}Поскольку в ходе настройки создаются конфиденциальные ключевые данные, рекомендуем использовать{' '}
          <strong>делегированную настройку</strong>: в этом случае секрет не передаётся вам.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Proofpoint SAT" />

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

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

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

Эти примеры показывают типы нормализованной активности, которые может использовать Living Security. См. раздел [как данные интеграций преобразуются в сигналы](/ru/signals/data-sources).

## Что необходимо для 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.*

<Steps>
  <Step title="Перейдите к настройкам токена API">
    1. Войдите на портал Proofpoint Security Awareness Training.
    2. Нажмите на имя своей учётной записи или меню администратора в правом верхнем углу и выберите **Settings**.
    3. В левой панели навигации найдите **Integrations** или **API** и откройте страницу **Results API** или **Token Mart**.

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

  <Step title="Создайте новый токен API">
    1. Нажмите **Generate Token** (или **Create New Token**).
    2. Введите описательное имя (например, `Living Security Platform`).
    3. Выберите подходящую роль или уровень доступа:

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

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

    4. Сохраните токен.
  </Step>

  <Step title="Скопируйте и сохраните токен">
    **Сразу скопируйте токен** и надёжно сохраните его.

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

  <Step title="Определите региональный хост результатов">
    Выберите хост, соответствующий вашей среде Proofpoint SAT:

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

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

***

## Часть B. В Living Security Platform

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

<Steps>
  <ConnectInPlatform tile="Proofpoint Security Awareness Training">
    | Поле | Значение |
    | - | - |
    | **Ключ API** | Токен из части A, шаг 3 |
    | **Региональный хост результатов** | Хост из части A, шаг 4 (значение по умолчанию для US: `results.us.securityeducation.com`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/proofpoint-security-awareness-training/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=2a8ddf5dd1a87b272d876b0ba4569fec" alt="Диалоговое окно подключения Living Security для Proofpoint SAT" style={{maxWidth: "450px"}} width="576" height="372" data-path="integrations/images/proofpoint-security-awareness-training/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

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

***

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

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Токен недействителен или срок его действия истёк. Убедитесь, что:

    1. Токен указан верно и не был отозван
    2. Токен был создан с надлежащей ролью доступа
  </Accordion>

  <Accordion title="403 Forbidden">
    У токена нет доступа к необходимым конечным точкам отчётности. Убедитесь, что токен создан с ролью **Super Admin**, **Reporting Admin** или **Reporting API**.
  </Accordion>

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

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

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

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.