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

> Collegare KnowBe4 a Living Security Platform per importare utenti, iscrizioni ai corsi di formazione e risultati dei test di sicurezza di phishing.

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 EgressIpSafelist = ({system}) => <Note>
    <strong>Aggiunga tutti e quattro gli indirizzi IP di uscita della sincronizzazione di Living Security</strong> all'elenco di autorizzazione in{' '}
    {system}. Inserisca ciascuno come singolo host con <code>/32</code> se {system} richiede la notazione CIDR:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Il traffico può uscire da uno qualsiasi dei quattro indirizzi; pertanto, autorizzarne solo alcuni causa errori di
    sincronizzazione intermittenti. Questi quattro indirizzi sono gli stessi in tutte le regioni di Living Security. Per l'elenco completo, i criteri di modifica e la risoluzione dei problemi, consulti{' '}
    <a href="/it/integrations/managing/egress-ip-addresses">
      Configurazione degli indirizzi IP di uscita delle Integrazioni
    </a>.
  </Note>;

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="KnowBe4" />

## Cosa apporta questa integrazione

KnowBe4 può fornire risultati relativi a forza lavoro, formazione e simulazioni di phishing. Tra gli esempi esaminati figurano:

* `training.completed` — completa la formazione sulla sicurezza
* `training.past.due` — ha una formazione in ritardo
* `phishing.simulation.clicked` — ha fatto clic su una simulazione senza segnalarla

Questi esempi mostrano i tipi di attività normalizzata che Living Security può utilizzare. Consultare [come i dati delle integrazioni diventano segnali](/it/signals/data-sources).

## Cosa serve a Living Security

| Credenziale | Descrizione |
| - | - |
| **Chiave API** | Un token bearer della Reporting API generato in **Account Settings → API**. Viene inviato a ogni richiesta nell'intestazione `Authorization: Bearer`. |
| **Reporting API server region** | La regione su cui è predisposto il Suo account KnowBe4, scelta da un elenco (US, EU, Canada, UK, Germany). |

**Ambiti (scope):** Nessuno da configurare — i token della Reporting API di KnowBe4 sono di sola lettura per progettazione e non hanno ambiti. Il token concede l'accesso in lettura a utenti, iscrizioni ai corsi di formazione e risultati dei test di sicurezza di phishing, che è esattamente ciò che la sincronizzazione legge.

**Ruolo richiesto:** **Account Admin** in KnowBe4 (solo gli amministratori dell'account possono accedere a **Account Settings → API**)

### Prerequisiti

* È necessario aver effettuato l'accesso alla console KnowBe4 con il ruolo **Account Admin**. Solo gli amministratori dell'account possono accedere a **Account Settings → API** per abilitare la Reporting API e generare i token.

***

## Parte A — In KnowBe4

*Questi passaggi vengono eseguiti dall'amministratore KnowBe4.*

<Steps>
  <Step title="Abilitare la Reporting API e generare un token">
    1. Accedere alla console KnowBe4.
    2. Fare clic sul nome del proprio account nell'angolo in alto a destra e selezionare **Account Settings**.
    3. Nel menu di navigazione a sinistra, selezionare **API**.
    4. Abilitare la **Reporting API** se non è già abilitata, quindi generare un nuovo token API.

    Se la console lo richiede, assegnare al token una finalità descrittiva (ad es. `Living Security Platform`).

    <Warning>
      KnowBe4 mostra il valore del token API **una sola volta**, al momento della generazione. Copiarlo immediatamente e conservarlo in un luogo sicuro (ad es. un password vault o un gestore di segreti). Se si esce dalla pagina senza averlo copiato, sarà necessario generare un nuovo token.
    </Warning>

    <Note>
      La Reporting API è di sola lettura. Espone utenti, iscrizioni ai corsi di formazione e risultati dei test di sicurezza di phishing, ovvero i dati che Living Security acquisisce per il calcolo dei punteggi e la reportistica. Non è richiesto alcun accesso in scrittura.
    </Note>
  </Step>

  <Step title="Aggiungere gli IP di egress di Living Security all'elenco Allowed IP Addresses">
    KnowBe4 consente di limitare l'accesso alla Reporting API a un insieme specifico di indirizzi IP di origine. Questa impostazione si trova nella stessa sezione del token:

    1. Nella console KnowBe4, andare a **Account Settings → API → Allowed IP Addresses**.
    2. Aggiungere alla allowlist ogni [indirizzo IP di egress di Living Security](/it/integrations/managing/egress-ip-addresses). Gli stessi quattro indirizzi valgono per tutte le regioni.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Se l'elenco Allowed IP Addresses è configurato, viene applicato a livello di rete.** La finestra di connessione avrà esito positivo in fase di autenticazione, ma le sincronizzazioni dei dati non andranno a buon fine (bloccate a livello di rete, in genere con la comparsa di `403`) finché gli IP di egress di Living Security non saranno stati aggiunti alla allowlist. Se si aggiunge un qualsiasi indirizzo a questo elenco, è necessario aggiungere anche gli intervalli di Living Security, altrimenti le nostre richieste verranno rifiutate anche se il token è valido.
    </Warning>

    <Note>
      Gli indirizzi IP di egress di Living Security possono cambiare in caso di aggiornamento dell'infrastruttura, anche se tali modifiche sono rare. Se le sincronizzazioni dei dati iniziano a non riuscire dopo aver funzionato correttamente, consultare [Configurazione degli indirizzi IP di egress delle integrazioni](/it/integrations/managing/egress-ip-addresses) e verificare che l'elenco Allowed IP Addresses corrisponda.
    </Note>
  </Step>

  <Step title="Identificare la regione del server KnowBe4">
    KnowBe4 eroga la Reporting API da un host specifico per regione. La regione si seleziona nella finestra di connessione, senza digitare un nome host:

    | Regione | Host della Reporting API |
    | - | - |
    | Stati Uniti | `us.api.knowbe4.com` |
    | Europa | `eu.api.knowbe4.com` |
    | Canada | `ca.api.knowbe4.com` |
    | Regno Unito | `uk.api.knowbe4.com` |
    | Germania | `de.api.knowbe4.com` |

    Se non si è certi della regione utilizzata dal proprio account, controllare il dominio dell'URL della console KnowBe4 oppure rivolgersi all'amministratore KnowBe4.

    <Note>
      Queste cinque regioni sono quelle raggiungibili da Living Security. Se il Suo account KnowBe4 si trova su un altro server (ad esempio un'istanza US Government), contatti il supporto di Living Security prima di avviare la connessione.
    </Note>
  </Step>
</Steps>

***

## Parte B — In Living Security Platform

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

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | Campo | Valore |
    | - | - |
    | **Chiave API** | Il token della Reporting API ottenuto nella Parte A, passaggio 1 |
    | **Reporting API server region** | La regione indicata nella Parte A, passaggio 3 (ad es. Stati Uniti) |
  </ConnectInPlatform>
</Steps>

La connessione a KnowBe4 è ora attiva.

***

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Il token API non è valido o è scaduto. Verificare che il token sia corretto e che non sia stato rigenerato in **Account Settings → API**.
  </Accordion>

  <Accordion title="403 Forbidden">
    Il token non dispone dell'accesso alla Reporting API, oppure l'IP della richiesta non è presente nell'elenco Allowed IP Addresses. Verificare che la Reporting API sia abilitata e che tutti e quattro gli [indirizzi IP di egress di Living Security](/it/integrations/managing/egress-ip-addresses) siano presenti nella allowlist.
  </Accordion>

  <Accordion title="Risultati vuoti (200 OK ma nessun dato)">
    È possibile che la Reporting API non abbia ancora dati da restituire, oppure che l'account del token non abbia visibilità sugli utenti e sulle campagne che Living Security acquisisce. Verificare che il token sia stato generato da un Account Admin.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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