Configurare Generic Syslog

Prerequisiti

Seleziona il tenant in Integrazioni → Aggiungi integrazione. Servono un'assegnazione Data Plane leggibile, il permesso di creazione e il provider Generic Syslog disponibile nel catalogo. I protocolli offerti dipendono dal contesto della destinazione.

Syslog autorizza un'identità sorgente sul listener condiviso del Data Plane. Non crea una porta dedicata per ciascun dispositivo. Indirizzo, porta e protocollo da configurare sul mittente sono quelli restituiti dal risultato del wizard.

Campi

Campo	Valore e regola
Source	Generic Syslog.
Services	Raccolta logs; l'inventario non è una capacità di questo provider.
Integration name	Nome obbligatorio non vuoto; la UI limita a 120 caratteri.
Transport	UDP (udp) oppure TLS (tcp_tls), tra quelli proposti.
Existing channel	Create a new channel o Use an existing compatible channel. Senza canali compatibili la seconda scelta è disabilitata.
Channel	Obbligatorio se riutilizzi un canale; scegliere un ID compatibile con il contesto.
Source public IP address	Obbligatorio solo con UDP: IP pubblico di uscita visto dal Data Plane dopo NAT.
TLS certificate fingerprint	Obbligatorio solo con TLS: impronta SHA-256 del certificato client presentato dal mittente al gateway.

UDP e TLS richiedono identità diverse: non compilare contemporaneamente IP e fingerprint. Il backend rifiuta un IP UDP non pubblico con PUBLIC_SOURCE_IP_REQUIRED. Più dispositivi dietro lo stesso NAT condividono l'IP usato per associare il tenant, pur conservando identità dispositivo distinte negli eventi.

Per TLS copia l'impronta dalle impostazioni del certificato del mittente. Il campo accetta una rappresentazione esadecimale SHA-256, con eventuali separatori :; il validatore ammette 64–95 caratteri esadecimali/separatori. Non inserire la chiave privata o il certificato completo nel campo fingerprint.

Attivazione e prova della sorgente

1. Completa Source e Configuration, quindi salva la configurazione dell'operazione.
2. Esegui Preflight e risolvi ogni controllo blocked.
3. Avvia Activation e attendi la rilettura della configurazione.
4. Nel Result copia endpoint e protocollo restituiti nella configurazione del mittente.
5. Verifica l'evidenza di arrivo tramite ultimo evento e stato della sorgente.

configurationVerified conferma la configurazione riletta; sourceVerified conferma evidenza della sorgente. Con configurazione applicata ma nessun evento puoi avere awaiting_source: controlla mittente, destinazione, trasporto e identità prima di creare un'altra integrazione.

Gli IP di esempio nella documentazione, come 203.0.113.10, sono riservati agli esempi e non rappresentano indirizzi utilizzabili per attivare una sorgente reale.

Recupero errori

Condizione	Seguito
Contesto Data Plane non leggibile	Ripristina lettura/assegnazione prima di proseguire. Non dedurre l'assenza dell'assegnazione da un errore di rete.
SETUP_INPUT_INVALID	Ricontrolla campi obbligatori, capacità e identità coerente col protocollo.
PUBLIC_SOURCE_IP_REQUIRED	Inserisci l'IP pubblico effettivo dopo NAT, non quello privato del dispositivo.
Attivazione/readback in attesa	Riprendi l'operazione salvata e usa il controllo attivazione.
Configurazione verificata senza evento	Completa la sorgente e osserva un evento; il salvataggio non genera traffico.