Test des URL de rappel Cams en local avec ngrok
Avant de déployer votre intégration en production, vous pouvez tester les rappels de l'API Cams directement sur votre machine de développement à l'aide d'un outil de tunnelisation. Ce guide vous accompagne pas à pas dans la configuration.
Pourquoi vous avez besoin d'un tunnel
Les requêtes de rappel et de webhook proviennent de la plateforme Cams via Internet. Une application locale exécutée sur votre machine ne peut pas recevoir directement ces requêtes, car elle se trouve derrière un pare-feu ou un réseau NAT.
Un service de tunnelisation crée un point de terminaison public sécurisé qui redirige les requêtes entrantes vers votre application locale.
Avantages
- Tester les rappels avant le déploiement
- Déboguer les charges utiles des webhooks en temps réel
- Valider le traitement des requêtes en local
- Réduire le temps de développement et de déploiement
Outils de tunnelisation recommandés

Configuration de ngrok (recommandé)
Installation
- Rendez-vous sur https://ngrok.com
- Téléchargez la version appropriée pour votre système d'exploitation.
- Extrayez et installez le fichier exécutable.
- Créez un compte gratuit (facultatif, mais recommandé).
- Générez un AuthToken.
- Configurez votre AuthToken.
ngrok config add-authtoken YOUR_AUTHTOKEN
Démarrer un tunnel
Si ngrok est déjà configuré :
ngrok http 3000
Remplacez 3000 par le port de votre application.
Exemple de sortie
Forwarding https://abc123.ngrok-free.app -> http://localhost:3000
Votre application est désormais accessible via l'URL HTTPS publique.
Alternative : utiliser l'outil de test de rappel Cams
Vous pouvez également utiliser l'utilitaire de test de rappel fourni par Cams.
- Installez et décompressez l'outil à l'aide du lien suivant.
https://developer.camsbiometrics.com/setup/ngrok-helper-kit.rar - Modifiez le fichier
app.properties. - Configurez :
ngrok.auth.token=
ngrok.tunnel.url= - Exécutez :
check_ngrok.bat
L'utilitaire établira automatiquement le tunnel et simplifiera les tests de rappel en local.
Configuration de l'intégration des rappels
Étape 1 : Démarrez votre application locale
Étape 2 : Démarrez le tunnel
Étape 3 : Testez le rappel
Déclenchez un événement de test et vérifiez les points suivants :
- Votre application reçoit la requête de rappel.
- Les charges utiles des requêtes sont traitées avec succès.
- Aucune erreur n'apparaît dans les journaux de l'application.
- Les requêtes sont visibles dans le tableau de bord du tunnel.
Bonnes pratiques
- Utilisez des URL de rappel HTTPS dans la mesure du possible.
- Gardez le tunnel actif pendant les tests.
- Consultez les journaux de l'application pour valider les requêtes.
- Vérifiez que votre point de terminaison renvoie les codes de réponse HTTP attendus.
- Testez les scénarios de gestion des erreurs avant le passage en production.
Remarques importantes
- Les URL ngrok gratuites changent à chaque redémarrage du tunnel.
- Les offres ngrok payantes prennent en charge les domaines réservés et les sous-domaines personnalisés.
- Les tunnels temporaires ne doivent être utilisés qu'à des fins de développement et de test.
Conclusion
Exposer votre serveur local via un service de tunnelisation est le moyen le plus rapide de tester votre URL de rappel avant de déployer votre application. Que vous utilisiez ngrok, Cloudflare Tunnel ou localhost.run, ce processus vous permet de recevoir les requêtes de rappel en temps réel et de valider votre intégration dans un environnement de développement local.
Suivre les étapes ci-dessus vous aidera à garantir une transition fluide du développement vers le déploiement en production.