Installer le Widget
Ajoutez SilentShield à votre site web avec seulement deux lignes de code. Le Widget détecte automatiquement les formulaires et commence à les protéger.
Intégration de base
Ajoutez cet extrait de code avant la balise fermante </body> de votre site web :
<script src="https://api.silentshield.io/client.js?key=YOUR_API_KEY" defer></script>
<script>
document.addEventListener('DOMContentLoaded', function() {
SilentShield.init({ apiKey: 'YOUR_API_KEY' });
});
</script>Ce qui se passe automatiquement
- Le Widget détecte tous les formulaires de la page
- L'analyse comportementale démarre en arrière-plan (invisible pour les utilisateurs)
- Un CAPTCHA n'apparaît que lorsqu'un comportement suspect est détecté
- Un nonce de vérification est injecté dans les formulaires avant leur soumission
Vérification côté serveur (recommandée)
Après la soumission d'un formulaire, validez le nonce sur votre serveur pour confirmer que la soumission provient d'un humain.
POST https://api.silentshield.io/api/v1/captcha/verify-nonce
X-Api-Key: YOUR_API_KEY
PHPphp
<?php
$nonce = $_POST['ss_nonce'] ?? '';
$ch = curl_init('https://api.silentshield.io/api/v1/captcha/verify-nonce');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-Api-Key: ' . $apiKey,
],
CURLOPT_POSTFIELDS => json_encode(['nonce' => $nonce]),
CURLOPT_RETURNTRANSFER => true,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['verdict'] === 'bot') {
http_response_code(403);
die('Bot detected');
}Node.jsjavascript
const response = await fetch('https://api.silentshield.io/api/v1/captcha/verify-nonce', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Api-Key': process.env.SILENTSHIELD_API_KEY,
},
body: JSON.stringify({ nonce: req.body.ss_nonce }),
});
const data = await response.json();
if (data.verdict === 'bot') {
return res.status(403).json({ error: 'Bot detected' });
}Tests
Ajoutez ?silentshield-debug à votre URL pour activer l'overlay de débogage. Il affiche en temps réel le score comportemental, le verdict et les fonctionnalités actives.