I webhook consentono alle applicazioni esterne di ricevere notifiche in tempo reale quando si verificano determinati eventi nella piattaforma.
Per utilizzare i webhook, devi attivarli e generare token. L'utilizzo di due secret separati per un singolo URL webhook aggiunge un ulteriore livello di sicurezza. Se un secret viene compromesso o deve essere ruotato per qualsiasi motivo, puoi aggiornare e ruotare i secret senza interrompere il servizio webhook o compromettere la sicurezza dei dati.
Attivare i webhook
Per attivare i webhook:
Nel portale della piattaforma CCAI, fai clic su Impostazioni > Impostazioni sviluppatore. Se non vedi il menu Impostazioni, fai clic su Menu.
Vai al riquadro Webhook, quindi fai clic sul pulsante di attivazione/disattivazione Webhook per attivare i webhook.
In URL, inserisci un URL webhook. Questo URL è l'endpoint che riceve le notifiche in tempo reale. Assicurati che questo webhook possa ricevere richieste HTTP.
Fai clic su Genera. Viene generato il secret principale, ovvero il token di sicurezza principale utilizzato per autenticare e convalidare i payload webhook in entrata. È il mezzo principale per proteggere la comunicazione webhook.
Copia e salva il token in un luogo sicuro.
Genera un secret secondario. Il secret secondario funge da token di sicurezza di backup o di failover. Viene fornito come misura di sicurezza aggiuntiva per migliorare l'affidabilità e la disponibilità delle notifiche webhook. Se per qualsiasi motivo il secret principale viene compromesso o se si verificano problemi con il suo utilizzo, il secret secondario può subentrare e continuare a garantire la comunicazione.
Copia e salva il token in un luogo sicuro.
Fai clic su Salva.
Ruotare i secret
Come best practice per la sicurezza, ruota periodicamente i secret webhook. Questa procedura prevede la generazione di nuove chiavi secret per i webhook principali e secondari e l'aggiornamento nell'applicazione per continuare a ricevere le notifiche senza interruzioni.
Dopo la configurazione iniziale dei webhook, non puoi generare direttamente un nuovo secret principale, ma puoi generare un nuovo secret secondario e ruotare i secret per modificarli.
Per ruotare i secret:
Nel portale della piattaforma CCAI, fai clic su Impostazioni > Impostazioni sviluppatore. Se non vedi il menu Impostazioni, fai clic su Menu.
Fai clic su Ruota secret.
Fai clic su Salva.
Generare nuovi secret
Per ruotare i secret in modo da avere due nuove chiavi secret:
Nel portale della piattaforma CCAI, fai clic su Impostazioni > Impostazioni sviluppatore. Se non vedi il menu Impostazioni, fai clic su Menu.
Fai clic su Genera per generare un nuovo secret secondario.
Fai clic su Ruota secret per impostare il nuovo secret secondario come secret principale.
Fai clic su Genera per generare un secondo nuovo secret secondario che sostituirà il vecchio secret principale.
Fai clic su Salva.