Osquery: Unterschied zwischen den Versionen

Aus Xinux Wiki
Zur Navigation springen Zur Suche springen
 
(6 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 90: Zeile 90:
  
  
= FleetDM mit Docker Compose (stabiles Setup) =
+
= FleetDM mit Docker Compose =
 
+
*[[Architektur Fleet + osquery]]
== Voraussetzungen ==
+
==Install the fleetctl command line tool==
* Debian 12 mit installiertem Docker & Docker Compose
+
*curl -sSL https://fleetdm.com/resources/install-fleetctl.sh | bash
* osquery soll zentral über Fleet verwaltet werden
+
==Run a local demo of the Fleet server==
 
+
*~/.fleetctl/fleetctl preview
== Vorbereitung ==
+
==The Fleet UI is now available==
Lege ein neues Verzeichnis an und wechsle hinein:
+
*http://localhost:1337
* mkdir fleet-quickstart
+
*Email: admin@example.com
* cd fleet-quickstart
+
*Password: preview1337#
 
+
==Erster Query==
Erstelle eine Datei namens docker-compose.yml mit folgendem Inhalt:
+
*Queries
<pre>
+
**Add query
version: "3.7"
+
***Query: SELECT * FROM crontab;
 
+
**Save
services:
+
*Run query
  mysql:
+
**Select target host: verwaltung.it113.int
    image: mysql:8.0
+
**Run
    environment:
+
*Ergebnisse prüfen
      MYSQL_ROOT_PASSWORD: fleetpass
 
      MYSQL_DATABASE: fleet
 
    volumes:
 
      - mysql-data:/var/lib/mysql
 
    restart: unless-stopped
 
 
 
  redis:
 
    image: redis:6.2
 
    restart: unless-stopped
 
 
 
  fleet:
 
    image: fleetdm/fleet:v4.45.0
 
    depends_on:
 
      - mysql
 
      - redis
 
    ports:
 
      - "8080:8080"
 
    environment:
 
      - FLEET_MYSQL_USERNAME=root
 
      - FLEET_MYSQL_PASSWORD=fleetpass
 
      - FLEET_MYSQL_DATABASE=fleet
 
      - FLEET_MYSQL_ADDRESS=mysql:3306
 
      - FLEET_REDIS_ADDRESS=redis:6379
 
    command: >
 
      sh -c "
 
      fleet prepare db &&
 
      fleet serve
 
      "
 
    restart: unless-stopped
 
 
 
volumes:
 
  mysql-data:
 
</pre>
 
 
 
== Start ==
 
Startet die Umgebung:
 
* docker compose up -d
 
 
 
== Web-Oberfläche aufrufen ==
 
* http://localhost:8080
 
 
 
Beim ersten Start:
 
* Admin-Benutzer, Passwort und Organisation anlegen
 
 
 
== Hinweise ==
 
* Keine Kompilierung notwendig
 
* Kein make, kein node, kein bazel
 
* Datenbank wird automatisch initialisiert
 
* Umgebung ist sofort einsatzbereit
 
 
 
== Weitere Schritte ==
 
* osquery-Clients mit Fleet verbinden
 
* Queries und Policies definieren
 
* Live-Abfragen ausführen
 

Aktuelle Version vom 20. April 2025, 10:00 Uhr

Einführung

osquery ist ein Framework zur sicherheitsrelevanten Systemüberwachung. Es stellt Betriebssystemdaten als SQL-Tabellen dar. So können Dateien, Prozesse, Nutzer, Netzwerke und Konfigurationen abgefragt werden.

Ursprünglich von Facebook entwickelt, eignet sich osquery für forensische Analysen, Security Monitoring und Integritätsprüfungen.

Architektur

Die Anwendung besteht aus zwei Komponenten:

+-------------------+
|   osqueryi Shell  | <-- Interaktive SQL-Abfragen
+-------------------+
          |
          v
+-------------------+
|     osqueryd      | <-- Daemon für geplante Abfragen
+-------------------+
          |
          v
+-------------------+
|   Systemtabellen  | <-- z.B. processes, users, etc.
+-------------------+

Installation unter Debian 12

Von der Webseite neuste Version runterladen und installieren.

https://osquery.io/downloads/official/5.16.0

Konfiguration

Kopiert die Beispielkonfiguration

  • cp /opt/osquery/share/osquery/osquery.example.conf /etc/osquery/osquery.conf

Dienst starten

Startet den osquery-Dienst

  • systemctl start osqueryd

Prüft den Dienststatus

  • systemctl status osqueryd
 ● osqueryd.service - The osquery Daemon
   Loaded: loaded (/lib/systemd/system/osqueryd.service; enabled)
   Active: active (running)

Interaktive Nutzung mit osqueryi

Startet die interaktive Shell

  • osqueryi

Beispielabfragen:

Zeigt aktuell eingeloggte Benutzer

  • SELECT * FROM logged_in_users;

Zeigt laufende Prozesse von root

  • SELECT name, pid FROM processes WHERE uid = 0;

Zeigt alle Cronjobs

  • SELECT * FROM crontab;

Zeigt alle offenen Netzwerkports

  • SELECT * FROM listening_ports;

Eigene Regeln über Queries konfigurieren

Bearbeitet die zentrale Konfigurationsdatei vi /etc/osquery/osquery.conf

Beispielkonfiguration:

{
  "schedule": {
    "users_check": {
      "query": "SELECT * FROM users;",
      "interval": 600
    },
    "passwd_check": {
      "query": "SELECT * FROM file WHERE path = '/etc/passwd';",
      "interval": 300
    }
  }
}

Aktualisiert osquery nach Konfig-Änderungen

  • systemctl restart osqueryd


FleetDM mit Docker Compose

Install the fleetctl command line tool

Run a local demo of the Fleet server

  • ~/.fleetctl/fleetctl preview

The Fleet UI is now available

Erster Query

  • Queries
    • Add query
      • Query: SELECT * FROM crontab;
    • Save
  • Run query
    • Select target host: verwaltung.it113.int
    • Run
  • Ergebnisse prüfen