DNSFilter-Logs erfassen
Parserversion: 1.0
In diesem Dokument wird beschrieben, wie Sie DNSFilter so konfigurieren, dass Logs über Webhooks mit dem HEC-Protokoll (HTTP Event Collector) an Google Security Operations gesendet werden.
DNSFilter ist eine KI-basierte DNS-Sicherheitslösung, die Bedrohungsschutz, Inhaltsfilterung und Netzwerktransparenz bietet. Mit der Funktion „Datenexport“ können DNS-Abfrageprotokolldaten über die HTTP Event Collector (HEC) API automatisch in SIEM-Plattformen exportiert werden. Dies unterstützt das Sicherheitsmonitoring in Echtzeit und die Compliance-Berichterstellung.
Hinweis
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Zugriff auf das DNSFilter-Dashboard mit Administratorberechtigungen oder höher
- Das Add-on DNSFilter Data Export ist aktiviert (für Basic-, Pro- und Enterprise-Abos als kostenpflichtiges Add-on verfügbar).
- Zugriff auf die Google Cloud Console (zum Erstellen von API-Schlüsseln)
Webhook-Feed in Google SecOps erstellen
Feed erstellen
- Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Klicken Sie auf Neuen Feed hinzufügen.
- Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B.
DNSFilter HEC Feed. - Wählen Sie Webhook als Quelltyp aus.
- Wählen Sie DNSFILTER als Logtyp aus.
- Klicken Sie auf Weiter.
- Geben Sie Werte für die folgenden Eingabeparameter an:
- Trennzeichen für Aufteilung (optional): Lassen Sie dieses Feld leer, da jede HEC-Anfrage korrekt formatierte Ereignisse enthält.
- Asset-Namespace: Der Asset-Namespace
- Labels für Datenaufnahme: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
- Klicken Sie auf Weiter.
- Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.
Secret-Schlüssel generieren und speichern
Nachdem Sie den Feed erstellt haben, müssen Sie einen Secret-Schlüssel für die Authentifizierung generieren:
- Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
- In einem Dialogfeld wird der geheime Schlüssel angezeigt.
Kopieren und speichern Sie den geheimen Schlüssel an einem sicheren Ort.
Feed-Endpunkt-URL abrufen
- Gehen Sie zum Tab Details des Feeds.
- Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
Das URL-Format lautet:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importDabei ist
{region}die Region Ihrer Google SecOps-Instanz (z. B.us,europeoderasia-southeast1) und{parent}der Ressourcenpfad im Formatprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Speichern Sie diese URL für die nächsten Schritte.
Klicken Sie auf Fertig.
Google Cloud API-Schlüssel erstellen
Google SecOps erfordert einen API-Schlüssel für die Authentifizierung. Erstellen Sie in der Google Cloud Console einen eingeschränkten API-Schlüssel.
API-Schlüssel erstellen
- Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
- Wählen Sie Ihr Projekt aus (das Projekt, das mit Ihrer Google SecOps-Instanz verknüpft ist).
- Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
- Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
- Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.
API-Schlüssel einschränken
- Auf der Seite mit den Einstellungen für den API-Schlüssel:
Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
Google SecOps DNSFilter Webhook API Key). - Gehen Sie unter API-Einschränkungen so vor:
- Wählen Sie Schlüssel einschränken aus.
- Suchen Sie im Drop-down-Menü APIs auswählen nach der Google SecOps API (oder Chronicle API) und wählen Sie sie aus.
- Klicken Sie auf Speichern.
- Kopieren Sie den Wert des API-Schlüssels aus dem Feld API-Schlüssel oben auf der Seite.
Speichern Sie den API-Schlüssel an einem sicheren Ort.
DNSFilter-Datenexport konfigurieren
HEC-Endpunkt-URL erstellen
Kombinieren Sie die Google SecOps-Endpunkt-URL und den API-Schlüssel, um die HEC-URL zu erstellen:
<ENDPOINT_URL>?key=<API_KEY>Beispiel:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...
Datenexport in DNSFilter konfigurieren
- Melden Sie sich im DNSFilter-Dashboard an.
- Gehen Sie zu Tools > Datenexport.
- Wählen Sie im Abschnitt Exportziel die Option HTTP Event Collector (HEC) aus.
- Geben Sie im Abschnitt HEC-Konfiguration Folgendes ein:
- HTTP Event Collector URL: Fügen Sie die vollständige Endpunkt-URL mit dem API-Schlüssel aus dem vorherigen Schritt ein.
- Aktives Event Collector-Token: Fügen Sie den geheimen Schlüssel ein, der beim Erstellen des Google SecOps-Feeds generiert wurde.
- Klicken Sie auf Konfiguration speichern.
DNSFilter testet die Verbindung und zeigt eine Erfolgsmeldung an, wenn die Konfiguration korrekt ist.
Datenaufnahme prüfen
- Rufen Sie im DNSFilter-Dashboard Tools > Datenexport auf.
- Prüfen Sie, ob der Status als Aktiv oder Verbunden angezeigt wird.
- Rufen Sie in Google SecOps die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Suchen Sie Ihren DNSFilter-Feed und prüfen Sie, ob der Status als Aktiv angezeigt wird.
- Klicken Sie auf den Namen des Feeds, um die Details aufzurufen.
- Prüfen Sie den Messwert Aufgenommene Logs, um zu bestätigen, dass Daten fließen.
Wenn Sie nach DNSFilter-Ereignissen suchen möchten, rufen Sie Suchen auf und führen Sie die folgende Abfrage aus:
metadata.log_type = "DNSFILTER"
Referenz zu Authentifizierungsmethoden
Google SecOps-Webhook-Feeds unterstützen mehrere Authentifizierungsmethoden. Bei der DNSFilter-HEC-Integration wird die Hybridmethode verwendet.
Verwendete Methode: Hybrid (URL + Header)
DNSFilter sendet den API-Schlüssel in der URL und den geheimen Schlüssel (HEC-Token) im Anfrageheader.
Anfrageformat:
POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1 Content-Type: application/json Authorization: Splunk <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Alternative Methode: Benutzerdefinierte Header
Wenn Sie eine benutzerdefinierte Anwendung so konfigurieren, dass Logs an Google SecOps gesendet werden, verwenden Sie diese Methode, um die Sicherheit zu erhöhen.
Anfrageformat:
POST <ENDPOINT_URL> HTTP/1.1 Content-Type: application/json x-goog-chronicle-auth: <API_KEY> x-chronicle-auth: <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }Vorteile:
- API-Schlüssel und Secret sind in der URL nicht sichtbar.
- Sicherer (Header werden nicht in Webserver-Zugriffslogs protokolliert)
- Bevorzugte Methode, wenn der Anbieter sie unterstützt
Namen der Authentifizierungsheader
Google SecOps akzeptiert die folgenden Headernamen für die Authentifizierung:
Für API-Schlüssel:
x-goog-chronicle-auth(empfohlen)X-Goog-Chronicle-Auth(Groß-/Kleinschreibung wird nicht berücksichtigt)
Für den geheimen Schlüssel:
x-chronicle-auth(empfohlen)X-Chronicle-Auth(Groß-/Kleinschreibung wird nicht berücksichtigt)Authorization: Splunk <TOKEN>(HEC-Kompatibilität)
Webhook-Limits und Best Practices
Anfragelimits
| Limit | Wert |
|---|---|
| Maximale Anfragegröße | 4 MB |
| Maximale Abfragen pro Sekunde | 15.000 |
| Zeitlimit für Anfragen | 30 Sekunden |
| Wiederholungsverhalten | Automatisch mit exponentiellem Backoff |
Best Practices
- Exportstatus überwachen: Prüfen Sie regelmäßig den Status des Datenexports im DNSFilter-Dashboard, um einen kontinuierlichen Datenfluss zu gewährleisten.
- API-Schlüsselrotation: Rotieren Sie Ihren Google Cloud API-Schlüssel regelmäßig, um die Sicherheit zu erhöhen.
- Verwaltung des geheimen Schlüssels: Speichern Sie den geheimen Google SecOps-Schlüssel sicher und generieren Sie ihn neu, wenn er manipuliert wurde.
- Datenaufbewahrung: Konfigurieren Sie sowohl in DNSFilter als auch in Google SecOps geeignete Richtlinien zur Datenaufbewahrung.
- Benachrichtigungskonfiguration: Richten Sie in Google SecOps Benachrichtigungen für kritische DNS-Sicherheitsereignisse ein.
Fehlerbehebung
Verbindungstest schlägt fehl
Wenn der Konfigurationstest für den DNSFilter-Datenexport fehlschlägt, gehen Sie so vor:
- Prüfen Sie, ob die HEC-URL korrekt ist und den API-Schlüsselparameter enthält.
- Prüfen Sie, ob der geheime Schlüssel (HEC-Token) korrekt und ohne zusätzliche Leerzeichen kopiert wurde.
- Prüfen Sie, ob für den Google Cloud API-Schlüssel der Zugriff auf die Chronicle API aktiviert ist.
- Prüfen Sie, ob der Google SecOps-Feed den Status Aktiv hat.
- Prüfen Sie die Netzwerkverbindung von DNSFilter zu Google Cloud -Endpunkten.
In Google SecOps werden keine Daten angezeigt
Wenn die Verbindung hergestellt wird, aber keine Daten angezeigt werden:
- Prüfen Sie, ob in Ihrer DNSFilter-Bereitstellung DNS-Abfragen generiert werden.
- Prüfen Sie im DNSFilter-Abfragelog, ob der Traffic verarbeitet wird.
- Suchen Sie in Google SecOps nach
metadata.log_type = "DNSFILTER", um die Aufnahme zu prüfen. - Prüfen Sie den Messwert Aufgenommene Logs des Feeds in Google SecOps.
- Prüfen Sie die Fehlerprotokolle des Feeds auf Aufnahmefehler.
Datenexport gibt Fehlermeldung zurück
Häufige Fehlerursachen:
- Ungültige Anmeldedaten: Der API-Schlüssel oder der Secret Key ist falsch oder abgelaufen.
- Falsche Region: Die Region der Google SecOps-Endpunkt-URL stimmt nicht mit Ihrer Instanz überein.
- Berechtigungen: Für den API-Schlüssel ist der Zugriff auf die Chronicle API nicht aktiviert.
- Netzwerkprobleme: Firewall oder Proxy blockiert ausgehende HTTPS-Verbindungen.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
| Zeit | metadata.collected_timestamp | Konvertiert mit dem Datumsformat: JJJJ-MM-TT HH:mm:ss Z UTC |
| metadata.event_type | Wird auf „STATUS_UPDATE“ gesetzt, wenn „principal_ip_present“, „principal_hostname_present“ oder „principal_mac_present“ „true“ ist, andernfalls auf „GENERIC_EVENT“ | |
| question_type | network.dns.questions | „question_type“ wurde mithilfe der DNS-Eintragstypzuordnung in „question.type“ konvertiert und dann in ein Array zusammengeführt |
| Code | network.dns.response_code | Konvertiert mithilfe der DNS-Antwortcodezuordnung |
| Protokoll | network.ip_protocol | Mit IP-Protokollzuordnung konvertiert |
| Client | principal.hostname | Wert direkt kopiert |
| request_address, ip4, ip6, source_addresses | principal.ip | Zusammengeführt aus request_address (extrahierte IP), ip4 (extrahierte IP), ip6 (extrahierte IP) und IPs, die aus dem Array source_addresses extrahiert wurden |
| Region | principal.location.country_or_region | Wert direkt kopiert |
| clientMac | principal.mac | Wert wird direkt kopiert, wenn er mit dem MAC-Regex übereinstimmt |
| clientID | principal.resource.product_object_id | Wert direkt kopiert |
| Nutzername | principal.user.user_display_name | Wert direkt kopiert |
| user_id | principal.user.userid | Wert direkt kopiert |
| code, original_code, clientType, collection, network_name, networkID, collectionID, policy, policyID, scheduled_policy, scheduled_policyID, sec_cats, sec_allow_cats, block_cats, block_allow_cats, threat, allowed, method, organization, organizationID, applicationID, application_name, application_categoryID, application_category_name | security_result.detection_fields | Zusammengeführte Labels aus verschiedenen Quellfeldern als Schlüssel/Wert-Paare |
| Domain | target.administrative_domain | Wert direkt kopiert |
| fqdn | target.domain.name | Wert direkt kopiert |
| metadata.product_name | Legen Sie diesen Wert auf „DNSFILTER“ fest. | |
| metadata.vendor_name | Legen Sie diesen Wert auf „DNSFILTER“ fest. |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten