Sostituire la chiave segreta di firma di un webhook

La sostituzione della chiave segreta del webhook è immediata. dosya non sovrappone le chiavi vecchia e nuova: il valore precedente smette di verificare le firme appena Sostituisci la chiave segreta di firma riesce e il nuovo viene mostrato una sola volta.

Passaggi

1. Prepara l’accesso all’archivio dei segreti del ricevitore e al percorso di distribuzione prima di modificare dosya. Metti in pausa altre modifiche al ricevitore e scegli un momento di poco traffico, perché il nuovo valore non può essere conosciuto in anticipo.
2. Apri Integrazioni → Webhook, individua l’URL della destinazione webhook e scegli Sostituisci la chiave segreta di firma. Verifica che il tuo ruolo nello spazio di lavoro includa manage_settings; una credenziale API richiede Accesso completo.
3. In Sostituisci la chiave segreta di firma, leggi The old secret stops working immediately - update your receiver before rolling. Scegli Sostituisci la chiave segreta di firma solo quando puoi effettuare subito il passaggio.
4. In Chiave segreta di firma, copia il nuovo valore whsec_… e conservalo in sicurezza. dosya mostra Store it securely - you won't see it again. e non consente di recuperarlo dopo la chiusura della finestra.
5. Aggiorna e distribuisci il ricevitore, poi rimuovi il vecchio valore dalla sua configurazione. I tentativi in attesa leggono la chiave attuale della destinazione al tentativo successivo, quindi arriveranno anch’essi firmati con il nuovo valore.
6. Scegli Invia un evento di prova, apri Invii e verifica Completato e una nuova firma valida sul ricevitore. Esamina le richieste arrivate durante il breve intervallo di sostituzione prima di riprendere le normali operazioni.

La sostituzione della chiave è limitata a dieci richieste per utente all’ora. Il registro di controllo e la notifica dell’integrazione identificano destinazione e autore, ma non memorizzano mai le chiavi segrete.

Risultato previsto

Il ricevitore accetta gli invii firmati con il nuovo valore mostrato una volta e rifiuta la vecchia chiave. Nuove prove e tentativi successivi usano la chiave attuale, senza un periodo di doppia chiave non supportato.

Impossibile sostituire la chiave segreta di firma indica che non è stato confermato un nuovo valore. Mantieni la configurazione del ricevitore, ricarica la destinazione e riprova dopo aver verificato il limite di frequenza.

La finestra si è chiusa prima della copia. Il valore non è recuperabile. Sostituisci di nuovo la chiave, copia quella appena emessa e aggiorna subito il ricevitore; la chiave intermedia è già obsoleta.

Guide correlate

• Creare un webhook
• Esaminare gli invii