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.
Un client vous envoie la page « 403 Forbidden »
La page de blocage de kokiGUARD, avec le nom du site et un identifiant de 16 lettres en bas.
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. Si la requête est légitime : « Corriger ce blocage » (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).
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 → 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 → 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.
Journaux, filtrés sur le site et le chemin, puis « Corriger ce blocage ». 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 de message d'échec, la configuration précédente est déjà remise en place.
Prévenez Kokiris si un message d'échec s'affiche : envoyez-le tel quel.
« Erreur 409 » en enregistrant
Vous êtes connecté à un nœud qui n'est pas le leader du cluster.
Reconnectez-vous par l'adresse principale du panel.
Prévenez Kokiris si l'erreur persiste.
Les boutons 🤖 ont disparu
L'assistant IA n'est pas configuré, votre rôle est inférieur à opérateur, ou le quota journalier est atteint.
Paramètres → Assistant IA → « Tester la connexion » (administrateur). Le quota repart de zéro chaque jour.
Le badge affiche « 🐕 Au repos » ou signale un service en erreur
Un service du pare-feu 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.