> ## 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 Adaptive Security

> Collegare Adaptive Security a Living Security Platform per importare i risultati delle simulazioni di phishing, smishing e vishing, nonché i risultati della formazione sulla sicurezza per la 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="Adaptive Security" />

## Che cosa apporta questa integrazione

Adaptive Security può fornire dati relativi alla forza lavoro, alla formazione e ai risultati delle simulazioni multicanale. Tra gli esempi esaminati figurano:

* `phishing.simulation.clicked` — ha cliccato su un'e-mail simulata senza segnalarla
* `phishing.simulation.credential.submitted` — ha inserito le credenziali in una pagina di accesso simulata
* `phishing.simulation.attachment.opened` — ha aperto un allegato di un'e-mail simulata
* `phishing.simulation.reported` — ha segnalato un'e-mail simulata
* `smishing.simulation.replied` — ha risposto a un messaggio di testo simulato
* `vishing.simulation.succeeded` — ha assecondato un chiamante vocale simulato
* `training.assigned` — ha ricevuto l'assegnazione di una formazione sulla sicurezza
* `training.completed` — ha completato la formazione sulla sicurezza
* `training.past.due` — ha superato la scadenza di una formazione

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

<Note>
  **Adaptive simula su tre canali e Living Security valuta ciascun canale separatamente.**
  I risultati delle e-mail vengono valutati come phishing, quelli dei messaggi di testo come smishing e quelli delle chiamate vocali come vishing. Una persona che clicca su un'e-mail simulata e una che risponde a un messaggio di testo simulato non vengono misurate come se avessero avuto lo stesso comportamento, perché il giudizio espresso in ciascun caso è diverso.
</Note>

## Che cosa richiede Living Security

| Credenziale | Descrizione |
| - | - |
| **Token API** | Un token API di Adaptive Security. Living Security lo invia come bearer token a ogni richiesta. |

**Ruolo richiesto:** un amministratore dell'account Adaptive Security con accesso a
**Settings → API**. Adaptive regola l'accesso alle API tramite autorizzazioni basate sui ruoli, pertanto il token deve appartenere a un ruolo in grado di leggere utenti, phishing e formazione.

**Accesso:** sola lettura. Living Security si limita a leggere da Adaptive Security e non crea, modifica né elimina mai nulla nell'account.

### Che cosa recupera Living Security

| Dati | Dettaglio |
| - | - |
| **Persone** | La directory utenti di Adaptive: nome, e-mail, reparto, qualifica, nome ed e-mail del responsabile, sede, divisione, stato occupazionale e data di inizio. |
| **Simulazioni e-mail** | Per persona e per simulazione: quando il messaggio è stato recapitato, aperto, cliccato, ha ricevuto una risposta, ha avuto l'allegato aperto, il codice QR scansionato, le credenziali inserite oppure è stato segnalato. |
| **Simulazioni di messaggi di testo** | Per persona e per simulazione: recapitato, aperto, cliccato, con risposta, con credenziali inserite o segnalato. |
| **Simulazioni vocali** | Per persona e per simulazione: l'esca recapitata, il numero chiamato, se la persona ha assecondato il chiamante e se lo ha segnalato. |
| **Formazione** | Per persona e per campagna: quando è stata iscritta, la scadenza, quando ha iniziato, quando ha completato la formazione e se ha confermato di aver preso visione della policy della campagna. |

<Note>
  **I numeri di telefono non vengono archiviati.** Adaptive restituisce i numeri dell'ufficio e del cellulare nel record utente. Living Security li elimina entrambi prima di archiviare qualsiasi dato, perché nessuna funzionalità di Living Security li utilizza.
</Note>

<Note>
  **Il punteggio di rischio di Adaptive viene registrato ma mai utilizzato nel calcolo.** Adaptive calcola un
  `current_risk_score` per ogni persona. Living Security lo conserva per consentire un confronto diretto tra i due sistemi, ma l'Indice di rischio umano viene sempre calcolato a partire dal comportamento osservato, usando il modello pubblicato di Living Security, e mai a partire dal punteggio composito di un altro fornitore.
</Note>

### Prerequisiti

* Un account Adaptive Security con API abilitata.
* Accesso come amministratore a [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
* Indirizzi e-mail degli utenti in Adaptive corrispondenti a quelli utilizzati dagli altri sistemi collegati. L'e-mail è il criterio con cui Living Security associa un utente di Adaptive a una persona.

***

## Parte A — In Adaptive Security

*Questi passaggi vengono eseguiti dall'amministratore di Adaptive Security.*

<Steps>
  <Step title="Aprire le impostazioni API">
    1. Accedere a [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) come amministratore.
    2. Andare a **Settings → API**.
  </Step>

  <Step title="Generare il token API">
    1. Generare un nuovo token API.
    2. Assegnargli un nome facilmente riconoscibile in futuro, ad esempio `Living Security`.
    3. Verificare che il ruolo del token possa leggere utenti, campagne di phishing e campagne di formazione.
    4. Copiare il token.

    <Warning>
      Copiare il token prima di lasciare la pagina. Se l'account Adaptive imposta una scadenza per il token, annotarne la data: dopo la scadenza Living Security non potrà più recuperare i dati e la connessione dovrà essere aggiornata con un nuovo token.
    </Warning>
  </Step>
</Steps>

***

## Parte B — In Living Security Platform

*Questo passaggio viene eseguito dal responsabile del programma oppure dall'amministratore di sistema, se si utilizza la configurazione delegata.*

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | Campo | Valore |
    | - | - |
    | **Token API** | Il token generato nella Parte A |
  </ConnectInPlatform>
</Steps>

La connessione ad Adaptive Security è ora attiva.

***

## Frequenza di recupero dei dati

| Dati | Pianificazione |
| - | - |
| Persone | Ogni 6 ore |
| Risultati delle simulazioni (e-mail, messaggi di testo, voce) | Ogni 6 ore |
| Risultati della formazione | Ogni 6 ore |

L'API di reporting di Adaptive non offre un filtro «che cosa è cambiato da», pertanto Living Security legge ogni simulazione e ogni campagna di formazione finché produce ancora risultati e smette di leggerla quando è chiusa da due settimane. In questo modo i clic e le segnalazioni tardivi vengono comunque acquisiti e le campagne concluse non vengono riletti indefinitamente.

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

***

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Il token API è errato, scaduto o è stato revocato. Adaptive restituisce un corpo di risposta vuoto in caso di questo errore, quindi non sono disponibili ulteriori dettagli. Generare un nuovo token in
    **Settings → API** e ripetere la connessione con tale token. Un token copiato solo in parte produce lo stesso errore ed è la causa più frequente.
  </Accordion>

  <Accordion title="403 Forbidden">
    Il token è stato autenticato, ma il suo ruolo non può leggere i dati richiesti. Incollare di nuovo lo stesso token non risolverà il problema. In Adaptive, verificare che il ruolo del token disponga dell'accesso in lettura a utenti, phishing e formazione, oppure emettere un token da un ruolo che lo abbia.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive ha applicato un limite di frequenza alla connessione. Living Security interrompe l'esecuzione e riprende dallo stesso punto all'esecuzione pianificata successiva, quindi nessun dato va perso: i conteggi richiedono semplicemente più tempo per aumentare. Se il problema persiste per più giorni, contattare l'assistenza di Adaptive Security per informarsi sul limite di frequenza applicato al proprio account.
  </Accordion>

  <Accordion title="Le persone compaiono, ma non i risultati delle simulazioni">
    Verificare che le campagne previste siano effettivamente state eseguite. Adaptive riporta le iscrizioni solo per le simulazioni che sono state inviate, quindi una campagna ancora nello stato **Bozza** o **Programmato** non apporta alcun dato finché non viene inviata. Living Security non legge intenzionalmente tali campagne, in modo da impiegare il proprio budget di richieste su quelle che hanno risultati effettivi.
  </Accordion>

  <Accordion title="Mancano le simulazioni vocali o di messaggi di testo">
    Living Security determina il canale di ciascun risultato in base allo scenario associato. Se uno scenario è stato eliminato in Adaptive dopo l'esecuzione della relativa simulazione, i suoi risultati vengono registrati sul canale e-mail, perché il canale non è più leggibile. Per evitarlo, conservare in Adaptive gli scenari dismessi anziché eliminarli.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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