Townsend Alliance Key Manager (AKM) Integrationsleitfaden
Übersicht
Diese Anleitung konfiguriert den Townsend Alliance Key Manager (AKM) so, dass der CBOM Secure Discover_KMIP-Sensor über Mutual TLS (Port 5696, KMIP 1.2+) eine Verbindung herstellen und verwaltete kryptografische Assets im Nur-Lese-Modus auflisten kann:
- Symmetrische Schlüssel (AES-128, AES-256) werden für SQL Server und Oracle TDE verwendet.
- Asymmetrische Schlüsselpaare (RSA, ECC) im KMIP-Objektspeicher
- Zertifikatsobjekte, die im KMIP-Objektspeicher gespeichert sind
- Wichtige Metadaten: Algorithmus, Länge, Status, Erstellungs-/Änderungsdatum, Namen und benutzerdefinierte Attribute
Alle Verbindungen sind schreibgeschützt – es werden keine Schlüssel oder Schlüsselmaterialien exportiert oder verändert.
Voraussetzungen:
- AKM 8.0 oder höher, erreichbar vom Sensorhost.
- Das KMIP-Modul ist lizenziert und aktiviert (bei Nichtverfügbarkeit wenden Sie sich bitte an Townsend Security).
- Administratorzugriff auf die AKM-Webkonsole (Standard: https:// :8443).
- TCP-Port 5696 ist vom Sensorhost aus erreichbar; überprüfen Sie dies mit nc -zv. 5696.
- CBOM-Plattform 2.4 oder höher mit dem Discover_KMIP-Modul.
- Ein gültiges CBOM-API-Token für die Ergebnisaufnahme.
Schritt-für-Schritt-Anleitung
Schritt 1: KMIP-Audit-Benutzer erstellen
Gehen Sie in der AKM-Konsole zu Sicherheit > Benutzer > Benutzer hinzufügen und erstellen Sie ein dediziertes schreibgeschütztes Konto:
- Benutzername: cbom-kmip-auditor
- Vollständiger Name: CBOM KMIP-Sensor
- Rolle: Schlüsselprüfung (Metadaten nur lesbar; keine Verwendung, kein Export, keine Änderung)
- Aktivieren Sie das Kontrollkästchen „KMIP-Zugriff zulassen“.
Wenn Schlüsselgruppen Schlüssel isolieren, fügen Sie cbom-kmip-auditor der Liste der autorisierten Benutzer jeder betroffenen Gruppe unter Sicherheit > Schlüsselgruppen hinzu.
Schritt 2: KMIP auf Port 5696 aktivieren
- Gehen Sie zu Konfiguration > KMIP und vergewissern Sie sich, dass der Dienststatus „Wird ausgeführt“ lautet (Dienst starten, falls angehalten).
- Bestätigen Sie, dass der Listening-Port 5696 ist.
- Stellen Sie die TLS-Version auf mindestens 1.2 ein (1.3 wird empfohlen).
- Stellen Sie unter Client-Authentifizierung > Clientzertifikat erforderlich auf Aktiviert (gegenseitiges TLS).
- Notieren Sie sich das CA-Zertifikat, das AKM zum Signieren von KMIP-Clientzertifikaten verwendet, und wenden Sie es dann an.
Schritt 3: KMIP-Clientzertifikat herunterladen
Gehen Sie zu Sicherheit > KMIP-Zertifikate > Clientzertifikat mit CN cbom-kmip-sensor, zugehörigem Benutzer cbom-kmip-auditor und einer Gültigkeit von 365 Tagen generieren. Laden Sie die ZIP-Datei (Clientzertifikat, privater Schlüssel, AKM-CA-Zertifikat) herunter und platzieren Sie sie auf dem Sensor-Host.
/etc/cbom/certs/akm/cbom-kmip-sensor.crt /etc/cbom/certs/akm/cbom-kmip-sensor.key /etc/cbom/certs/akm/akm-ca.crt chmod 600 /etc/cbom/certs/akm/cbom-kmip-sensor.key chown cbom-sensor:cbom-sensor /etc/cbom/certs/akm/cbom-kmip-sensor.key
Schritt 4: Konfigurieren Sie den CBOM-Sicherheitssensor
Sensoren: - Name: Discover_KMIP aktiviert: true Zeitplan: "0 */6 * * *" # alle 6 Stunden Typ: KMIP Verbindung: Host: akm.example.com Port: 5696 TLS: aktiviert: true Mindestversion: "TLS1.2" Client-Zertifikat: /etc/cbom/certs/akm/cbom-kmip-sensor.crt Client-Schlüssel: /etc/cbom/certs/akm/cbom-kmip-sensor.key CA-Zertifikat: /etc/cbom/certs/akm/akm-ca.crt Server verifizieren: true Authentifizierung: Benutzername: cbom-kmip-auditor Passwort: "${AKM_KMIP_PASSWORD}" Erkennung: Objekttypen: [SymmetricKey, PublicKey, PrivateKey, Certificate] Status: [PreActive, Active, Deactivated, Compromised] Maximale Anzahl Objekte: 10000 cbom_Backend: api_endpoint: https://cbom.example.com/api/v1/ingest api_token: "${CBOM_API_TOKEN}" asset_source_label: akm-production
Hinweis: Speichern Sie Passwörter oder API-Token niemals im Klartext. Verwenden Sie stattdessen die Umgebungsvariable ${} oder einen Geheimnismanager.
Schritt 5: Validieren
openssl s_client -connect akm.example.com:5696 \ -cert /etc/cbom/certs/akm/cbom-kmip-sensor.crt \ -key /etc/cbom/certs/akm/cbom-kmip-sensor.key \ -CAfile /etc/cbom/certs/akm/akm-ca.crt -verify_return_error cbom-sensor run --sensor Discover_KMIP --dry-run cbom-sensor run --sensor Discover_KMIP
Ein Handshake, der den Rückgabewert 0 (OK) für die Überprüfung zurückgibt, sowie eine Testobjektliste bestätigen die Einrichtung. Filtern Sie anschließend unter „Assets > Kryptografische Schlüssel“ nach „Quelle: akm-production“.
Häufige Fehler
TLS-Handshake fehlgeschlagen – Zertifikat von unbekannter Zertifizierungsstelle signiert
Ursache: Das AKM CA-Zertifikat fehlt oder ist im Feld ca_cert fehlerhaft.
Lösung: Laden Sie die Zertifizierungsstelle erneut herunter unter Konfiguration > KMIP > CA-Zertifikat herunterladen, überprüfen Sie das PEM-Format und starten Sie den Sensor neu.
KMIP nicht autorisiert – Zugriff verweigert
Ursache: cbom-kmip-auditor hat keinen KMIP-Zugriff, ein falsches Passwort oder ist nicht in den relevanten Schlüsselgruppen.
Lösung: Bestätigen Sie den KMIP-Zugriff und die Rolle „Schlüsselprüfung“, fügen Sie den Benutzer jeder Schlüsselgruppe hinzu und überprüfen Sie das Passwort erneut.
Verbindung zu Port 5696 verweigert
Ursache: Der KMIP-Dienst ist beendet oder eine Firewall blockiert Port 5696.
Lösung: Starten Sie den Dienst, testen Sie ihn mit nc -zv, öffnen Sie TCP 5696 und bestätigen Sie den Listener mit ss -tlnp | grep 5696.
Sicherheitsempfehlungen
- Verwenden Sie das Konto cbom-kmip-auditor ausschließlich für den Sensor.
- Das KMIP-Clientzertifikat sollte jährlich erneuert werden – abgelaufene Zertifikate führen zu unbemerkten Fehlern.
- Das AKM-Passwort und das CBOM-Token sollten über einen Secrets Manager und niemals im Klartext-YAML-Format eingegeben werden.
- Beschränken Sie den privaten Schlüssel des Clients auf das Sensordienstkonto (chmod 600).
- Aktivieren Sie die AKM KMIP-Audit-Protokollierung, damit Sensormesswerte zur Überprüfung der Compliance aufgezeichnet werden.
Fazit
Mit einem Key Audit-Benutzer, gegenseitigem TLS auf Port 5696 und schreibgeschützten Locate/Get Attributes-Operationen inventarisiert der Discover_KMIP-Sensor kontinuierlich alle KMIP-verwalteten Objekte in Townsend AKM – einschließlich SQL Server- und Oracle TDE-Schlüssel – ohne dabei Schlüsselmaterial zu modifizieren oder zu exportieren.
