Documentazione
Webhook
I webhook permettono ad Atheneo Pro di notificare altri sistemi dello studio quando si verifica un evento, senza dover interrogare continuamente le API. Le notifiche restano nell’ambito della rete locale.
Come funzionano
- Registri un endpoint di destinazione raggiungibile in LAN.
- Indichi a quali eventi vuoi essere notificato (ad esempio accessi falliti, cambi di permesso, aggiornamenti software).
- Al verificarsi dell’evento, il server invia una richiesta HTTP con il payload dell’evento.
- Il tuo sistema risponde per confermare la ricezione.
Firma del payload (HMAC)
Ogni consegna è accompagnata da una firma HMAC SHA-256 calcolata con un segreto condiviso. Il destinatario può verificarla per accettare solo notifiche realmente provenienti dal server Atheneo Pro, scartando richieste contraffatte.
Affidabilità
- Gestisci le consegne in modo idempotente (lo stesso evento potrebbe arrivare più volte).
- Rispondi rapidamente e svolgi l’elaborazione pesante in modo asincrono.
- Il server prevede una logica di ritentativo per gli endpoint temporaneamente non disponibili.
- Ruota periodicamente il segreto di firma dei webhook.
L’elenco completo degli eventi, gli schemi dei payload e i dettagli sulla verifica della firma vengono forniti allo studio in fase di setup, allineati alla versione installata.