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:

  1. AKM 8.0 oder höher, erreichbar vom Sensorhost.
  2. Das KMIP-Modul ist lizenziert und aktiviert (bei Nichtverfügbarkeit wenden Sie sich bitte an Townsend Security).
  3. Administratorzugriff auf die AKM-Webkonsole (Standard: https:// :8443).
  4. TCP-Port 5696 ist vom Sensorhost aus erreichbar; überprüfen Sie dies mit nc -zv. 5696.
  5. CBOM-Plattform 2.4 oder höher mit dem Discover_KMIP-Modul.
  6. 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

  1. Gehen Sie zu Konfiguration > KMIP und vergewissern Sie sich, dass der Dienststatus „Wird ausgeführt“ lautet (Dienst starten, falls angehalten).
  2. Bestätigen Sie, dass der Listening-Port 5696 ist.
  3. Stellen Sie die TLS-Version auf mindestens 1.2 ein (1.3 wird empfohlen).
  4. Stellen Sie unter Client-Authentifizierung > Clientzertifikat erforderlich auf Aktiviert (gegenseitiges TLS).
  5. 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.