kcatcher

Fang, was in deinen Kafka-Clustern lauert.

Einführung

Kcatcher ist ein Befehlszeilentool zum Enumerieren und Bewerten von Kafka-Cluster-Konfigurationen. Es verbindet sich mit Apache-Kafka-Clustern, ruft detaillierte Informationen über Broker, Topics und ACLs ab und entnimmt sogar Nachrichten-Stichproben. Perfekt für Sicherheitsaudits, Infrastrukturbewertungen oder einfach um zu verstehen, was in deiner Kafka-Umgebung läuft.

Demo

Installation

Go

Wenn du eine funktionierende Go-Umgebung hast, kannst du es mit folgendem Befehl installieren:

go install github.com/RoseSecurity/kcatcher@latest

Apt

Um Pakete zu installieren, kannst du das Repository schnell automatisch einrichten:

curl -1sLf \
  'https://dl.cloudsmith.io/public/rosesecurity/kcatcher/setup.deb.sh' \
  | sudo -E bash

Sobald das Repository konfiguriert ist, kannst du die Installation mit folgendem Befehl durchführen:

apt install kcatcher

Quellcode

git clone [email protected]:RoseSecurity/kcatcher.git
cd kcatcher
make build

Verwendung

Grundlegende Enumeration

Stelle eine Verbindung zu einem Kafka-Cluster her und rufe Broker- und Topic-Metadaten ab:

kcatcher -b kafka-broker-1,kafka-broker-2

Benutzerdefinierter Port

Gib einen nicht standardmäßigen Kafka-Port an:

kcatcher -b kafka-broker-1 -p 9093

ACL-Enumeration

Rufe die auf dem Cluster konfigurierten Zugriffskontrolllisten ab:

kcatcher -b kafka-broker-1 --acls

Nachrichten-Sampling

Ziehe Stichproben aus aktuellen Nachrichten eines bestimmten Topics:

kcatcher -b kafka-broker-1 --sample-topic my-topic --sample-count 5

JSON-Ausgabe

Gib die Ergebnisse im JSON-Format für die weitere Verarbeitung aus:

kcatcher -b kafka-broker-1 --acls -o json

Konfigurations-Enumeration

Rufe Broker- und Topic-Konfigurationen ab:

kcatcher -b kafka-broker-1 --configs

Sicherheitsanalyse

Führe eine umfassende Sicherheitsanalyse deines Kafka-Clusters durch:

kcatcher -b kafka-broker-1 --analyze

Kombiniere dies mit der ACL- und Konfigurations-Enumeration für eine vollständige Bewertung:

kcatcher -b kafka-broker-1 --acls --configs --analyze

Die Sicherheitsanalyse bewertet deinen Cluster anhand von 20 integrierten Sicherheitsregeln in fünf Kategorien: Authentifizierung, Autorisierung, Verschlüsselung, Zugriffskontrolle und Konfiguration. Die Ergebnisse umfassen einen Sicherheits-Score (0-100), eine Buchstabenbewertung und detaillierte Befunde mit Empfehlungen zur Behebung.

Optionen

Referenz der Sicherheitsregeln

Die Sicherheitsanalyse-Engine bewertet deinen Kafka-Cluster anhand der folgenden Regeln:

Authentifizierung

Autorisierung

Verschlüsselung

Zugriffskontrolle (ACLs)

Konfiguration

Sicherheits-Score

Die Analyse erzeugt einen Sicherheits-Score von 0-100 und eine Buchstabenbewertung:

Mitwirken

Für Fehlerberichte & Feature-Anfragen nutze bitte den Issue-Tracker.

Pull-Requests sind willkommen! Wir folgen dem typischen "Fork-and-Pull"-Git-Workflow.

1. Forke das Repository auf GitHub
2. Klone das Projekt auf deinen eigenen Rechner
3. Committe die Änderungen auf deinen eigenen Branch
4. Pushe deine Arbeit zurück zu deinem Fork
5. Reiche einen Pull-Request ein, damit wir deine Änderungen überprüfen können

[!TIP] Stelle sicher, dass du die neuesten Änderungen von "upstream" übernimmst, bevor du einen Pull-Request erstellst!

Vielen Dank an unsere Mitwirkenden