Creazione e testing di un template custom – LibraCyber - Centro Assistenza

Creare un template

Per creare un template, è possibile accedere alla piattaforma e selezionare dal menù di sinistra "Materiale Formativo Template".

La creazione di un template è una funzionalità disponibile a utenze con ruolo di company admin o superiori (MSP).

Un utente con ruolo MSP ha accesso sia ai template globali sia a quelli specifici delle company.
Al contrario, un utente con ruolo Company Admin può accedere e visualizzare esclusivamente i template associati alla propria company.

A questo punto è possibile cliccare sul bottone "Nuovo template" ed inserire tutte le informazioni che vengono richieste

Descrizione dei campi da inserire

Campo	Descrizione
Nome del Template	Il nome con cui il template verrà memorizzato sulla piattaforma
Company	La company in cui verrà utilizzato il template oppure "globale" se il template verrà utilizzato da tutte le aziende
Landing Page	La pagina HTML restituita al target quando clicca il link contenuto nell'email. La pagina di atterraggio può essere quella predefinita o personalizzata ad hoc per il cliente finale. Si può inoltre inserire l'URL della landing page (se non specificata, il sistema indirizzerà l'utente su quella impostata come default)
Tipo	Il tipo di template, se Email, SMS, Codice QR o USB
Lingua	La lingua in cui è scritto il testo contenuto nell'email da inviare al target
Difficoltà stimata	Un numero tra 0 e 1 che indica il livello di difficoltà nel riconoscere l'email di phishing. L'intervallo va da 0 (più facile) a 1 (più difficile)
Tag	Per categorizzare meglio il template (esempio: Marchio Reale)
Paesi	I paesi dei target in cui può essere utilizzato il template. Il campo consente valori multipli, abilitando l'uso del template in più paesi. Il valore predefinito è "Tutti i paesi"
Forzato	Selezionato se si desidera forzare l'uso del template in una campagna di phishing
Allegato	Selezionato se si desidera includere uno o più allegati (vedi articolo dedicato)

Contenuto di un template - Anteprima

Una volta che il template è stato creato con successo, si atterra sulla sezione "Anteprima" dove è possibile inserire il contenuto del template.

Il contenuto dovrà essere inserito tradotto nella varie lingue inserite come disponibili per il template stesso.

Nella riga "Oggetto" è possibile inserire l'oggetto della mail che verrà visionata dall'utente target del template.

Nella riga "Mittente" è invece necessario inserire il nome mittente e l'indirizzo mittente da cui si vuole far partire l'email rispettando il seguente formato --> Nome Mittente < xx@dominiomittente>

NOTA: Il dominio mittente utilizzato deve essere scelto tra quelli autorizzati all'invio da Cyber Guru (disponibili in piattaforma alla sezione "Aiuto > Support - Knowledge > Clicca qui per scaricare le informazioni aggiuntive sul whitelisting"

Cliccando su "Contenuto" è invece possibile inserire il contenuto del template che sarà il body della email che l'utente riceverà. Si può utilizzare qualsiasi editor html per generare il contenuto del template che andrà poi copiato e caricato in piattaforma.

Il template deve contenere la struttura minima corretta di una pagina HTML:

<!DOCTYPE html>
<html lang="it">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Titolo della Pagina</title>
</head>
<body>

  <h1>Ciao!</h1>
  <p>Questo è il mio primo file HTML.</p>

</body>
</html>

La funzionalità di Anteprima permette di visualizzare un'anteprima dell'HTML inserito. Tuttavia, si raccomanda di non affidarsi esclusivamente all'anteprima: è sempre consigliabile inviare un test del template a se stessi per verificare la corretta visualizzazione dell'email nel client di posta, prima di procedere con la campagna."

Inserire i Placeholder

Affinchè il template funzioni correttamente è importate inserire i placeholder. Questi segnaposto verranno sostituiti al momento dell'esecuzione.

Tutti i placeholder si possono selezionare dal relativo menù a tendina. Una volta selezionato l'elemento di proprio interesse, cliccando su "copia" si otterrà il placeholder da inserire nel template.

Quello che segue è l'elenco completo dei segnaposto che possono essere utilizzati nel testo del template

SURNAME {{.LastName}} Cognome del target
NAME ⁠{{.FirstName}} Nome del target
EMAIL ⁠{{.Email}} Indirizzo email del target
TRACKER {{.Tracker}} Il tracker è una immagine invisibile usata per tracciare l'evento di apertura dell'email da parte del destinatario .Il tracker deve essere inserito obbligatoriamente prima del tag di chiusura </body> e del tag di chiusura </html>.
```
 </body>
 {{.Tracker}}
</html>
```
Nel caso in cui l'immagine non venga automaticamente scaricata, l'evento di apertura NON viene registrato (l'evento di click o segnalazione NON è impattato).
TRACKING URL {{.TrackingURL}} L'URL del gestore di tracciamento
SENDER ⁠{{.From}} Il mittente spoofato
TELEPHONE NUMBER {{.Position}} Numero telefono target
INTERNAL RID {{.RId}} ID univoco del target
⁠BASE URL {{.BaseURL}} L'URL di base con il percorso e il parametro rid spogliati. Utile per creare collegamenti a file statici.
PHISHING URL {{.URL}} URL di phishing. Per reindirizzare l'utente a una landing page è necessario inserire un tag <a> con attributo href valorizzato con il placeholder {{.URL}}.

Esempio
```
<a href="{{.URL}}" style="text-decoration:none; color:#0a6ebd; font-weight:bold">
      Ulteriori informazioni sui corsi
     </a>
```
Se non è stata configurata alcuna pagina di destinazione, verrà utilizzata quella predefinita. Il placeholder {{.URL}} verrà sostituito automaticamente dalla piattaforma con il dominio di landing page configurato per il template ( o se non specificato con uno di default).

I domini di landing page sono disponibili all'interno della piattaforma nella sezione "Aiuto > Support - Knowledge > Clicca qui per scaricare le informazioni aggiuntive sul whitelisting"
⁠COMPANY LOGO {{.CompanyLogoAsDataURL}} Logo dell'azienda
DATE {{.CurrentDate+0}} La data corrente
IMAGE {{.Img= L'immagine presente nel template html. Per l'inserimento delle immagini leggi la sezione dedicata in questo articolo.

Di seguito un esempio di HTML

Caricare una immagine nel template

Nel caso in cui si voglia inserire una immagine nel template è necessario cliccare su "Contenuto". A questo punto si hanno due opzioni

Scegli immagine: permette di selezionare un'immagine globale, condivisa tra tutti i template.
Scegli immagine aziendale (consigliata): permette di selezionare o caricare un'immagine specifica per la realtà in questione, utilizzabile esclusivamente dalla propria realtà e non condivisa con altri.

Dopo aver caricato o selezionato l'immagine, nella medesima schermata è disponibile il pulsante Copia per copiare il placeholder {{.Img}} da incollare direttamente nel valore dell'attributo src del tag <img> nel template HTML.

La sintassi corretta è: <img src="{{.Img=name.png}}">

Il placeholder dell'immagine risulterà come {{.Img=nomedelfileimmagine.png/jpg}}

Ogni volta che si apporta una modifica, è importante ricordarsi di cliccare sul pulsante Salva in basso a destra per non perdere le modifiche effettuate.

Informazioni globali

La sezione "Informazioni globali" del template contiene vari elementi che permettono di configurare e personalizzare i dettagli generali del template. Vediamo in dettaglio ogni voce:

Nome del template: per identificare il template all'interno del sistema.
Landing page: questo menù permette di indicare la pagina su cui atterrerà l'utente dopo aver cliccato sul link della simulazione nello SPECIFICO TEMPLATE. Ad esempio, la landing page doppia Microsoft simula una pagina di accesso Microsoft in cui l'utente è invitato a inserire le proprie credenziali. In questo caso, il dato di submitted viene registrato, consentendo di tracciare non solo il clic sul link, ma anche l'effettiva immissione delle informazioni. Se non si specifica nulla, il sistema proporrà quella di default.
Landing Page URL : URL corrisponde all'indirizzo web della landing page, che verrà utilizzato nelle comunicazioni generate con il template. Utilizzare esclusivamente domini di landing page autorizzati Cyber Guru (visionabili in piattaforma nella sezione "Aiuto > Support - Knowledge > Clicca qui per scaricare le informazioni aggiuntive sul whitelisting"
Tags associati: I tag sono parole chiave che aiutano a classificare e filtrare i template.
Livello di difficoltà stimato: Indica quanto complesso è l'uso del template (Non necessario valorizzarlo)
Tipo: questo campo permette di definire la tipologia del template. Attenzione: una volta selezionato, il tipo non può essere modificato. È quindi importante sceglierlo con cura prima di procedere
Allegati: è possibile decidere se includere degli allegati al template (per l'inserimento di allegati contattare il proprio CSM di riferimento).
Attivazione del template: Se un template non è attivo, non verrà selezionato per le campagne.
Forzatura del template: Consente di forzare l'inserimento del template nella prossima campagna proposta dal sistema. Se alcuni dei template proposti automaticamente dal sistema per una campagna non risultano adatti, è possibile intervenire manualmente in due modi:

Forzare i propri template tramite l'apposito toggle "Forzato", così da includerli nella campagna.
Ricreare la campagna disattivando i template che si desidera sostituire, in modo da escluderli dalla selezione automatica (nella sezione "Gestione Campagna").

Ogni volta che si apporta una modifica, è importante ricordarsi di cliccare sul pulsante Salva in basso a destra per non perdere le modifiche effettuate.

Lingue di un template

La sezione "lingue" di un template offre le seguenti funzionalità:

Visualizzazione delle lingue disponibili: È possibile vedere un elenco delle lingue in cui il template è attualmente disponibile. Questo permette di monitorare per quali lingue è stata predisposta una versione del template.
Cancellazione di una lingua: Se una determinata lingua non è più necessaria, è possibile eliminarla dall'elenco. Il template non sarà più disponibile per la lingua eliminata.
Aggiunta di nuove lingue: È possibile aggiungere ulteriori lingue in cui il template sarà reso disponibile. Dopo aver aggiunto una lingua, sarà necessario tradurre il contenuto del template, l'oggetto, il mittente e gli INDIZI.
Modifica della disponibilità per paesi: è possibile definire o modificare i paesi nei quali il template sarà disponibile. Bisogna tenere presente che non tutti i template sono adatti ad essere resi disponibili globalmente per tutti i paesi. Alcuni template fanno riferimento a contenuti molto specifici che potrebbero non essere pertinenti o riconoscibili in determinate realtà locali, rendendo quindi poco efficace la simulazione. In questi casi è consigliabile limitarne la visibilità ai soli paesi per cui risultano applicabili.

Al contrario, esistono template con contenuti universali, validi per qualsiasi realtà aziendale e geografica. Questo tipo di template si presta ad essere reso disponibile globalmente senza alcuna limitazione.

Aggiunta Indizi ad un template

È fondamentale inserire indizi specifici per ogni template di phishing affinché questi forniscano suggerimenti chiave che aiutano l'utente a riconoscere i segnali di un potenziale attacco. Gli indizi devono essere personalizzati per ogni scenario di phishing, in modo che riflettano le caratteristiche uniche del messaggio che l'utente ha ricevuto.

Se non viene selezionata nessuna landing page personalizzata, vengono utilizzati automaticamente tre hint di default, validi in modo generale per qualsiasi tipo di attacco di phishing.

Per inserire un indizio, all'interno del template desiderato si deve cliccare nella sezione "Indizi". Fare click su "Nuovo indizio" ed inserire

Classe: identifica la tipologia dell'indizio, specificando a quale tematica fa riferimento.
Icona: immagine da associare all'indizio
Priorità: numero progressivo che determina l'ordine di presentazione degli hint nella landing page. È possibile inserire fino a un massimo di 5 hint, utilizzando come valori di priorità le decine: 10, 20, 30, 40 e 50.
I Tags permettono di creare hint con contenuto dinamico, personalizzato in base ai dati della simulazione. Ad esempio, è possibile utilizzare tag come il mittente dell'email o altri elementi specifici della campagna, rendendo l'avvertimento più contestuale ed efficace per l'utente.
Contenuto dell'indizio: il contenuto dell'indizio visionabile sulla landing page. Esempio "Mittente sospetto: Controlla sempre l'indirizzo email del mittente. Un dominio insolito o leggermente diverso da quello ufficiale è un chiaro segnale di phishing"

Azioni

Nella sezione Azioni di un template sono disponibili le seguenti opzioni di esportazione:

Esporta in XML: permette di esportare l'intero contenuto del template in formato XML.
Esporta in HTML: disponibile nel caso in cui il template sia presente in più lingue, consente di esportare il contenuto in formato HTML specificando la lingua desiderata per l'esportazione.
Testare il tempate

Testare un template

Lo scopo delle funzionalità test template è quello di permettere alla piattaforma di verificare che nel template non siano contenuti errori che ne impediscano il suo utilizzo nelle campagne.

Per testare un template è possibile selezionare "Materiale Formativo Template" e selezionare il template che si vuole testare.

Una volta scelto il template, nella sezione "Azioni" si hanno a disposizione due possibili opzioni

Il "Test Template singola lingua" ad esempio "Test Template (IT)" verifica la correttezza della sola lingua selezionata ed invia il template stesso all'indirizzo inserito.
Il "Test Template" verifica la correttezza di TUTTE le lingue e invia il template nella sola lingua selezionata all'indirizzo inserito. Pertanto è consigliabile usare sempre il "Test Template" generico e non quello in singola lingua.

Si può inserire un qualsiasi indirizzo email ( non è necessario che si tratti di una utenza censita in piattaforma) per effettuare un test.

NOTA: Nel caso venga eseguito un test di template e vengano riscontrati errori nelle lingue, verrà visualizzato un banner rosso che segnala la presenza degli errori nel template. Il banner indicherà specificamente quali lingue presentano le problematiche, in modo da facilitare la correzione tempestiva e mirata.

L’elenco dei template includerà ora una nuova colonna con un’unica icona che mostra lo stato del test:

✅ Segno di spunta verde per i template che sono stati testati con successo (test di tutte le lingue)e non sono mai stati modificati dopo il test.
⚠️ Avviso giallo per i template che sono stati modificati o importati e non sono mai stati testati dopo la modifica.
❌ Alert rosso per i template il cui test, per tutte le lingue, non è andato a buon fine.

Una volta completati tutti i test con esito positivo, è possibile procedere all'attivazione del template. Da quel momento, il template sarà disponibile nel sistema.

Nota: la funzionalità di "Test campagna" presente nella sezione "Gestione rilasci" quando si seleziona una campagna, invece ha lo scopo di inviare, nella sola lingua selezionata, tutti i template inclusi in una campagna. Pertanto il test campagna non è un mezzo efficace per verificare la correttezza dei template in quanto una campagna potrebbe superare con successo il test in una lingua ma poi fallire l'attivazione se i template contengono errori in altre lingue.

Data di creazione di un Template

All'interno della sezione "Materiale Formativo", nella categoria "Template" è possibile accedere ai template di simulazione. Inoltre, per facilitare la ricerca delle novità, è stata aggiunta una colonna denominata "Data di creazione" nella tabella dei template di phishing. Questa colonna consente di identificare rapidamente i template più recenti e tenere sempre aggiornate le proprie simulazioni.