> ## 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.

# Configurazione dell'integrazione con Proofpoint Security Awareness

> Collegare Proofpoint SAT per importare i dati di simulazione di phishing e di formazione.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Risorse correlate</h2>
    <ul>
      <li>
        <a href="/it/signals/data-sources">Scopra come i dati delle integrazioni diventano segnali di Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Scopra le integrazioni di Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Apra la Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Richieda una demo di Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Inserire le credenziali in Living Security Platform">
    <p>
      Operazione da eseguire a cura di chi dispone dell'accesso a Living Security: il responsabile del programma oppure, se è stato invitato (configurazione delegata), l'amministratore di sistema.
    </p>
    <ol>
      <li>
        Andare in <strong>Impostazioni → Integrazioni → Catalogo</strong>, individuare il riquadro{' '}
        <strong>{tile}</strong> e fare clic su <strong>Connetti</strong>.
      </li>
      <li>
        Compilare i campi riportati di seguito, quindi fare clic su <strong>Connetti</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Questa guida è destinata all'amministratore di {system}.</strong> Descrive la creazione delle credenziali API all'interno di {system}, operazione che richiede l'accesso come amministratore a {system} e non alla
      Living Security Platform.
    </p>
    <p>
      Se Lei è il <strong>responsabile del programma</strong> Living Security e non amministra {system},
      inoltri questa pagina al responsabile dell'amministrazione di {system}. L'amministratore completerà la Parte A e Le restituirà le credenziali
      (oppure le inserirà direttamente, se è stato invitato nella piattaforma).
      {recommendDelegated && <>
          {' '}Poiché la configurazione genera materiale crittografico sensibile, si consiglia di seguire la procedura di{' '}
          <strong>configurazione delegata</strong>, in modo che il segreto non Le venga mai inviato.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Proofpoint SAT" />

## Cosa apporta questa integrazione

Proofpoint Security Awareness può fornire risultati relativi alla formazione e alle simulazioni di phishing. Gli esempi esaminati includono:

* `training.completed` — completa la formazione sulla sicurezza
* `phishing.simulation.attachment.opened` — apre gli allegati delle simulazioni di phishing
* `phishing.real.reported` — segnala e-mail di phishing reali

Questi esempi mostrano i tipi di attività normalizzata che Living Security è in grado di utilizzare. Consultare [come i dati di integrazione diventano segnali](/it/signals/data-sources).

## Cosa richiede Living Security

| Credenziale | Descrizione |
| - | - |
| **Token API** | Un token di accesso generato dal portale Proofpoint SAT |
| **Host regionale dei risultati** | Il nome host del proprio ambiente Proofpoint SAT |

**Ambiti (scope):** accesso agli endpoint di reporting di Phishing (ThreatSim) e PhishAlarm

**Ruolo richiesto:** **Super Admin**, **Reporting Admin** o **Reporting API** in Proofpoint SAT

### Prerequisiti

* Per generare i token API è necessario disporre dell'accesso **Super Admin** o **Reporting Admin** in Proofpoint SAT.
* Il token deve essere associato a un account che possieda uno dei ruoli richiesti.

***

## Parte A — In Proofpoint SAT

*Questi passaggi vengono eseguiti dall'amministratore di Proofpoint SAT.*

<Steps>
  <Step title="Accedere alle impostazioni dei token API">
    1. Accedere al portale Proofpoint Security Awareness Training.
    2. Fare clic sul nome del proprio account o sul menu di amministrazione in alto a destra e selezionare **Settings**.
    3. Nel menu di navigazione a sinistra, individuare **Integrations** o **API** e aprire la pagina **Results API** o **Token Mart**.

    <Note>
      Il percorso di navigazione esatto varia in base alla versione del portale. Se l'opzione **Token Mart** o **Results API** non è visibile, contattare l'amministratore Proofpoint: la generazione dei token potrebbe richiedere l'abilitazione di una funzionalità della piattaforma.
    </Note>
  </Step>

  <Step title="Generare un nuovo token API">
    1. Fare clic su **Generate Token** (o **Create New Token**).
    2. Immettere un nome descrittivo (ad esempio, `Living Security Platform`).
    3. Selezionare il ruolo o il livello di accesso appropriato:

    | Ruolo | Descrizione |
    | - | - |
    | **Super Admin** | Accesso completo alla piattaforma, inclusi tutti gli endpoint di reporting |
    | **Reporting Admin** | Accesso in lettura a tutti gli endpoint di reporting |
    | **Reporting API** | Ruolo con privilegi minimi, limitato ai soli endpoint di reporting |

    <Note>
      **Raccomandazione sul privilegio minimo:** utilizzare il ruolo **Reporting API**, se disponibile. In questo modo il token è limitato all'accesso di sola lettura al reporting.
    </Note>

    4. Salvare il token.
  </Step>

  <Step title="Copiare e salvare il token">
    **Copiare subito il token** e conservarlo in modo sicuro.

    <Warning>
      Il token potrebbe essere visualizzato una sola volta, al momento della creazione. Se si abbandona la pagina senza copiarlo, potrebbe essere necessario revocarlo e rigenerarlo.
    </Warning>
  </Step>

  <Step title="Individuare l'host regionale dei risultati">
    Selezionare l'host corrispondente al proprio ambiente Proofpoint SAT:

    | Regione | Host regionale dei risultati |
    | - | - |
    | US | `results.us.securityeducation.com` |
    | EU | `results.eu.securityeducation.com` |
    | AP | `results.ap.securityeducation.com` |

    Immettere **solo l'host**, senza il prefisso `https://` e senza barra finale.
  </Step>
</Steps>

***

## Parte B — Nella Living Security Platform

*Questo passaggio viene eseguito dal responsabile del programma oppure dall'amministratore di sistema, in caso di configurazione delegata.*

<Steps>
  <ConnectInPlatform tile="Proofpoint Security Awareness Training">
    | Campo | Valore |
    | - | - |
    | **Chiave API** | Il token ottenuto nella Parte A, passaggio 3 |
    | **Host regionale dei risultati** | L'host indicato nella Parte A, passaggio 4 (impostazione predefinita per gli 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="Finestra di dialogo di connessione di Living Security per Proofpoint SAT" style={{maxWidth: "450px"}} width="576" height="372" data-path="integrations/images/proofpoint-security-awareness-training/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

La connessione a Proofpoint Security Awareness Training è ora attiva.

***

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Il token non è valido o è scaduto. Verificare che:

    1. Il token sia corretto e non sia stato revocato
    2. Il token sia stato generato con il corretto livello di accesso per il ruolo
  </Accordion>

  <Accordion title="403 Forbidden">
    Il token non dispone dell'accesso agli endpoint di reporting richiesti. Verificare che il token sia stato creato con il ruolo **Super Admin**, **Reporting Admin** o **Reporting API**.
  </Accordion>

  <Accordion title="Host regionale errato">
    Le sincronizzazioni dei dati non andranno a buon fine se l'host regionale non corrisponde al proprio ambiente SAT. Verificare che:

    * gli account US utilizzino `results.us.securityeducation.com`
    * gli account EU utilizzino `results.eu.securityeducation.com`
    * gli account AP utilizzino `results.ap.securityeducation.com`
  </Accordion>

  <Accordion title="Generazione del token non disponibile">
    Se l'opzione Token Mart o Results API non è visibile nelle impostazioni, la funzionalità potrebbe non essere abilitata per il proprio account. Contattare l'amministratore Proofpoint o il Customer Success Manager.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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