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

> Collegate NINJIO a Living Security Platform per importare i risultati della formazione sulla consapevolezza della sicurezza e gli esiti delle simulazioni di phishing relativi alla vostra forza lavoro.

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

## Cosa fornisce questa integrazione

NINJIO può fornire risultati relativi a forza lavoro, formazione e simulazioni di phishing. Gli esempi esaminati includono:

* `training.assigned` — ha una formazione sulla sicurezza assegnata
* `training.completed` — completa la formazione sulla sicurezza
* `training.passed` — supera le valutazioni della formazione sulla sicurezza
* `phishing.simulation.clicked` — ha cliccato su una simulazione senza segnalarla
* `phishing.simulation.reported` — segnala le simulazioni di phishing

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

## Cosa richiede Living Security

| Credenziale | Descrizione |
| - | - |
| **Chiave API** | Una chiave API di NINJIO con accesso in lettura ai punti di accesso relativi a dipendenti, formazione e phishing. Living Security la invia a ogni richiesta. |

**Ambiti:** NINJIO definisce l'ambito di ogni chiave API per *punto di accesso*, con permessi di lettura e di scrittura distinti. Living Security richiede la **lettura** su tre punti di accesso: dipendenti, formazione e phishing. L'accesso in scrittura non è necessario e non deve essere concesso.

**Ruolo richiesto:** **Administrator** sul vostro account NINJIO. Solo gli amministratori possono accedere all'area Integration in cui vengono create le chiavi.

<Warning>
  **NINJIO mostra una nuova chiave una sola volta, al momento della creazione.** Copiatela subito in Living Security Platform o in un password vault prima di uscire dalla pagina. Una chiave che non è stata copiata non può essere recuperata: è necessario generarne una nuova.
</Warning>

### Cosa recupera Living Security

| Dati | Dettaglio |
| - | - |
| **Discenti** | L'elenco dei dipendenti di NINJIO: nome, indirizzo email, reparto, qualifica, responsabile, paese, filiale e stato attivo. |
| **Formazione** | A chi è stata assegnata ciascuna formazione e chi l'ha completata, con data di completamento, punteggio dell'esame e punteggio di coinvolgimento. |
| **Phishing** | Chi ha interagito con un'email di phishing simulata e chi l'ha segnalata, con l'ora in cui è avvenuto. |

<Note>
  **I numeri di telefono dei discenti non vengono memorizzati.** NINJIO restituisce un numero di telefono nel record del dipendente. Living Security lo scarta prima di memorizzare qualsiasi dato, perché nessuna funzionalità di Living Security lo utilizza.
</Note>

### Prerequisiti

* Un account NINJIO con accesso API.
* Accesso come amministratore a [admin.goninjio.com](https://admin.goninjio.com/).
* Indirizzi email dei discenti in NINJIO che corrispondano a quelli utilizzati dagli altri sistemi collegati. Living Security associa un discente di NINJIO a una persona tramite l'indirizzo email.

***

## Parte A — In NINJIO

*L'amministratore NINJIO completa questi passaggi.*

<Steps>
  <Step title="Aprire l'area Integration">
    1. Accedete a [admin.goninjio.com](https://admin.goninjio.com/) come amministratore.
    2. Selezionate **Integration** in alto a destra nella schermata.
  </Step>

  <Step title="Creare la chiave API">
    1. Selezionate **New API Key**.
    2. Assegnate alla chiave un nome che possiate riconoscere in seguito, ad esempio `Living Security`.
    3. Concedete l'accesso in **lettura** ai punti di accesso **employee**, **training** e **phishing**.
    4. Lasciate deselezionato l'accesso in scrittura. Living Security si limita a leggere i dati da NINJIO.
    5. Selezionate **Generate Key**.

    <Warning>
      Copiate subito la chiave. NINJIO la mostra una sola volta e non può visualizzarla di nuovo.
    </Warning>
  </Step>
</Steps>

***

## Parte B — In Living Security Platform

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

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | Campo | Valore |
    | - | - |
    | **Chiave API** | La chiave generata nella Parte A |
  </ConnectInPlatform>
</Steps>

A questo punto la connessione a NINJIO è stabilita.

***

## Frequenza di recupero dei dati

| Dati | Pianificazione |
| - | - |
| Discenti | Ogni giorno |
| Risultati della formazione | Ogni 6 ore |
| Risultati del phishing | Ogni 6 ore |

Alla prima connessione, Living Security recupera i completamenti della formazione degli ultimi 12 mesi, quindi prosegue in modo incrementale. Le simulazioni di phishing vengono lette una sola volta e ricontrollate per due settimane dopo la loro conclusione, in modo da acquisire anche i clic e le segnalazioni tardivi.

<Note>
  La prima connessione a un account NINJIO di grandi dimensioni può richiedere diverse esecuzioni pianificate per completare la lettura di tutti i dati. Ogni esecuzione legge quanto possibile e la successiva riprende dal punto in cui si era interrotta; i conteggi quindi aumentano progressivamente nell'arco del primo giorno o dei primi due giorni, anziché comparire tutti insieme.
</Note>

***

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    La chiave API è errata o incompleta. La causa più comune è una chiave copiata solo in parte: NINJIO la mostra una sola volta, per cui un incolla troncato è facile da commettere e impossibile da individuare in seguito. Generate una nuova chiave in NINJIO ed eseguite di nuovo la connessione con essa.
  </Accordion>

  <Accordion title="403 Forbidden">
    Questo **non** è un problema di credenziali. La chiave è stata autenticata, ma a uno dei punti di accesso necessari non è stato concesso il permesso di lettura.

    Incollare di nuovo la stessa chiave non risolverà il problema. In NINJIO, create una chiave con accesso in **lettura** a tutti e tre i punti di accesso (employee, training e phishing) ed eseguite di nuovo la connessione con quella chiave.
  </Accordion>

  <Accordion title="Connessione riuscita ma nessun dato di formazione">
    Verificate in NINJIO che almeno una campagna di formazione sia **attiva** e abbia una simulazione associata. Una campagna senza simulazione resta inattiva e non produce alcun dato, quindi non ci sono risultati da recuperare.

    Se le campagne sono attive, verificate che i discenti inclusi abbiano un indirizzo email nei rispettivi record NINJIO. Un discente privo di indirizzo email non può essere associato a una persona e viene ignorato.
  </Accordion>

  <Accordion title="La formazione risulta assegnata ma mai completata">
    È la visualizzazione prevista per una formazione che il discente non ha ancora terminato. Living Security registra l'assegnazione all'avvio della simulazione NINJIO e registra il completamento separatamente, quando NINJIO comunica una data di completamento.
  </Accordion>

  <Accordion title="Mancano alcuni discenti">
    Living Security associa un discente di NINJIO a una persona tramite l'**indirizzo email**. Un discente il cui indirizzo email in NINJIO differisce da quello presente nella vostra directory, ad esempio un indirizzo personale, un dominio precedente o un errore di battitura, non verrà associato.

    Correggete l'indirizzo in NINJIO: l'associazione avverrà al successivo recupero pianificato.
  </Accordion>

  <Accordion title="Mancano i risultati del phishing per una simulazione meno recente">
    Living Security ricontrolla una simulazione di phishing per due settimane dopo la sua conclusione, poi smette. I risultati che NINJIO registra dopo tale periodo non vengono acquisiti. Contattate il supporto se desiderate che una simulazione meno recente venga riletta.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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