FAQ technique
Les questions des développeurs qui intègrent Zarex.
Puis-je utiliser le SDK dans le navigateur ?
Non. La clé API est un secret : le SDK s'utilise uniquement côté serveur (middleware, route handler, Server Action, hook serveur). Avec Next.js, n'utilisez jamais de variable NEXT_PUBLIC_ pour la clé.
Que compte une décision ?
Chaque appel du SDK à Zarex compte pour une décision, quel que soit le nombre de règles évaluées (de 1 à 10).
Puis-je avoir des règles différentes selon les routes ?
Oui. Créez une configuration par route ou par groupe de routes : un middleware par route avec Express, un withZarex par route handler avec Next.js. Vous pouvez aussi remplacer les règles pour une requête précise avec le champ rules de call.
Zarex voit-il les mots de passe de mes utilisateurs ?
Pas par défaut : le corps des requêtes n'est envoyé que si vous activez inspectBody. Dans ce cas, il sert à l'analyse mais n'est jamais enregistré dans le journal. Voir Sécurité et confidentialité.
Pourquoi utiliser une clé de test et une clé de production ?
Pour séparer votre trafic : l'environnement de la clé apparaît sur chaque décision du journal. Une clé de test qui fuit dans un dépôt se révoque sans toucher à la production.
Que signifie « Erreur » dans le journal ?
Une règle n'a pas pu être évaluée, par exemple une vérification DNS de robot impossible. La requête a été autorisée : Zarex ne bloque jamais sur un doute.
Combien de temps les décisions sont-elles conservées ?
Un an.
Zarex détecte-t-il les VPN et Tor ?
Non. Zarex connaît le pays et le réseau (ASN) de chaque adresse, que vous pouvez filtrer avec un filtre, mais il ne classe pas les adresses en VPN, Tor ou hébergeur.
Quels frameworks sont pris en charge ?
Next.js, Express, Fastify (et NestJS sur Fastify), SvelteKit et Bun. Pour un autre environnement Node.js, createZarex et protect permettent une intégration directe : voir Options du SDK.