Intégrations

Sprint +18 #25 IV-9 — Rotation manuelle du secret HMAC d'un endpoint.

Sprint +18 #25 IV-9 — Rotation manuelle du secret HMAC d'un endpoint.

Génère un nouveau secret (`token_urlsafe(32)`), conserve l'ancien dans
`secret_previous` pour une **grace period** (le consumer signe encore
valid avec l'ancien jusqu'à la prochaine rotation). La prochaine
rotation programmée est planifiée à +90 jours (audit cyber PM-3).

Permission dédiée `webhooks:rotate_secret` (sub-agent #1 seed) — séparée
de `admin:settings` car action critique : rotater à mauvais escient
casse les intégrations consumer le temps qu'ils updatent leur config.
Step-up MFA ≤ 5 min obligatoire.

Réponse : `{secret: <new>, secret_rotated_at, next_rotation_due_at}`.
Le nouveau secret n'est retourné qu'une seule fois ici — l'admin DOIT
le copier maintenant (cf modèle WebhookEndpoint qui ne le réexpose plus).

R314 (audit iPaaS BUG-INT-7) — accepte `grace_hours` (body) pour
contrôler la fenêtre de validité du secret précédent (défaut 24h, max
168h = 7j). Réponse enrichie avec `secret_previous_expires_at`.

Permissions requises : webhooks:rotate_secret

post/api/v1/integrations/webhooks/{endpoint_id}/rotate-secret

Request

  • Base URL: https://erp.eyeot.fr/api/v1
  • URL: https://erp.eyeot.fr/api/v1/api/v1/integrations/webhooks/{endpoint_id}/rotate-secret
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Response

Succès — payload {data, meta} (cf. API-GUIDE §3.1)

Changes

No recorded changes to this operation across all 1 revision of this API.