Aller au contenu

Surveillance et sécurité

8 outils. Chacun rejoue une route de l’API avec vos droits.

nexus_list_scan_runs Les campagnes d’analyse lecture

Les campagnes d’analyse du parc (des agents vérifient les sites) : sans identifiant la liste, avec un identifiant le détail site par site — verdicts, constats, résumés.

  • id texte, facultatif
  • limit nombre, facultatif — Nombre d’éléments (défaut selon la route, 50 au plus)
nexus_site_monitoring La disponibilité d’un site lecture

La surveillance d’un site : le réglage, la courbe des sondes, les incidents, le taux de disponibilité et la panne en cours. Sans dates, les dernières 24 heures. `components: true` ajoute ce qui est installé (CMS, extensions, PHP) et les mises à jour constatées. Un site non surveillé rend `monitored: false` et sa raison — ce n’est pas « tout va bien ».

  • id texte
  • from texte, facultatif — Début de la fenêtre (ISO 8601 ; défaut 24 h)
  • to texte, facultatif
  • components booléen, facultatif — Ajouter l’inventaire de ce qui est installé
nexus_update_site_monitoring Régler la surveillance d’un site écrit

Règle la surveillance d’un site : activation, chemin sondé, texte attendu, silence de maintenance, examen de sécurité, racine web sur la machine. Seuls les champs nommés changent. L’hôte sondé vient toujours de l’adresse du site et ne se choisit pas ici.

  • id texte
  • enabled booléen, facultatif
  • path texte, facultatif — Chemin sondé sous l’adresse du site, ex. « /sante » — jamais un hôte
  • expectText texte, facultatif — Texte attendu dans la page ; null pour ne rien attendre
  • mutedUntil texte, facultatif — Silence de maintenance jusqu’à cette date ; null le lève tout de suite
  • securityEnabled booléen, facultatif — Examen de sécurité quotidien (distinct de la disponibilité)
  • docRoot texte, facultatif — Racine web du site SUR SA MACHINE (« /var/www/boutique/current ») : chemin absolu, sans espace ni caractère spécial. Elle ouvre le détecteur qui lit le disque.
nexus_check_site_now Sonder un site tout de suite écrit

Sonde un site immédiatement, sans attendre le planificateur, et rend ce que la sonde a vu. `components: true` relève aussi l’inventaire de ce qui est installé, avec l’accès SSH de la machine sans jamais le rendre ; un seul relevé tourne à la fois par site.

  • id texte
  • components booléen, facultatif — Relever aussi l’inventaire du site
nexus_list_site_threats Les intrusions du parc lecture

Les soupçons d’intrusion de TOUT le parc en un appel, les avérés d’abord : c’est la réponse à « qu’est-ce qui est piraté chez nous ? ». À PRÉFÉRER à une boucle sur nexus_site_security — le plafond de débit refuse un parc interrogé site par site. La réponse porte aussi `examined` et `unexamined` : un tableau de constats vide ne se lit « tout va bien » que si l’on sait combien de sites ont été regardés, et lesquels ne l’ont jamais été.

nexus_site_security Les soupçons d’intrusion d’un site lecture

L’examen de sécurité d’un site : les constats ouverts puis l’historique, la date du dernier examen, et les sources consultées. Deux niveaux — AVERE (une liste publique marque le site, un fichier répond) et SUSPECT (une différence, qui peut être la mise en production de mardi). Un site jamais examiné rend un tableau vide ET `checkedAt` nul : les deux ne disent pas la même chose, et `sources` nomme ce qui n’a pas pu être consulté. Une source muette ne lave personne. Pour le PARC entier, un seul appel suffit : nexus_list_site_threats.

  • id texte
nexus_scan_site_security Examiner un site maintenant écrit

Examine un site tout de suite : empreinte de la page, destination réelle après redirections, page servie à un robot d’indexation, fichiers qui ne devraient jamais répondre, zone DNS, émetteur du certificat, listes publiques — et, si la machine et la racine web sont connues, ce que le dépôt déployé dit du disque. L’examen n’attaque rien : des requêtes en lecture, aucun mot de passe essayé, aucune écriture.

  • id texte
nexus_resolve_site_threat Refermer un constat d’intrusion écrit

Referme un constat de sécurité. `normal: true` veut dire « ce changement était le nôtre » : l’empreinte de référence est effacée, et le prochain examen la réécrit depuis ce que le site sert vraiment. Sans lui, le constat est classé sans toucher à la référence. Ne referme jamais un constat que tu n’as pas expliqué à l’utilisateur.

  • id texte — Identifiant du constat, donné par nexus_site_security
  • normal booléen, facultatif — Le changement était légitime — reprend l’empreinte de référence
  • note texte, facultatif — Ce qui a été constaté, pour l’historique