Documentation
Tout ce qu’il faut pour placer un site derrière GuardX et l’exploiter au quotidien.
Démarrer
- Créez un compte dans le tableau de bord et choisissez une offre. Nous recommandons d’activer l’authentification à deux facteurs dans les Paramètres.
- Choisissez Ajouter un domaine. Saisissez le domaine (par exemple
example.com), l’adresse publique de votre serveur d’origine et son protocole HTTP ou HTTPS. - Suivez l’assistant : il prépare le certificat et affiche les enregistrements DNS à créer.
- Une fois le DNS propagé, le trafic arrive d’abord chez GuardX et les requêtes saines sont transmises à votre origine.
L’origine doit être une adresse IP ou un nom d’hôte public. Les adresses privées, de bouclage et de métadonnées cloud sont refusées.
DNS
| Type | Nom | Valeur | Rôle |
|---|---|---|---|
| CNAME | votre domaine ou sous-domaine | proxy.guardx.fr | Fait passer le trafic par GuardX |
| TXT | _acme-challenge.<votre domaine> | valeur affichée dans l’assistant | Prouve la propriété pour un certificat Let’s Encrypt |
Certains fournisseurs DNS n’autorisent pas de CNAME à la racine d’un domaine. Utilisez leur « CNAME flattening » ou un enregistrement ALIAS, ou déplacez le DNS chez un fournisseur qui le permet. Gardez un TTL bas pendant la bascule pour pouvoir revenir rapidement en arrière.
Certificats
GuardX délivre des certificats Let’s Encrypt gratuits via un défi DNS et les renouvelle automatiquement. Ajoutez l’enregistrement TXT puis choisissez Vérifier ; le contrôle s’exécute en arrière-plan et la page se met à jour en cas de succès. Vous pouvez aussi importer votre propre certificat et sa clé privée, et télécharger de nouveau votre lot de certificats après confirmation de votre mot de passe. Si votre DNS est chez Cloudflare, l’assistant peut le détecter et proposer la configuration adaptée.
Modes de protection
- Normal : les requêtes passent par le pare-feu et les limites de débit ; les visiteurs ne voient rien.
- Under Attack Mode : une brève vérification du navigateur écarte la plupart des robots avant la transmission de la requête.
- Captcha : un captcha arrête ce qui passe encore pendant une attaque.
- Automatique : GuardX relève le niveau quand il détecte une attaque et le rabaisse quand le trafic redevient normal.
Les visiteurs qui réussissent une vérification reçoivent un cookie de courte durée pour ne pas être sollicités à nouveau aussitôt. Voir la Politique relative aux cookies.
Pare-feu
Le pare-feu applicatif utilise d’emblée des règles inspirées de l’OWASP. Depuis le tableau de bord, vous pouvez régler chaque groupe de règles sur bloquer, journaliser seulement ou désactivé ; ajouter des règles personnalisées sur le chemin, les en-têtes, l’IP, le pays, etc. ; et définir des exceptions par chemin pour les faux positifs. Chaque changement est enregistré dans un historique permettant un retour en arrière en un clic. Certaines de ces commandes dépendent de votre offre.
Si un visiteur légitime est bloqué, demandez la référence affichée sur la page de blocage, retrouvez l’événement dans le tableau de bord et ajoutez une exception pour ce chemin.
Statistiques
Pour chaque domaine, le tableau de bord montre les requêtes autorisées et bloquées, les sources d’attaque et un flux en direct, pour voir ce qui a été arrêté et pourquoi.
Offres
Pro couvre 1 domaine, Business 5 et Enterprise 10. Business ajoute les règles personnalisées, les actions par règle et l’historique des règles ; Enterprise ajoute les limites de débit par point d’accès, la journalisation des charges d’attaque, la surveillance des scripts côté client et l’export d’événements. Détails et prix dans la section tarifs ; règles de facturation dans Facturation et résiliation.
Dépannage
- Le certificat reste en attente. L’enregistrement TXT est absent, erroné ou pas encore visible. Vérifiez-le avec un outil de requête DNS, attendez quelques minutes, puis relancez la vérification.
- Erreurs 502 ou 504. GuardX n’atteint pas votre origine. Vérifiez l’adresse et le protocole d’origine dans les réglages du domaine, que votre serveur est actif et que son pare-feu autorise GuardX.
- Boucle de redirection. Votre origine force le HTTPS alors que le domaine la contacte en HTTP. Réglez le protocole d’origine sur HTTPS.
- IP réelles des visiteurs. GuardX transmet l’adresse du client dans l’en-tête
X-Forwarded-For. Configurez votre serveur web pour ne lui faire confiance que depuis GuardX. - Toujours bloqué ? Écrivez à support@guardx.fr.