Vérifiez que chaque requête de webhook provient bien de Firecrawl en vérifiant sa signature HMAC-SHA256. Cela empêche les attaquants d’usurper des payloads et vous permet d’avoir confiance dans les données avant d’agir en conséquence.
Le secret de votre webhook est disponible dans l’onglet Avancé des paramètres de votre compte. Chaque compte dispose d’un secret unique utilisé pour signer toutes les requêtes webhook.
Gardez le secret de votre webhook en lieu sûr et ne l’exposez jamais publiquement. Si vous pensez
que votre secret a été compromis, régénérez-le immédiatement depuis les paramètres
de votre compte.
Vérification de la signature
Chaque requête de webhook inclut un en-tête X-Firecrawl-Signature :
- Extraire la signature de l’en-tête
X-Firecrawl-Signature
- Récupérer le corps brut de la requête (ne le parsez pas au préalable)
- Calculer le HMAC-SHA256 avec votre clé secrète
- Comparer les signatures à l’aide d’une fonction de comparaison à durée constante
- Vérifiez chaque requête. Vérifiez toujours la signature avant de traiter un payload de webhook. Rejetez toute requête qui échoue à la vérification avec un code d’état
401.
- Utilisez des comparaisons à durée constante. La comparaison de chaînes standard peut révéler des informations temporelles. Utilisez
crypto.timingSafeEqual() dans Node.js ou hmac.compare_digest() en Python.
- Exposez votre point de terminaison en HTTPS. Cela garantit que les payloads de webhook sont chiffrés pendant le transit.