HYPHApar S33D
Documentation › Intégrations

Équipements réseau et sécurité (syslog)

L'équipement envoie ses journaux à un agent de votre réseau ; le serveur les découpe avec le modèle de l'éditeur et en tire des attributs communs à tous les équipements.

Principe

  1. L'équipement envoie son syslog (UDP ou TCP) à un agent HYPHA de son réseau.
  2. L'agent reçoit, décode l'en-tête syslog et note, d'après sa règle parsers, le modèle d'analyse à appliquer (attribut syslog.parser).
  3. Le serveur découpe le message avec ce modèle : action du pare-feu, adresses et ports, protocole, règle, utilisateur, interface, gravité propre à l'équipement, type d'événement.

Éprouvé sur des exemples, pas sur les équipements. Chaque modèle a été vérifié sur des lignes tirées de la documentation publique de l'éditeur (ou, quand elle n'en publie pas, d'un guide d'intégration public ou du format documenté), envoyées en UDP et en TCP à un agent d'essai. Aucun de ces équipements n'a été branché pour de vrai. Une ligne que le modèle ne reconnaît pas reste entière dans le message, sans attribut ajouté.

Activer la réception sur un agent

La réception syslog est coupée par défaut. Ajoutez un fichier conf.d/40-syslog.yaml à l'agent qui recevra les journaux :

syslog:
  enabled: true
  udp: "0.0.0.0:5514"          # adresse:port ; vide = pas d'UDP
  tcp: "0.0.0.0:5514"          # trames terminées par une fin de ligne ou préfixées de leur longueur
  allowed_sources: ["192.0.2.0/24"]   # seuls émetteurs admis (vide = tous)
  parsers:
    - {match: 192.0.2.1, parser: fortinet}        # adresse de l'émetteur
    - {match: 192.0.2.16/29, parser: cisco-asa}   # réseau CIDR
    - {match: "pfsense*", parser: pfsense}         # motif sur le nom d'hôte de l'en-tête
  tags: {site: siege}

Modèles

ÉquipementparserFormat reçuExemples des essais
Fortinet FortiGate (FortiOS)fortinetclé=valeur (date=… logid=…)éditeur : « Sample logs by log type » (FortiOS 7.0) et Fortinet Community
Stormshield SNSstormshieldclé=valeur WELF (id=firewall …)éditeur (alarme), FortiSIEM (filtrage)
pfSensepfsensefilterlog CSVéditeur (« Viewing the Firewall Log ») ; grammaire de Netgate
OPNsenseopnsensefilterlog CSV (même format)construites sur la grammaire de Netgate
Palo Alto Networks (PAN-OS)paloaltoCSV TRAFFIC, THREAT, SYSTEM, CONFIG, GLOBALPROTECTconstruites sur l'ordre des champs de PAN-OS 10.2
Cisco ASA et FTDcisco-asa%ASA-n-nnnnnn: …éditeur (Cisco Security Center) ; gabarits du guide des messages
SonicWall (SonicOS)sonicwallclé=valeur (id=firewall … m=… msg=…)FortiSIEM, IBM/Juniper JSA
WatchGuard Fireboxwatchguardmsg_id="…" puis Allow ou Deny …éditeur (catalogue des journaux Fireware 12.12) ; Graylog
Check PointcheckpointLog Exporter : syslog [clé:"valeur"; …], CEF, LEEFconstruites sur le format du guide Log Exporter
MikroTik RouterOSmikrotiksujets message (firewall,info input: …)éditeur (page « Log » de RouterOS)
Ubiquiti UniFi et EdgeOSubiquitijournaux du noyau ([RÈGLE] IN=… SRC=…), CEF de UniFi NetworkGraylog (le site de l'éditeur refuse les lectures automatiques)

Le modèle kv (vague 1) reste disponible pour tout autre équipement qui écrit des paires clé=valeur : chaque clé devient un attribut, sans normalisation.

Attributs produits

Les mêmes pour tous les modèles, quand l'équipement les donne :

AttributValeurs
evt.categorytraffic, threat, vpn, admin, system
evt.namenom de l'événement chez l'éditeur (sous-type, numéro de message, admin_login…)
evt.outcomesuccess, failure (connexions, VPN)
fw.actionallow, deny
fw.rulenom ou numéro de la règle, de la politique ou de la liste d'accès
network.source.ip, network.source.portsource du flux
network.destination.ip, network.destination.portdestination du flux
network.protocol, network.interface.in, network.interface.outprotocole et interfaces
usr.nameutilisateur ou administrateur
threat.name, threat.typesignature, virus, type de menace
vpn.tunnel, vpn.peer, vpn.statustunnel, pair distant, up ou down
device.vendor, device.product, device.name, device.severityéquipement et gravité donnée par l'équipement

Les champs bruts de l'éditeur restent sous son préfixe (fortinet.*, stormshield.*, filterlog.*, paloalto.*, cisco.asa.*, sonicwall.*, watchguard.*, checkpoint.*, mikrotik.*, ubiquiti.*). network.client.ip reste l'adresse de l'équipement émetteur.

Le statut de la ligne est aggravé, jamais abaissé : menace → warning (error si l'équipement la dit haute ou critique) ; échec de connexion d'administration, échec VPN, tunnel tombé → warning.

Exemples de recherche : source:syslog @fw.action:deny, @evt.category:threat, @evt.category:admin @evt.outcome:failure, @syslog.parser:cisco-asa @vpn.status:down.

Régler l'envoi sur l'équipement

Remplacez 192.0.2.50 par l'adresse de l'agent et 5514 par son port. Les menus changent d'une version à l'autre : vérifiez dans la documentation de la vôtre.

Moniteurs et tableaux prêts

Famille Équipements réseau et sécurité du catalogue des moniteurs, chacun groupé par équipement émetteur et restreint à un modèle si vous le voulez (variable parser) :

S'y ajoutent ceux de la réception elle-même : Réception syslog en échec, Équipement syslog muet, Lignes syslog jetées.

Le catalogue des tableaux propose un tableau par modèle (Fortinet FortiGate (syslog), Cisco ASA et FTD (syslog)…) : lignes reçues par équipement, lignes jetées, puis le trafic refusé, les menaces, l'administration, le VPN et les erreurs, filtrables par agent et par équipement.

Ce qui a été éprouvé

Dans une machine d'essai, un agent a reçu sur un port non privilégié, en UDP puis en TCP, chaque ligne d'exemple des onze modèles, envoyée depuis une adresse propre à chaque modèle ; les attributs analysés ont été relus dans HYPHA. Les lignes d'exemple et leur source sont dans server/tests/test_equipements.py. Ce qui ne l'est pas : le comportement des équipements réels (formats propres à une version, champs absents, volumes), les messages d'administration et de VPN que les éditeurs ne publient pas en exemple (Stormshield, SonicWall, Check Point, UniFi). Si un journal de votre équipement n'est pas reconnu, la ligne garde tout son texte : envoyez-nous un exemple anonymisé.

Mise à jour : 20 novembre 2026