Skip to main content

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

​
Cosa serve a Living Security

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

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

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. Gli stessi quattro indirizzi valgono per tutte le regioni.
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.
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 e verificare che l’elenco Allowed IP Addresses corrisponda.
3

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:Se non si è certi della regione utilizzata dal proprio account, controllare il dominio dell’URL della console KnowBe4 oppure rivolgersi all’amministratore KnowBe4.
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.

​
Parte B — In Living Security Platform

Questo passaggio viene eseguito dal responsabile del programma oppure, in caso di configurazione delegata, dall’amministratore di sistema.
La connessione a KnowBe4 è ora attiva.

​
Risoluzione dei problemi

Il token API non è valido o è scaduto. Verificare che il token sia corretto e che non sia stato rigenerato in Account Settings → API.
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 siano presenti nella allowlist.
È 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.