> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# pfSense / OPNsense

> Transférez les messages syslog du pare-feu et du DHCP de pfSense et d’OPNsense

## Configuration

Suivez le guide commun [Redirecteurs de journaux](https://docs.wirespeed.co/fr/integrations/log-forwarders.md) pour ajouter **pfSense / OPNsense** et ouvrir **Détails du redirecteur** (ou demandez au Chat l’`ip:port` de l’écouteur).

### pfSense

1. Ouvrez **Status** > **System Logs** et sélectionnez l’onglet **Settings**
2. Sous **General Logging Options**, réglez **Log Message Format** sur **syslog (RFC 5424, with RFC 3339 microsecond-precision timestamps)**. Ses horodatages incluent le décalage UTC et il contient le nom d’hôte du pare-feu. **BSD (RFC 3164, default)** est aussi pris en charge, mais il ne contient pas de nom d’hôte et ses horodatages n’ont pas de fuseau horaire : ils sont donc lus en UTC. Ce réglage modifie aussi le format des journaux locaux du pare-feu
3. Sous **Remote Logging Options**, cochez **Enable Remote Logging**
4. Saisissez l’écouteur au format `ip:port` dans **Server 1** sous **Remote log servers**. pfSense envoie uniquement en UDP ; utilisez donc un écouteur UDP. Le syslog UDP n’est ni chiffré ni authentifié : envoyez-le uniquement sur un réseau de confiance ou un tunnel VPN. S’il doit passer par un VPN, réglez **Source Address** sur cette interface
5. Sous **Remote Syslog Contents**, sélectionnez **Everything**. Pour limiter l’envoi, sélectionnez au moins **Firewall Events**, **DHCP Events** et **DNS Events**
6. Cliquez sur **Save**. Les événements commenceront à apparaître sous peu

Les détails des baux DHCP sont analysés à partir du serveur DHCP Kea, sélectionné sous **System** > **Advanced** > **Networking** > **Server Backend**. Les lignes de l’ancien backend ISC DHCP, obsolète, sont conservées sous **Autres**.

### OPNsense

1. Ouvrez **System** > **Settings** > **Logging** et sélectionnez l’onglet **Remote**
2. Cliquez sur **+** pour ajouter une destination et cochez **Enabled**
3. Réglez **Transport** selon **Détails du redirecteur** (**UDP(4)**, **TCP(4)** ou **TLS(4)**, ou la variante **(6)** pour un écouteur IPv6), puis saisissez le **Hostname** et le **Port** de l’écouteur
4. Laissez **Applications** vide pour tout envoyer, ou sélectionnez au moins **filter (filterlog)** et votre serveur DHCP : **kea (kea-dhcp4)**, **dhcpd (dhcpd)** ou **dnsmasq (dnsmasq)**
5. Cochez **RFC5424**, cliquez sur **Save**, puis sur **Apply**

Si **Détails du redirecteur** affiche **TLS : Activé**, OPNsense a besoin de deux éléments avant de pouvoir se connecter. Importez d’abord l’autorité de certification qui a émis le certificat de Wirespeed sous **System** > **Trust** > **Authorities**. Sélectionnez ensuite un certificat client dans le champ **Certificate** de la destination. OPNsense n’enregistre pas de destination TLS sans certificat client ; tout certificat doté d’une clé privée dans **System** > **Trust** > **Certificates** convient. Consultez [Syslog sur TLS](https://docs.wirespeed.co/fr/integrations/log-forwarders.md#syslog-sur-tls).

## Événements analysés

Chaque ligne est étiquetée avec sa famille de programmes (`filterlog`, `kea_dhcp`, `filterdns`, `cron` ou `other`). Le format BSD (RFC 3164) par défaut de pfSense ne contient pas de nom d’hôte ; le champ **host** reste donc vide, sauf si vous réglez **Log Message Format** sur syslog (RFC 5424).

* **Pare-feu** (`filterlog`) : numéro de règle, sous-règle, ancre, tracker, interface, motif, action et direction, ainsi que l’en-tête IPv4 ou IPv6 (TTL ou limite de sauts, indicateurs, protocole, longueur, adresses IP source et destination). TCP et UDP ajoutent les ports et la longueur des données ; TCP ajoute les indicateurs, le numéro de séquence, l’accusé de réception, la fenêtre et les options. ICMP ajoute le type et ses champs propres, et CARP ajoute ses champs d’annonce. OPNsense est détecté grâce à son libellé de règle de 32 caractères et enregistré comme variante.
* **DHCP** (`kea_dhcp`) : niveau de journal, logger et ID de message Kea. Les messages de bail tels que `DHCP4_LEASE_ALLOC` ajoutent l’adresse MAC du client, l’ID client, l’ID de transaction, l’adresse IP attribuée et la durée du bail.
* **Filter DNS** (`filterdns`) : le nom d’hôte d’alias en cours de résolution, enregistré comme domaine. Sur pfSense, cela nécessite **DNS Events** ou **Everything**.
* **Cron** (`cron`) : l’utilisateur et la commande.
* **Autres** : les lignes des autres programmes sont conservées avec leur nom de programme et leur message. Les lignes d’accès du webConfigurator (nginx) incluent aussi l’adresse IP du client, la requête, le statut et le user agent.

Les connexions à l’interface web et en SSH ne sont pas encore normalisées.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.