Questo articolo descrive come configurare e utilizzare l'Integrazione con Vanta per esportare automaticamente su Vanta i registri di audit di sensibilizzazione generati in SMARTFENSE.
Workshop: Integrazione con altri Prodotti
Obiettivo dell'integrazione
L'Integrazione con Vanta permette di inviare a Vanta i registri di audit di SMARTFENSE relativi alle azioni di sensibilizzazione svolte dagli utenti, facilitando la conformità e la prova della formazione nei quadri normativi.
API di Vanta utilizzata
L'integrazione utilizza l'API di Vanta disponibile su:
https://vanta-connectors.readme.io/docs
Configurazione in SMARTFENSE
Per configurare l'integrazione con Vanta in SMARTFENSE, vai alla sezione Configurazione > Integrazioni > Vanta.
Per completare la configurazione è necessario inserire i seguenti dati:
OAuth client ID
OAuth client secret
Frameworks predefiniti
Resource ID
Questi valori si ottengono seguendo le istruzioni di configurazione corrispondenti.
Registri di audit
Al salvare la configurazione dell'integrazione in SMARTFENSE, viene generato automaticamente un registro di audit associato a questa azione nella sezione Audit > Amministrazione.
Creazione ed editing delle campagne
Nella vista di creazione o modifica di qualsiasi tipo di campagna, espandendo Altre opzioni, viene visualizzato un sottotitolo denominato Integrazione con Vanta.
Da questa sezione è possibile:
Specificare un Framework particolare per la campagna che si sta creando o modificando.
Utilizzare, di default, il Framework configurato in Frameworks predefiniti all'interno della sezione di configurazione dell'integrazione.
Esportazione dei registri
L'integrazione permette l'esportazione automatica dei registri di audit da SMARTFENSE verso Vanta.
L'esportazione viene effettuata una volta al giorno.
I registri esportati sono relativi allo stato di ciascun utente rispetto a ciascuna campagna a cui è stato assegnato.
Le campagne di prova sono escluse da questa esportazione.
API di Vanta impattata
UserSecurityTrainingStatus
Dati inviati a Vanta per utente e campagna
Di seguito sono riportati i campi inviati a Vanta per ciascun utente assegnato a una campagna:
| Campo in Vanta | Type | Campo di SMARTFENSE |
|---|---|---|
| displayName | string | Nome della campagna se esiste; altrimenti, nome del topic/scenario |
| uniqueId | string | Id della statistica della campagna |
| externalUrl | string | URL di assegnazione |
| trainingId | String | URL del dettaglio campagna |
| trainingName | String | Nome del topic/scenario della campagna |
| frameworksFulfilled | List[Enum["SOC2","ISO27001","HIPAA","PCI","GDPR","CCPA"]] | Framework della campagna |
| traineeFullName | String | Nome dell'utente |
| traineeAccountName | String | Nome utente dell'utente |
| traineeEmail | Email dell'utente | |
| status | Enum["INCOMPLETE","COMPLETE"] | Stato dell'utente nella campagna |
| trainingCreatedTimestamp | DateTime | Data di inizio della campagna |
| trainingDueTimestamp | DateTime | Data di scadenza della campagna |
| trainingCompletedTimestamp | Optional[DateTime] | Data dell'interazione che ha generato lo stato COMPLETE |
Stato dell'utente nella campagna
Lo stato inviato a Vanta si determina in base al componente e alla condizione raggiunta:
| Campagna | Condizione | Stato |
|---|---|---|
| Moduli interattivi | Aperto / Iniziato | INCOMPLETE |
| Moduli interattivi | Completato | COMPLETE |
| Video | Aperto / Iniziato | INCOMPLETE |
| Video | Completato | COMPLETE |
| Videogiochi | Aperto / Iniziato | INCOMPLETE |
| Videogiochi | Completato | COMPLETE |
| Sondaggi | Aperto / Iniziato | INCOMPLETE |
| Sondaggi | Completato | COMPLETE |
| Esami | Aperto | INCOMPLETE |
| Esami | Superato / Non superato | COMPLETE |
| Newsletter | Inviato | INCOMPLETE |
| Newsletter | Aperto | COMPLETE |
Registro di audit amministrativo dell'esportazione
Nella sezione Audit > Amministrazione è possibile consultare il risultato di ogni esportazione giornaliera verso Vanta.
La struttura del registro include:
Data
Utente: Sistema
Azione: Esportazione dei registri di audit verso Vanta
Descrizione: E registri esportati
-
Dettaglio extra:
Registri da esportare: X
Registri esportati con successo: Y
Registri con errore: Z
Dettaglio errore: [Dettaglio]
💡 Best practice
Definisci correttamente i Frameworks predefiniti per garantire una classificazione coerente in Vanta.
Controlla quotidianamente i registri in Audit > Amministrazione per validare il risultato delle esportazioni.
Configura framework specifici a livello di campagna quando esistono requisiti normativi differenti.
Evita di includere campagne di prova nelle analisi di conformità.