> ## 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, щоб імпортувати дані про Phishing simulation і Training.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Пов’язані ресурси</h2>
    <ul>
      <li>
        <a href="/uk/signals/data-sources">Дізнайтеся, як дані інтеграцій перетворюються на сигнали Human Risk Management</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>Settings → Integrations → Catalog</strong>, знайдіть плитку{' '}
        <strong>{tile}</strong> і натисніть <strong>Connect</strong>.
      </li>
      <li>
        Заповніть наведені нижче поля, а потім натисніть <strong>Connect</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 може надавати Outcomes, пов’язані з Training і Phishing simulation. Серед розглянутих прикладів:

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

Ці приклади показують типи нормалізованої активності, які може використовувати Living Security. Див. [як дані інтеграції перетворюються на Signals](/uk/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-токенів вам потрібен доступ **Super Admin** або **Reporting Admin** у Proofpoint SAT.
* Токен має бути пов’язаний з обліковим записом, який має одну з необхідних ролей.

***

## Частина 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="Визначте свій regional results host">
    Виберіть хост, що відповідає вашому середовищу Proofpoint SAT:

    | Регіон | Regional results host |
    | - | - |
    | 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">
    | Field | Value |
    | - | - |
    | **API key** | Токен із частини A, крок 3 |
    | **Regional results host** | Хост із частини 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="Wrong regional host">
    Синхронізація даних завершуватиметься помилкою, якщо regional host не відповідає вашому середовищу SAT. Перевірте:

    * облікові записи US використовують `results.us.securityeducation.com`
    * облікові записи EU використовують `results.eu.securityeducation.com`
    * облікові записи AP використовують `results.ap.securityeducation.com`
  </Accordion>

  <Accordion title="Token generation not available">
    Якщо ви не бачите опції 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.