La Setup Checklist è una guida passo passo per configurare e distribuire il chatbot di Cyber Awareness (Alex) all'interno di un'azienda. La checklist è composta da 4 passi per Slack, Google Chat e Webchat e da 5 passi per Microsoft Teams, che aggiunge un passo dedicato alle policy:
- Messaging platform — la piattaforma di messaggistica
- Teams Policies — solo per Microsoft Teams
- Deploy Alex
- Assign your first course — assegna la prima lezione
- Activate automatic course delivery — attiva la distribuzione automatica
In genere questi passi rimandano l'amministratore ad altre sezioni dell'app, dove completare azioni specifiche. Una volta completata l'azione, lo stato del passo corrispondente si aggiorna, in modo dinamico oppure in base alla conferma dell'amministratore.
La Setup Checklist in Cyber Awareness › Setup: ogni passo rimanda alla sezione dell'app in cui completare l'azione (esempio con canale Webchat, 4 passi).
Messaging platform
Questo passo permette all'amministratore di definire il canale che l'intera azienda userà per i propri utenti finali. La Webchat resta sempre utilizzabile in aggiunta al canale selezionato.
Alex non è limitato a un solo canale. Le piattaforme disponibili sono:
- Microsoft Teams
- Slack
- Google Chat
- Webchat — il canale integrato nell'app LibraCyber, pensato soprattutto per gli utenti che non dispongono di un account Teams o Slack, o quando l'ambiente è on-premise e il provisioning avviene tramite file CSV
La scelta dipende dal contesto e dalle esigenze del cliente.
ATTENZIONE: dopo la conferma, la piattaforma di messaggistica non è modificabile dall'amministratore in autonomia. La scelta viene fissata in fase di configurazione; per cambiarla è necessario contattare il Supporto LibraCyber. Scegli quindi con attenzione il canale prima di confermare.
Teams Policies
Questo passo compare solo per la configurazione Teams. Serve ad assicurare che le impostazioni lato Microsoft siano configurate correttamente perché la distribuzione del chatbot funzioni; il passo rimanda alla documentazione pubblica per la risoluzione dei problemi.
La conferma dell'amministratore è dichiarativa: spuntando la casella si registra soltanto la propria conferma, ma l'applicazione non è in grado di verificare che le impostazioni Microsoft siano effettivamente corrette.
Deploy Alex
Questo passo apre la sezione Chatbot Configuration, dove vengono concessi a LibraCyber i permessi API. Il passo si completa una volta che i permessi sono stati effettivamente concessi. Ciò che la sezione Chatbot Configuration mostra dipende dal canale scelto al passo Messaging platform. Qui l'amministratore concede i permessi specifici lato Microsoft, Google o Slack necessari ad abilitare il chatbot.
Distribuire Alex significa renderlo visibile come app della piattaforma di messaggistica agli utenti previsti. Non significa che Alex inizierà subito a contattare gli utenti.
Teams – Grant API Permissions | Deployment Type
Il pulsante Grant Consent (Teams) porta l'amministratore alla console di amministrazione Microsoft e richiede l'approvazione dei permessi. La sezione Deployment Type consente di scegliere il pubblico a cui distribuire il bot in Microsoft Teams — tutta l'azienda (company), per reparto (departments) o per singoli utenti (users). Nella sezione è presente anche un link alla documentazione di risoluzione dei problemi per i casi in cui Alex non risulti distribuito ad alcuni utenti (versione Microsoft store / app di terze parti).
NOTA: il link Grant Consent di Microsoft è monouso — ogni tentativo consuma un token valido una sola volta. Se il consenso non va a buon fine o il link risulta scaduto, ricarica la scheda Chatbot Configuration per generare un nuovo link e riprova. Non è necessario aprire un ticket di supporto.
Google Chat Configuration
Il pulsante Add to Google Chat rimanda alla documentazione pubblica di configurazione per Google Chat.
Slack Configuration
Il pulsante Add to Slack apre direttamente la pagina di consenso di Slack per la concessione dei permessi.
Assign your first course
Questo passo rimanda l'amministratore al catalogo delle lezioni (Cyber Awareness › Lessons). Il passo si completa quando è stata assegnata almeno una lezione.
L'assegnazione di una lezione non ha alcun effetto sull'utente finché non è attiva la distribuzione automatica: Alex non contatterà automaticamente gli utenti finché la distribuzione automatica non viene abilitata (operazione da svolgere come ultima attività, dopo aver definito ordine, frequenza e destinatari). I dettagli su assegnazione e ordinamento delle lezioni sono descritti nella pagina Lessons.
NOTA (primo valore): non è necessario attendere la distribuzione automatica del passo successivo per vedere Alex all'opera. Dopo aver scelto la piattaforma e distribuito il bot (passi 1–3) e assegnato almeno una lezione, puoi inviarne subito una con Send now (nel Lesson editor) e verificare che raggiunga un utente reale.
Activate automatic course delivery
Il pulsante Activate auto delivery rimanda alla scheda Preferences (Awareness Setup). Il passo si completa una volta abilitata la distribuzione automatica delle lezioni. Cadenza, giorni tra una lezione e l'altra e le altre opzioni di erogazione sono descritti nella funzione Preferences.