Que faire si…
Les situations les plus fréquentes, avec la marche à suivre. Dans le doute, prévenez Kokiris : un identifiant de requête ou une capture d'écran suffit pour trouver vite. Les messages d'erreur du panel reprennent la raison donnée par le serveur, souvent en anglais : copiez-la telle quelle.
Un client vous envoie la page « 403 Forbidden »
La page de blocage de kokiGUARD, avec le nom du site et, en bas, un identifiant de requête fait de chiffres, de lettres et de deux-points.
Une règle a réagi à sa requ ête. Souvent un faux positif sur un formulaire, une recherche ou le back-office.
Demandez-lui l'identifiant, puis ouvrez Journaux et collez-le dans Rechercher par Request ID. Vous voyez la règle et le chemin en cause ; 🔍 Détails puis 🔬 Radiographie montrent le champ et le fragment exacts (2.4). Si la requête est légitime : Corriger ce faux positif (3.1), ou envoyez l'identifiant à Kokiris.
Prévenez Kokiris si le blocage touche le tunnel de commande ou le paiement.
Recherche par identifiant. L'identifiant affiché sur la page 403 mène directement à la requête, à la règle et au chemin en cause.
Une page répond « Too Many Requests » (429)
Une page d'attente ou un code 429, avec un en-tête retry-after.
Une limite de débit sur ce chemin, ou une file d'attente pleine.
Fiche du site → Contrôle du trafic. Un client qui rafraîchit ne devrait pas dépasser une limite bien réglée : si c'est le cas, montez-la. Pour un partenaire ou un outil : trafic de confiance (3.2).
Un client voit un chien qui court avant d'arriver sur le site
La page du challenge de kokiGUARD (code 403) quelques instants, puis le site. Ou la page reste affichée.
Son adresse doit résoudre un challenge : le site est en mode Challenge et l'adresse a cumulé des blocages ou des erreurs, ou la carte « Robots et crawlers » soumet son navigateur au challenge. Sans JavaScript, ou sur un appareil très lent, la page ne passe pas.
Si le client attend moins de quelques secondes, rien. Sinon : Fail2Ban → Trouver une IP… → détails de l'IP → Lever le challenge (rôle opérateur, 4.5), puis cherchez dans ses journaux ce qui l'a fait monter.
Prévenez Kokiris si plusieurs clients le signalent en même temps.
Un envoi volumineux répond 413
Une erreur 413 Request Entity Too Large, avec l'en-tête x-waf-action: body-too-large, sur un formulaire ou une API.
Le corps de la requête dépasse la taille que kokiGUARD inspecte, et le site refuse ces envois.
Journaux → la ligne Corps trop grand · refusé (413) → Exempter ce chemin de la limite de taille, puis Appliquer (3.3). Si beaucoup de chemins sont touchés, demandez à Kokiris d'agrandir la taille inspectée.
Googlebot, ou un autre robot utile, ne passe plus
Des erreurs d'exploration dans Google Search Console, ou un 403 avec l'en-tête X-Bot-Blocked, ou un 429.
La carte « Robots et crawlers » du site bloque, limite ou soumet ce robot au challenge. Avec X-Bot-Blocked: impostor, ce n'est pas le vrai robot : son adresse est hors des plages publiées par son éditeur.
Fiche du site → Robots et crawlers → action Autoriser sur ce robot → Enregistrer les réglages des robots → Appliquer (3.5). Un usurpateur, lui, reste écarté.
La page de maintenance s'affiche sans que vous l'ayez demandé
La page « maintenance » de kokiGUARD, code 503.
Le mode maintenance est actif dans la fiche du site, souvent après un déploiement qui ne l'a pas retiré.
Fiche du site → Mode maintenance → videz le champ → Enregistrer les modifications → Appliquer.
Vous n'arrivez plus à joindre votre propre site
Délai dépassé, connexion refusée, ou 403 avec l'en-tête X-Geo-Blocked.
Votre adresse a été bannie après des tests insistants, ou vous passez par un VPN situé dans un pays bloqué.
Depuis une autre connexion (en 4G, par exemple) : Fail2Ban → Réputation ou Historique des bannissements → Débannir (rôle opérateur). Transmettez votre IP fixe à Kokiris pour qu'elle soit exemptée.
Prévenez Kokiris si vous n'avez pas d'autre connexion : Kokiris vous débannit.
Un formulaire ou le back-office ne fonctionne plus depuis une modification
Une erreur 403 sur une action précise, alors que le reste du site fonctionne.
Une règle ou une catégorie nouvellement active bloque une requête légitime. Sur PrestaShop ou Magento, un Chemin du back-office absent ou faux prive l'administration de ses exclusions.
Journaux, filtrés sur le site et le chemin, puis « Corriger ce blocage ». Pour une boutique, vérifiez le Chemin du back-office dans la fiche du site (5.1). Si la production est touchée et que la cause ne se trouve pas : Arrêt d'urgence (administrateur, 4.3), puis cherchez au calme.
Prévenez Kokiris si vous avez utilisé l'arrêt d'urgence.
Le bandeau « Appliquer · Annuler » ne disparaît pas
Le bandeau orange en haut de chaque page.
Des modifications enregistrées attendent, ou une application a échoué et a été restaurée.
Cliquez sur « voir » pour relire, puis Appliquer ou Annuler. En cas d'échec, le message donne la révision remise en place : la configuration précédente est déjà en service. Si le bandeau dit « application automatique », attendez : vos modifications partent seules dans les 5 minutes (2.2). Sans bouton Appliquer ni application automatique, votre compte n'a pas ce droit : demandez à un éditeur ou à Kokiris.
Prévenez Kokiris si un message d'échec s'affiche : envoyez-le tel quel.
« Erreur 409 » en enregistrant
Un message en anglais, par exemple « This node is in standby mode ».
Vous êtes connecté à un nœud qui n'est pas le leader du cluster.
Reconnectez-vous par l'adresse principale du panel. Si le message parle de « lease » ou de « term », réessayez dans quelques secondes.
Prévenez Kokiris si l'erreur persiste.
Les boutons 🤖 ont disparu
L'assistant IA n'est pas configuré, votre profil n'a pas le droit Assistant IA (rôle opérateur au minimum), ou le quota journalier est atteint.
Paramètres → Assistant IA → « Tester la connexion » (administrateur). Le quota repart de zéro chaque jour.
Une adresse est bannie sans avoir déclenché de règle
Dans Journaux, une ligne « Scan · N/min » pour cette adresse, sans site ni chemin.
La détection des scanners est en mode Bannir : vos sites ont renvoyé trop d'erreurs à cette adresse. Souvent un vrai scanner ; parfois une entreprise ou un opérateur mobile dont tous les visiteurs partagent l'adresse, un outil qui vérifie vos liens, ou l'adresse d'un CDN.
Si la source est légitime : Fail2Ban → Débannir, puis trafic de confiance pour son adresse (3.2), ou le chemin visité dans Chemins non comptés (4.4). Derrière un CDN, repassez la détection en Détection seule.
Prévenez Kokiris si l'adresse bannie est celle d'un CDN ou d'un proxy devant vos sites.
Le badge affiche « 🐕 Au repos » ou signale un service en erreur
Un service de kokiGUARD est arrêté ou en défaut.
Rien à faire de votre côté : Kokiris supervise ces services et intervient.
Prévenez Kokiris si le badge reste dans cet état plus de quelques minutes.
« Fait sur ce nœud seulement : les autres nœuds n'ont pas été prévenus. »
Un avertissement après un bannissement, un débannissement ou le vidage d'une prison.
L'action a réussi sur le nœud qui vous répond, mais n'a pas pu être transmise aux autres nœuds du cluster.
Notez l'adresse et l'action, puis prévenez Kokiris pour qu'elle soit reportée partout (4.1).
Prévenez Kokiris si vous voyez ce message.
« Droits insuffisants », ou une page manque dans le menu
Votre profil ne donne pas ce droit : le menu ne montre que les pages que votre compte peut ouvrir.
Demandez à un administrateur de votre équipe d'ajuster votre profil (5.5). Après le changement, reconnectez-vous.
Vous êtes renvoyé à la page de connexion
Votre session a expiré : 8 heures sans activité, ou 24 heures après la connexion, par défaut. Un changement de vos droits ou de votre mot de passe ferme aussi vos sessions.
Reconnectez-vous : vous revenez sur la page où vous étiez.
Le panel affiche « Trop de requêtes, patientez une minute »
Plusieurs onglets du tableau de bord ou des journaux se rafraîchissent très souvent. La limite compte pour votre compte entier, tous onglets confondus.
Attendez une minute. Fermez les onglets en trop, ou passez l'actualisation automatique de 5s à 1m.