Che cos’è un webhook e come funziona?

Per gli MSP e i team IT, mantenere alta l’attenzione è fondamentale per conservare sistemi ed endpoint in buone condizioni, e uno dei modi per restare all’erta sono le notifiche e la comunicazione tra applicazioni. La difficoltà, però, sta nell’agire immediatamente sulle informazioni in tempo reale, nel momento stesso in cui gli utenti le ricevono. I metodi tradizionali richiedono che siano gli utenti stessi a visitare un sito o aprire un’app per ottenere aggiornamenti, ma questo non garantisce una risposta immediata.

Grazie ai webhook, invece, gli utenti possono ricevere gli aggiornamenti sugli eventi in modo rapido e automatico, quando serve: un elemento ormai indispensabile nei flussi di lavoro di monitoraggio di un ambiente IT.

In questo articolo ti offriamo una breve panoramica sui webhook: cosa sono, come funzionano e i modi migliori per sfruttarli in ambito IT.

Cosa sono i webhook

Un webhook è un tipo di callback che sfrutta l’automazione per consentire a un’applicazione di inviare informazioni in tempo reale a un’altra applicazione nel momento esatto in cui si verifica un evento.

In parole semplici, invece di aprire e aggiornare continuamente un’app per cercare novità, puoi programmare e configurare l’app affinché informi gli utenti del completamento o del verificarsi di un evento.

Che cos’è un callback?

Un callback è un meccanismo con cui un sistema, come un’app o un server, notifica o comunica con un altro durante un evento.

Esistono diversi tipi di callback, e i webhook sono uno di questi. Ogni tipo si distingue in base a tre caratteristiche: chi avvia la comunicazione, la velocità con cui gli aggiornamenti vengono inviati e ricevuti e la direzione della comunicazione.

Oltre ai webhook, altri tipi di callback includono:

• Polling: l’utente richiede ripetutamente aggiornamenti all’app o al server a intervalli programmati
• Server-Sent Events (SSE): l’utente apre una connessione affinché il server trasmetta aggiornamenti in modo continuo.
• WebSocket: viene creato un canale di comunicazione bidirezionale tra l’utente e il server.
• Publish/Subscribe (Pub/Sub): un publisher o produttore invia messaggi al proprio subscriber o consumatore.

Come funzionano i webhook?

I webhook seguono un processo articolato in questa sequenza:

• Registrazione e configurazione: innanzitutto, perché un’applicazione possa inviare dati in tempo reale, gli utenti devono inserire nell’app un URL di callback che indichi la destinazione dei dati e specificare l’evento che attiverà il webhook. Questo può avvenire tramite l’interfaccia utente (Interfaccia Utente) di un’app o di una pagina oppure configurandone l’Application Programming Interface (API).
• Attivazione dell’evento: quando si verifica un evento, l’app inizia a costruire un payload webhook, ovvero una richiesta HTTP POST che contiene i dati dell’evento. Una volta creato, questo payload viene inviato all’app di destinazione indicata dall’URL registrato.
• Elaborazione e risposta: una volta ricevuto il payload, l’app elabora i dati e conferma la ricezione tramite un codice di stato HTTP.

Webhook e polling API: differenze e vantaggi

Per comprendere meglio i vantaggi dei webhook, è utile conoscere un altro metodo molto diffuso per ottenere aggiornamenti: il polling delle API.

Il polling delle API funziona facendo in modo che un’app o un server richiami ripetutamente l’API dell’applicazione di origine a intervalli programmati per verificare la presenza di aggiornamenti. E qui sta il problema: nella maggior parte dei casi la richiesta produce una risposta vuota, e il polling continuo si traduce solo in uno spreco di banda ed energia.

È qui che i webhook offrono in genere un vantaggio rispetto al tradizionale polling delle API. Configurando l’API di un’app perché invii dati in tempo reale al verificarsi di un evento, si elimina la ridondanza e il consumo di risorse legati al dover interrogare costantemente l’app per informazioni che potrebbero non arrivare mai.

Casi d’uso comuni dei webhook in ambito IT

L’affidabilità di un professionista IT dipende in gran parte dalla velocità e dall’efficienza con cui risponde ai problemi e li risolve, e meccanismi automatizzati come i webhook possono agevolare notevolmente una risposta e una risoluzione rapide.

Ecco i casi d’uso più comuni dei webhook per tecnici e amministratori IT.

• Creazione dei ticket: i webhook possono essere configurati negli RMM per creare e inviare automaticamente i ticket quando viene generato un avviso di sicurezza.
• Avvisi di monitoraggio e sicurezza: con i webhook, le notifiche di avviso possono essere inviate automaticamente quando vengono rilevati problemi di sicurezza, riducendo la necessità di una sorveglianza manuale soggetta a errori.
• Remediation automatizzata: insieme agli avvisi e alla creazione dei ticket, l’integrazione dei webhook consente di avviare immediatamente flussi di lavoro per risolvere i problemi.
• Onboarding e offboarding: quando un dipendente entra o lascia un ambiente enterprise, un webhook può automatizzare il processo di onboarding o offboarding.
• Sincronizzazione dei sistemi: in un sistema enterprise ampio e complesso, i webhook possono contribuire a sincronizzare dati e processi tra più applicazioni e strumenti.

Nella gestione e nel monitoraggio degli ecosistemi IT dei clienti, le capacità di automazione dei webhook possono rivelarsi una risorsa preziosa per i team IT e gli MSP.

Considerazioni sulla sicurezza dei webhook

Sebbene i webhook possano risultare vantaggiosi sia per gli utenti IT sia per quelli non IT, è bene metterli in sicurezza prima di distribuirli. I webhook comportano uno spostamento di dati e, se non protetti, diventano vulnerabili alle violazioni.

Ecco alcune pratiche di sicurezza da adottare quando si utilizzano i webhook.

• Usa solo HTTPS: quando registri un endpoint o un server per la consegna dei webhook, inserisci sempre l’URL con HTTPS per proteggere la connessione.
• Implementa procedure di verifica: assicurati che il payload del webhook contenga una firma riconoscibile che ne attesti la sicurezza per l’elaborazione.
• Limita l’accesso agli endpoint: restringi determinati webhook a posizioni endpoint specifiche, così che i payload vengano inviati solo alla destinazione prevista.
• Monitora le attività sospette: presta attenzione a volumi di notifiche anomali e a tentativi di convalida falliti.

I webhook restano uno strumento efficace e utile a patto che non diventino vettori per minacce esterne: assicurati quindi di proteggerli prima e durante l’uso.

Come implementare i webhook negli ambienti IT

Qualsiasi distribuzione di uno strumento di automazione va pianificata con attenzione se si vogliono ottenere benefici concreti, e i webhook non fanno eccezione.

Segui questi passaggi per garantire un’implementazione fluida ed efficace dei webhook.

Passaggio 1: individua gli eventi che attiveranno un webhook

Valuta quali flussi di lavoro e processi richiedono i webhook, in particolare quelli che possono trarre vantaggio da risposte automatizzate. Alcuni esempi sono ITSM, PSA e la comunicazione con gli utenti finali.

Passaggio 2: conferma le destinazioni dei webhook

I payload dei webhook devono raggiungere gli endpoint, le applicazioni o i server previsti, a seconda dell’evento. Ad esempio, quando viene generato un avviso di sicurezza, deve arrivare all’endpoint del tecnico IT responsabile.

Passaggio 3: definisci il formato del payload

Ogni payload webhook utilizza formati e sintassi differenti per associarsi a un evento specifico, indicare quali dati includere e applicare altre modifiche. Informati su quali formati di payload corrispondono ai rispettivi eventi.

Passaggio 4: stabilisci le procedure di elaborazione del payload

Quando un payload webhook raggiunge la destinazione, valuta cosa deve accadere dopo la sua apertura. Ad esempio, quando viene attivato un avviso di sicurezza, un webhook invia una notifica a un amministratore, che può avviare un flusso di lavoro automatizzato.

Passaggio 5: testa e documenta

Verifica che i tuoi webhook funzionino come previsto. Ottimizzali e configurali quando necessario. Ogni successo ed errore riscontrato durante l’uso di un webhook va documentato come riferimento per il futuro.

Flussi di lavoro IT più rapidi con i webhook

I webhook sono uno dei meccanismi di callback più utili e versatili. Con un’implementazione corretta e sicura, informano gli utenti in tempo reale quando si verifica un evento specifico, permettendo loro di reagire senza la ridondanza di richieste e controlli a intervalli regolari.

Nell’amministrazione IT, i webhook possono essere sfruttati per automatizzare i flussi di lavoro di gestione e monitoraggio enterprise, riducendo le procedure manuali e aumentando velocità ed efficienza.

Argomenti correlati:

• Come automatizzare l’escalation degli avvisi da Defender ai sistemi PSA
• Metodi per semplificare il lavoro degli MSP con i flussi di lavoro di Power Automate
• Automatizzare le checklist di onboarding dei nuovi clienti con Power Automate
• Come integrare l’RMM con i sistemi PSA e di gestione dei ticket
• Come inviare i webhook di NinjaOne tramite SIEM