Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- software:syslog-ng [2008/10/22 17:52] – st
+++ software:syslog-ng [2018/07/23 12:29] (aktuell) – [verschlüssel mit stunnel] st
@@ Zeile 1: / Zeile 1: @@
+====== Syslog-ng ======
+[[wpde>Syslog-ng]] ist ein gebräuchlicher Syslog-Server auf der Linux- und Unix-Plattform. Dieses Programm implementiert das syslog-Protokoll und bietet einige Erweiterungen, die bekannte Schwachstellen des Protokolles beheben sollen. Syslog-ng ist eine quelloffene Softwarelösung. Quelle: [[wpde>Syslog-ng|Wikipedia]]
+Im Gegensatz zum alten syslog bietet syslog-ng mehr Funktionen (z. B. tcp-Verbindungen) und ist flexibler zu konfigurieren. Es existiert auch eine [[http://www.patownsend.com/syslog-ngPE.htm|kommerzielle Variante]].
+===== Links =====
+  * [[http://home.datacomm.ch/prutishauser/texte/syslog-ng-de.txt|syslog-ng reference manual]]
+  * [[http://www.oreilly.de/catalog/netsechacksger/chapter/hack59.html|Netzwerksicherheits Hacks: Hack #59 Aggregieren Sie Protokolle von entfernten Sites]]
+===== Konfiguration =====
+Die Konfiguration von syslog-ng ist relativ gut in der Datei ''/etc/syslog-ng/syslog-ng.conf'' erklärt.
+Die allgemeine Syntax ist nach dem Schema
+<file>
+NAME {
+        # Kommentare
+        EINSTELLUNG(PARAMETER);
+};
+</file>
+Jede Zeile und jeder Block (geschweifte Klammerm) wird also mit einem Semikolon abgeschlossen
+Grundsätzlich sind vier Arten von Einstellungen zu machen
+  - Optionen (options
+  - Quellen (source)
+  - Filter (filter)
+  - Ziele (destination)
+==== Optionen (options) ====
+Optionen (options) wirken global.
+<file>
+options {
+        # the number of lines buffered before written to file
+        # you might want to increase this if your disk isn't catching with
+        # all the log messages you get or if you want less disk activity
+        # (say on a laptop)
+        # (default is 0)
+        #sync(0);
+};
+</file>
+==== Quellen (source) ====
+Quellen (source): Hier wird die Quellen von Protokolldaten angegeben.
+Allgemeine Syntax:
+<file>
+source NAME {
+ Einstellung
+};
+</file>
+Als Quellen werden
+  - **Pipes** <file>unix-stream("/dev/log");</file>
+  - **Dateien** (files) <file>file("/proc/kmsg" log_prefix("kernel: "));</file>
+  - **Netzwerkquellen** über
+    - UDP <file>udp( ip(127.0.0.1) port(514) )</file> (für alte syslogs) oder
+    - TCP unterstützt.<file>
+source NAME {tcp(ip("127.0.0.1")
+ port(514));
+ };
+</file>
+Letzteres wird bei einer Konfiguration als Log-Host (siehe unten) wichtig.
+Die vorgegebene Quelle s_all sieht so aus:
+<file>
+source s_all {
+        # message generated by Syslog-NG
+        internal();
+        # standard Linux log source (this is the default place for the syslog()
+        # function to send logs to)
+        unix-stream("/dev/log");
+        # messages from the kernel
+        file("/proc/kmsg" log_prefix("kernel: "));
+        # use the following line if you want to receive remote UDP logging messages
+        # (this is equivalent to the "-r" syslogd flag)
+        # udp();
+};
+</file>
+==== Filter (filter) ====
+    * facility(facility1,facility2,...): Lass alle Messages durch, die dieser Facility entsprechen.
+    * level(prio1, prio2,...) (oder synonym priority()): Lass alle Messages durch, die der angegebenen Priorität/Level entsprechen.
+    * program(regexp): Alle Meldungen, die vom Programm kommen, worauf regexp passt, werden durchgelassen. Hierbei ist regexp ein  [[linux:textdateibehandlung#regular expressions (RegEx, reguläre Ausdrücke)|regulärer Ausdruck]]. Hat man Leerzeichen (whitespaces) im Programmnamen, sollte man den Ausdruck zwischen doppelte Anführungsstriche setzen.
+    * host(regexp): Filterung nach Host, woher die Message kommt, ebenfalls regulärer Ausdruck. Eine einfache Filterung wäre nach dem Hostnamen, z. B. so: host(myhost). Genau genommen müsste man host("^myhost$") schreiben.
+    * match(regexp): Dies lässt nur Meldungen durch, wo die eigentliche Message auf dieses Muster passt. Dies ist ein sehr leistungsfähiger Mechanismus, lassen sich doch so ganz gezielt Meldungen herausfischen. Es gibt fast nichts, was man nicht mit regulären Ausdrücken erschlagen könnte.
+    * filter(filter_name): Um kompliziertere Filterregeln zu erstellen, kann man mehrere Filter zu einem neuen Filterkonstrukt zusammenfügen. Hiermit kann man also andere Filter in einem neuen Filter aufrufen. Damit kann man verschachtelte Filterkonstrukte erstellen. Es ist oft auch für die Lesbarkeit besser, zuerst mehrere Teilfilter zu definieren, die man dann in einer weiteren Filterregel zusammenfügt.
+[[http://www.selflinux.org/selflinux/html/syslog-ng03.html#d65e291|Quelle: Selflinux (Lizenz: GNU FDL)]]
+==== Ziele (destination) ====
+Ziele (destinations): Die eigentlichen Logdateien bzw. entfernte Rechner.
+<file>
+destination d_syslog { file("/var/log/DATEI.log" owner("root") group("adm") perm (0640)); };
+</file>
+Anstatt Dateien können auch andere Ziele (z. B. über tcp) angegeben werden:
+<file>
+destination loghost {tcp("IP" port(514));};
+</file>
+Als Ziel ist auch eine [[datenbanken:Datenbanken|Datenbank]] (siehe [[http://freshmeat.net/projects/sqlsyslogd/|sqlsyslogd]] usw.) möglich.
+:!: Es gibt die Möglichkeit ein Ausgabeformat mit template() festzulegen. Dies und mehr wird in der **[[http://www.selflinux.org/selflinux/html/syslog-ng03.html#d65e447|Selflinux-Dokumentation zum destination Objekt]]** beschrieben.
+Auf einem Loghost eine eine Sortierung nach Hosts usw. sehr nützlich. Beispiel:
+<file>
+destination std {
+	file("/var/log/HOSTS/$HOST/$YEAR/$MONTH/$DAY/$FACILITY_$HOST_$YEAR_$MONTH_$DAY"
+		owner(root) group(root) perm(0600) dir_perm(0700) create_dirs(yes)
+	);
+};
+</file>
+==== minimales Beispiel ====
+Ein minimales Beispiel für die facility local0:
+<file>
+destination df_local0 { file("/var/log/local0.log"); };
+filter f_local0 { facility(local0); };
+log {
+        source(s_all);
+        filter(f_local0);
+        destination(df_local0);
+};
+</file>
+===== LogHost mit syslog-ng =====
+==== unverschlüsselt ====
+  - ''syslog-ng'' auf Client und Server installieren
+  - **auf dem Client** in der Datei ''/etc/syslog-ng/syslog-ng.conf'': <file>
+destination loghost {tcp("192.168.0.1" port(30514));};
+log {
+        source(s_all);
+        destination(loghost);
+};
+</file>:!: Als IP des Servers 192.168.0.1 und als Port wird 30514 angenommen, die Werte sollten angepasst werden. Wenn Meldungen über fehlgeschlagene Logins (faciliy: auth, authpriv) nicht im Protokoll enthalten sein sollen, fügt man zwischen source und destination noch folgenden Zeile an: <file>filter(f_syslog);</file>
+  - **auf dem Server** in der Datei ''/etc/syslog-ng/syslog-ng.conf'':<file>
+source s_remote {
+  tcp(ip("192.168.0.1")
+  port(30514)
+  max-connections(1));
+  };
+destination d_remote_syslogs {
+  file("/var/log/loghosts/syslogs.log");
+  };
+# syslog von den Clients
+log {
+ source(s_remote);
+ filter (f_syslog);
+ destination(d_remote_syslogs);
+ };
+# auth,authpriv von den Clients
+destination d_remote_auths {
+  file("/var/log/loghosts/auths.log");
+  };
+log {
+ source(s_remote);
+ filter (f_auth);
+ destination(d_remote_auths);
+ };
+</file> :!: Als IP des Servers 192.168.0.1 und als Port wird 30514 angenommen, die Werte sollten angepasst werden. Ebenso die Pfade der Protokolldateien (''/var/log/loghosts/auths.log'' und ''/var/log/loghosts/syslogs.log''). Falls oben auth und authpriv herausgefiltet hat, ist der Abschnitt ab "# auth,authpriv von den Clients" natürlich nicht mehr nötig. Ggf. sollten die Optionen angepasst werden: <file>
+options {
+  long_hostnames(off);
+  sync(0); # Anzahl der Zeilen bevor auf die Festplatte geschrieben wird
+  keep_hostname(yes); # Hostnamen beibehalten?
+  chain_hostnames(no); #  "chained hostname"-Format?
+  };
+</file> Die Filter f_auth und f_syslog sind in der Konfiguration bereits standardmäßig vordefiniert und brauchen daher nicht mehr angegeben zu werden. Der Vollständigkeit halber dennoch: <file>
+# all messages from the auth and authpriv facilities
+filter f_auth { facility(auth, authpriv); };
+# all messages except from the auth and authpriv facilities
+filter f_syslog { not facility(auth, authpriv); };
+</file>
+==== verschlüssel mit stunnel ====
+FIXME unfertig.
+Allgemeine Konfigurationsbeispiele siehe Seite von [[software:stunnel4]].
+  - ''syslog-ng'' und ''stunnel4'' installieren
+  - Zertfikate Server und alle Clients erzeugen (Dateinamen anpassen!):
+    - <code>openssl req -new -x509 -nodes -days 1095 -out loghost-server.pem -keyout loghost-server.pem</code>
+    - <code>openssl req -new -x509 -nodes -days 1095 -out client1.pem -keyout client1.pem</code>
+  - Die Zertifikate der Clients in einer einzelnen Datei sammeln und abspeichern: <code>cat *-client.pem > all-clients.pem
+nano all-clients.pem </code> Dabei sollen ''-----BEGIN CERTIFICATE-----'' und ''-----END CERTIFICATE-----'' gelöscht werden.
+  - nach ''/etc/stunnel'' kopieren
+  - die Client-Zertifikate auf die entsprechenden Rechner verteilen
+  - stunnel auf dem Server und auf dem Client konfigurieren:
+    - Server:
+    - Client:
+  - Konfiguration von Syslog-ng:
+    - Server: Am Ende der Konfigurationsdatei ''/etc/syslog-ng/syslog-ng.conf'' anfügen <file>
+destination loghost {tcp("78.47.94.237" port(50515));};
+# destination stunnel {tcp("127.0.0.1" port(514));};
+#
+# log {source(src); destination(loghost);}
+#
+# *.*;auth,authpriv.none          -/var/log/syslog
+log {
+        source(s_all);
+        # filter(f_syslog); #
+        destination(loghost);
+};
+</file>
+    - Client:<file>
+options { long_hostnames(off);
+ sync(0);};
+source src {unix-stream("/dev/log");
+ pipe("/proc/kmsg");
+ internal();};
+destination dest {file("/var/log/messages");};
+destination stunnel {tcp("127.0.0.1" port(514));};
+log {source(src); destination(dest);};
+log {source(src); destination(stunnel);};
+</file>
+===== Fehlerbehandlung =====
+Wenn man an der Konfigurations schraubt muss man aufpassen, dass nach Konfigurationsfehlern am Ende auch syslog-ng wieder läuft. Ein normales <code>/etc/init.d/syslog-ng reload</code> gibt nämlich bei [[debian:Debian]] Etch keinen Muks von sich wenn syslog-ng nicht läuft.
+Einen Patch dafür und wie man ihn anwendet hab ich [[linux:textdateibehandlung#Unterschiede anzeigen / einen Patch anwenden|als Beispiel hinterlegt]]. Wenn man weiter anpasst kann man syslog-ng auch gleich starten lassen.