L’User Event API consente di importare da fonti esterne gli eventi o le attività di formazione relativi alla sicurezza dei tuoi utenti e di inserirli nella tua console KSAT. Una volta importati, tutti gli eventi personalizzati saranno visualizzati nella Linea temporale dell’utente interessato e potranno avere un impatto sul suo Punteggio di rischio personale.
Per i dettagli completi relativi alla User Event API e agli esempi di richieste, consulta la nostra documentazione per sviluppatore relativa a User Event API documentazione per sviluppatore relativa a User Event API (il link si aprirà in un’altra finestra). Se decidi di utilizzare la User Event API di KnowBe4, consulta le sezioni seguenti per scoprire come gestire l’utilizzo API e come gli eventi personalizzati possono consolidare la tua formazione sulla consapevolezza della sicurezza.
Console di gestione User Event API
La console di gestione User Event API è la postazione centrale per il monitoraggio, la creazione e la tracciabilità dell’utilizzo di qualsiasi chiave User Event API. Puoi accedere alla console di gestione dalla sezione Integrazioni account nella pagina Impostazioni account della console KSAT. La console di gestione è divisa in tre schede principali: Cronologia delle chiamate, Statistiche e Chiave API. Per maggiori informazioni su ciascuna scheda, fai riferimento alla tabella seguente:
La scheda Cronologia delle chiamate visualizza una tabella con tutte le chiamate API elaborate utilizzando la console KSAT.
| ID di stato | Chiave API | Eventi creati | Errori | Data elaborazione |
|---|---|---|---|---|
| Identificatore univoco generato da ogni chiamata API. | Nome della chiave API utilizzata per eseguire la chiamata API. | Numero di eventi utente creati come risultato della chiamata API. | Tutti gli errori ricevuti durante la chiamata API. | Data e ora di elaborazione della chiamata API. Il formato è: mm/gg/aaaa, h:mm a |
La scheda Statistiche consente di monitorare l’utilizzo API mensile e annuale.
- Quota mensile: grafico a cerchio progressivo che mostra l’utilizzo API mensile. Il grafico mostra la percentuale di chiamate API eseguite in relazione alle chiamate API consentite. Sono consentite 10 chiamate per ogni posto al giorno ogni mese.
- Quota annuale: questo grafico a barre mostra l’utilizzo API annuale. I dati sono dettagliati in base alla quota mensile per ciascun mese per un periodo di tempo di 12 mesi.
La scheda Chiave API consente di creare una o più chiavi API. La chiave API sarà utilizzata per autenticare la tua console KSAT quando viene effettuata una chiamata o richiesta API. Per creare una chiave API, effettua le seguenti operazioni:
- Nel campo Nome, inserisci un nome univoco per la tua chiave API. Se pianifichi la creazione di più chiavi API, ti consigliamo di utilizzare un nome significativo che rifletta correttamente l’utilizzo previsto della chiave.
- Fai clic sul pulsante Crea chiave API. Si aprirà la finestra pop-up Token User Event API.
- Fai clic sul token User Event API per copiare il token. Assicurati di salvare il token API per la creazione di rapporti in una posizione facilmente accessibile, dopo aver chiuso questa finestra, non potrai più visualizzare questo token.
- Fai clic su OK.
Ripeti la procedura descritta in precedenza per creare tutte le chiavi API necessarie. Una volta create, tutte le tue chiavi API saranno elencate in una tabella nella scheda Chiave API.
| Chiave | Nome | Azioni |
|---|---|---|
| Identificatore univoco utilizzato per autenticare una richiesta API associata alla tua console KSAT. | Il nome personalizzato assegnato alla chiave API al momento della creazione. |
È possibile eliminare una chiave API in modo permanente. Per eliminare una chiave, fai clic sull’icona a forma di cestino.
Nota: quando elimini una chiave API, un record relativo all’utilizzo della chiave rimarrà disponibile nella scheda Cronologia delle chiamate. |
Casi d’uso di User Event API
Di seguito sono elencati alcuni esempi di come utilizzare gli eventi personalizzati per consolidare la formazione sulla consapevolezza della sicurezza. Per creare un Gruppo smart con eventi personalizzati, consulta la sezione Criteri relativi agli eventi personalizzati della panoramica sui Gruppi smart.
| Tipo di evento | Esempi di eventi | Caso d’uso |
|---|---|---|
| Sicurezza fisica |
|
Iscrivi gli utenti a una campagna di formazione specifica in base all’evento. Ad esempio, puoi assegnare un modulo di formazione sulla sicurezza fisica da ModStore a tutti gli utenti coinvolti in un evento di sicurezza fisica. |
| Ingegneria sociale |
|
Iscrivi gli utenti a una campagna di phishing personalizzata in base alle informazioni relative ai dipendenti. Ad esempio, puoi inviare un modello e-mail con un coupon per un ristorante locale a tutti gli utenti che compiono gli anni nel mese corrente. |
| Sicurezza di terze parti |
|
Traccia il coinvolgimento di un utente in un incidente di sicurezza di terze parti. Puoi utilizzare queste informazioni per selezionare contenuti di formazione specifici in base all’evento da ModStore per l’iscrizione. |
| Sviluppo professionale | Certificati e formazione da un altro LMS | Traccia la formazione esterna di un utente e i relativi risultati che contribuiscono alla relativa consapevolezza della sicurezza. |