Aller au contenu principal

Faire tourner le secret

Remplacez le secret si vous pensez qu'il a fuité, s'il est perdu, ou par hygiène. La rotation se fait sans coupure : pendant 24 heures, l'ancien et le nouveau secret sont valides ensemble.

Avant de commencer​

  • Il vous faut la permission webhooks:manage.

Étapes​

  1. Ouvrez Webhooks.
  2. Sur la ligne de l'endpoint, cliquez sur Faire tourner le secret.
  3. Le nouveau Secret de signature s'affiche une seule fois : Copier, puis Terminé.
  4. Installez le nouveau secret dans votre système de réception.

Point de réception en cours de rotation du secret

Pendant les 24 heures​

L'endpoint porte la mention Rotation. Chaque envoi est signé avec les deux secrets : l'en-tête X-SaasCore-Signature contient deux valeurs v1. Un système encore réglé sur l'ancien secret et un système déjà passé au nouveau vérifient tous les deux la signature (voir Vérifier la signature).

Passé ce délai, seul le nouveau secret signe. La rotation figure au journal d'activité.

Voir aussi​