VeilleSite — Documentation

01 — Principe

Comment ça marche ?

1

Adresse enregistrée

La page est lue une première fois : son texte devient la référence

2

Vérification régulière

Toutes les 15 min à 24 h selon votre choix

3

Comparaison

Pourcentage de mots qui diffèrent de la référence

4

Alerte e-mail

Au-delà du seuil (1 % par défaut), ou si le site ne répond plus

02 — Destinataire des alertes

Avec ou sans compte GB Appli

Connecté à votre compte

Les alertes partent sur l'adresse du compte. La surveillance démarre immédiatement et toutes vos surveillances sont listées sur la page de l'outil.

Sans compte

Vous indiquez l'adresse qui recevra les alertes. Un e-mail de confirmation y est envoyé : la surveillance ne démarre qu'après activation (sous 48 h, sinon elle est effacée). Chaque surveillance se gère ensuite via son lien personnel, présent dans tous les e-mails.

Au maximum 10 surveillances par adresse e-mail. Lien perdu ? La page « Recevoir à nouveau mes liens » les renvoie à l'adresse d'alerte.

03 — Mesure du changement

Ce qui est comparé

Le texte visible uniquement : scripts, styles, commentaires et balises HTML sont retirés. Un changement de mise en forme ou de code de suivi ne déclenche donc pas d'alerte.
Le pourcentage est la part de mots qui diffèrent entre la référence et la version actuelle (0 % = identique, 100 % = aucun mot en commun). Sur une page de 1 000 mots, 1 % correspond à environ 10 mots ajoutés, retirés ou remplacés.
La référence reste fixe jusqu'à une alerte : de petites modifications successives finissent par déclencher une alerte quand leur cumul dépasse le seuil. Après une alerte, la version actuelle devient la nouvelle référence.
Fichiers non textuels (image, PDF…) : seule une empreinte est comparée, tout changement compte pour 100 %.

Les pages dont le contenu est construit en JavaScript dans le navigateur présentent peu de texte au serveur : les changements peuvent y passer inaperçus. Les pages avec date, compteur ou publicité textuelle changeante peuvent nécessiter un seuil plus élevé.

04 — Disponibilité

Quand le site ne répond plus

Un site est considéré hors ligne en cas d'erreur réseau, de délai dépassé (20 s) ou de réponse HTTP 400 et plus. Il est retenté une fois après 5 secondes avant de conclure. Vous recevez une seule alerte à la panne, puis une alerte quand il répond de nouveau — pas un e-mail à chaque vérification.

05 — Installation

Planifier les vérifications

Les vérifications sont lancées par une commande à exécuter toutes les 5 minutes. Elle ne vérifie que les surveillances arrivées à échéance et supprime les demandes non confirmées expirées.

*/5 * * * * cd /chemin/du/site && php bin/console app:veillesite:check

Sur un hébergement sans cron en ligne de commande, renseignez VEILLESITE_CRON_KEY puis faites appeler cette adresse toutes les 5 minutes (tâche planifiée de l'hébergeur ou service de cron externe) :

https://www.app.gbappli.fr/outils/veillesite/cron?key=VOTRE_CLE

06 — Sécurité

Protections en place

Réseau interne protégé

Les adresses privées ou locales (localhost, 10.x, 192.168.x, 169.254.x…) sont refusées, y compris à travers une redirection ou un nom de domaine qui y pointe. L'adresse IP vérifiée est celle réellement utilisée pour la requête.

Pas d'alerte non sollicitée

Sans compte, aucune alerte n'est envoyée tant que le destinataire n'a pas activé la surveillance depuis son e-mail. Chaque alerte contient un lien pour l'arrêter.

Limites anti-abus

5 créations par heure et par IP sans compte, 10 surveillances par adresse, pages limitées à 2 Mo, une vérification manuelle par minute.

Lien de gestion

Chaque surveillance a un lien secret et aléatoire. Quiconque le possède peut la mettre en pause, la modifier ou la supprimer : ne le partagez pas.

Documentation VeilleSite