Et si l'API IPScanner est indisponible ?

Le Worker laisse passer : après 1,5 seconde ou en cas d'erreur, la requête continue avec X-IPScanner-Status à timeout ou error.

Va-t-il bloquer Googlebot ?

Non. Les moteurs de recherche et les crawlers IA vérifiés par Agentscan passent toujours, même en mode enforce.

Fonctionne-t-il avec les offres gratuites ?

Oui. Il tourne sur l'offre gratuite de Cloudflare Workers, et l'offre gratuite d'IPScanner inclut 30 000 requêtes par mois.

IPScanner

Cloudflare Workers

Détection des bots et VPN dans un Cloudflare Worker

Un Worker placé devant votre site vérifie chaque visiteur et transmet le résultat à votre serveur d'origine.

Déployer sur Cloudflare Voir sur GitHub

Visiteur203.0.113.24

IPScanner WorkerEdge Cloudflare

Votre serveur d'origine

X-IPScanner-Classhuman
X-IPScanner-Actionallow

Installation

En ligne en trois étapes

Déployer le Worker

Ou utilisez le bouton de déploiement ci-dessus.

shell

git clone https://github.com/ipscanner/ipscanner-cloudflare
cd ipscanner-cloudflare
npm install
npx wrangler deploy

Ajouter votre clé API

shell

npx wrangler secret put IPSCANNER_API_KEY

3
Le placer devant votre site
Sur un domaine personnalisé ou workers.dev, faites plutôt pointer ORIGIN_URL vers votre backend.
wrangler.jsonc
```
"routes": [{
  "pattern": "example.com/*",
  "zone_name": "example.com"
}]
```

Fonctionnement

Ce qui se passe à chaque requête

1
Le Worker lit l'IP, le User-Agent et le JA4 du visiteur, quand Cloudflare le fournit.
2
Agentscan et IP Detection tournent en parallèle, avec un cache par visiteur, et laissent passer la requête après 1,5 seconde.
3
Le mode monitor envoie les en-têtes de verdict à votre serveur d'origine. Le mode enforce répond en plus par un 403 au visiteur bloqué.
4
Les crawlers vérifiés passent toujours, et les en-têtes X-IPScanner-* envoyés par le client sont supprimés.

En-têtes

Les en-têtes reçus par votre serveur d'origine

Si une vérification échoue ou est ignorée, seul X-IPScanner-Status est défini.

En-tête	Source	Exemple
X-IPScanner-ClassAgentscan	Agentscan	human
X-IPScanner-ActionAgentscan	Agentscan	allow
X-IPScanner-ConfidenceAgentscan	Agentscan	0.92
X-IPScanner-Network-ClassIP Detection	IP Detection	residential_clean
X-IPScanner-AnonymizedLes deux	Les deux	false
X-IPScanner-RiskIP Detection	IP Detection	12
X-IPScanner-CountryIP Detection	IP Detection	DE
X-IPScanner-StatusWorker	Worker	ok

Réglages

Définissez-les dans le bloc vars de wrangler.jsonc.

Variable	Par défaut	Rôle
MODEmonitor ajoute les en-têtes, enforce bloque aussi	monitor	monitor ajoute les en-têtes, enforce bloque aussi
CHECK_AGENTLance Agentscan	true	Lance Agentscan
CHECK_IPLance IP Detection	true	Lance IP Detection
BLOCK_CLASSESClasses Agentscan à bloquer en mode enforce	malicious_automation	Classes Agentscan à bloquer en mode enforce
BLOCK_ANONYMIZEDBloque aussi VPN, proxy et Tor en mode enforce	false	Bloque aussi VPN, proxy et Tor en mode enforce
TIMEOUT_MSPar appel, ensuite la requête passe	1500	Par appel, ensuite la requête passe
AGENT_TTLSecondes de cache pour un verdict Agentscan	600	Secondes de cache pour un verdict Agentscan
IP_TTLSecondes de cache pour une recherche IP	3600	Secondes de cache pour une recherche IP
SKIP_PATHSRegex des chemins exclus du contrôle	Ressources statiques	Regex des chemins exclus du contrôle
ORIGIN_URLBackend de destination hors route	Vide	Backend de destination hors route

Questions

FAQ du Cloudflare Worker

Une requête par vérification activée pour chaque visiteur absent du cache, donc deux avec les deux vérifications. Les visites répétées pendant le TTL du cache ne coûtent rien.

Commencez en mode monitor

Observez les en-têtes pendant une semaine avant de bloquer quoi que ce soit.

Créer une clé API gratuite