Überblick
Wirespeed verbindet sich über ein Konto-API-Token mit Cloudflare und kann damit:- Access-Authentifizierungsprotokolle erfassen: jede erlaubte und abgelehnte Anmeldung bei einer durch Cloudflare Access geschützten Anwendung, einschließlich Anmeldungen über WARP
- Audit-Protokolle des Kontos erfassen: Änderungen an Mitgliedern, Einstellungen und Konfiguration, die im Cloudflare-Dashboard oder über die API vorgenommen wurden
- Gateway-DNS-, HTTP- und Netzwerkprotokolle, Zero-Trust-Netzwerksitzungen, Ein-/Ausschaltvorgänge und Konfigurationsänderungen von WARP sowie Firewall-Ereignisse von Zonen aus Cloudflare Logpush empfangen
- Zero-Trust-Benutzer synchronisieren, damit sie Ziel von Eindämmungsmaßnahmen sein können
- Access-Sitzungen eines kompromittierten Benutzers widerrufen, einschließlich seiner registrierten Geräte und seiner WARP-Sitzung
Während der Beta-Phase werden Cloudflare-Ereignisse nur für Suche und Korrelation erfasst. Sie lösen noch keine Detektionen aus.
Voraussetzungen
Halten Sie Folgendes bereit, bevor Sie Cloudflare in Wirespeed verbinden:- Ihre Cloudflare-Account ID
- Ein Cloudflare-API-Token mit den unten aufgeführten Berechtigungen
API-Token erstellen
- Öffnen Sie im Cloudflare-Dashboard Manage Account > Account API Tokens. Alternativ können Sie unter My Profile > API Tokens ein Benutzer-Token erstellen.
- Wählen Sie Create Token und anschließend Create Custom Token.
- Fügen Sie diese Account-Berechtigungen hinzu:
- Optional: Um Firewall-Ereignisse zu erfassen, fügen Sie zusätzlich diese Zone-Berechtigungen hinzu:
- Wählen Sie unter Account Resources nur das Konto aus, das Sie verbinden. Wenn Sie Zonenberechtigungen hinzugefügt haben, setzen Sie Zone Resources auf All zones from an account und wählen Sie dasselbe Konto aus.
- Erstellen Sie das Token und kopieren Sie es. Cloudflare zeigt das Token nur einmal an.
Account ID ermitteln
Öffnen Sie das Konto im Cloudflare-Dashboard. Die 32-stellige Account ID steht auf der Startseite des Kontos und in der Dashboard-URL (https://dash.cloudflare.com/<account-id>/...).
Cloudflare in Wirespeed verbinden
- Gehen Sie in Wirespeed zu Integrationen > Integration hinzufügen.
- Wählen Sie Cloudflare Zero Trust aus.
- Geben Sie Ihre Account ID und Ihr API-Token ein.
- Optional: Aktivieren Sie in den erweiterten Optionen Schreibgeschützt, um das Widerrufen von Sitzungen zu verhindern.
- Speichern Sie die Integration.
Validierung
Wenn Sie die Integration speichern, ruft Wirespeed einen Eintrag aus dem Access-Authentifizierungsprotokoll ab. Die Verbindung schlägt fehl, wenn das Token ungültig ist, zu einem anderen Konto gehört oder Access: Audit Logs Read fehlt. Nachdem die Integration aktiviert wurde, prüft Wirespeed jede protokollbezogene Berechtigung und zeigt das Ergebnis auf der Integrationsseite an:
Die Berechtigung zum Widerrufen von Sitzungen lässt sich nicht prüfen, ohne einen Benutzer zu widerrufen. Fehlt sie, schlägt der Widerruf fehl und der Fehler erscheint in den Integrationsprotokollen.
Protokollerfassung
Wirespeed fragt Access-Authentifizierungsprotokolle und Audit-Protokolle des Kontos nach einem Zeitplan ab und speichert nach jeder Seite seine Position. Nach einem Neustart oder Ausfall wird die Erfassung daher dort fortgesetzt, wo sie unterbrochen wurde, statt von vorn zu beginnen. Die erste Synchronisierung erfasst die vergangenen 7 Tage. Jede Abfrage liest die letzten 10 Minuten erneut, um Ereignisse zu erfassen, die Cloudflare verspätet indiziert, und überspringt bereits erfasste Ereignisse. Bricht die Erfassung ab, nachdem eine Seite erfasst, aber bevor ihre Position gespeichert wurde, kann diese Seite erneut erfasst werden.Logpush-Protokolle
Cloudflare exportiert Gateway-, Zero-Trust-Netzwerksitzungs-, WARP-Änderungs- und Firewall-Ereignisprotokolle ausschließlich über Logpush. Wirespeed empfängt sie über ein Logpush-HTTP-Ziel: Ein Logpush-Job pro Datensatz sendet an die Webhook-URL Ihrer Integration. Firewall-Ereignisse gehören zu einer Zone und nicht zum Konto, daher ist pro Zone ein eigener Job nötig.Automatische Einrichtung
Wenn das API-Token Logs: Edit und Zero Trust: PII Read besitzt, erstellt Wirespeed bei jeder Aktivierung der Integration einen Job pro Datensatz. Die Jobs heißenwirespeed-<dataset> (zum Beispiel wirespeed-gateway_dns) und verwenden die Einstellungen aus Logpush manuell einrichten.
- Wenn für diese Integration bereits ein Job existiert, aktualisiert Wirespeed ihn einschließlich seines Ziels, statt ein Duplikat anzulegen. Ein neu generiertes Webhook-Secret wird also wirksam, wenn Sie die Integration erneut aktivieren.
- Cloudflare bietet jeden Datensatz nur in Tarifen an, die ihn enthalten. Datensätze außerhalb des Tarifs werden übersprungen, und ihre Logpush-Berechtigung bleibt ausgeschaltet. Bei jeder Aktivierung der Integration führen die Integrationsprotokolle in einer Zeile auf, welche Datensätze gesendet werden und welche nicht im Tarif enthalten sind.
- Schlägt ein Datensatz aus einem anderen Grund fehl, erscheint der Fehler in den Integrationsprotokollen, und die übrigen Datensätze werden trotzdem eingerichtet.
- Fehlt dem Token eine der beiden Berechtigungen, zeigt die Berechtigung Logpush-Einrichtung eine Warnung an, und die Integration wird ohne die Jobs aktiviert. Die Integrationsprotokolle nennen die fehlende Berechtigung und enthalten den Fehler von Cloudflare. Ein fehlendes Zero Trust: PII Read meldet Cloudflare als
reading job for product '<product>' is not allowed (1004). - Für
firewall_eventslistet Wirespeed die Zonen des Kontos auf und erstellt in jeder Enterprise-Zone einen Jobwirespeed-firewall_events. Zonen mit anderen Tarifen werden übersprungen. Die Zusammenfassungszeile zeigt, wie viele Zonen senden, zum Beispielfirewall_events (2 of 5 zones). Später hinzugefügte Zonen werden bei der nächsten Aktivierung der Integration berücksichtigt. - Beim Deaktivieren oder Löschen der Integration werden die Jobs
wirespeed-*gelöscht, deren Ziel diese Integration ist. Andere Logpush-Jobs ändert oder löscht Wirespeed nie.
Logpush manuell einrichten
Gehen Sie so vor, wenn das Token Logs: Edit und Zero Trust: PII Read nicht besitzt oder wenn Sie die Jobs selbst verwalten möchten.Webhook-URL und Secret abrufen
- Öffnen Sie in Wirespeed die Integration Cloudflare Zero Trust und wählen Sie Webhook-Details.
-
Kopieren Sie die Webhook-URL für Logpush-Protokolle empfangen. Sie sieht so aus:
-
Kopieren Sie das Webhook-Secret. Wirespeed lehnt Logpush-Anfragen ab, die es nicht als
Authorization: Bearer <WEBHOOK_SECRET>senden.
Ziel zusammensetzen
Logpush wandelt jeden Parameterheader_* in der Ziel-URL in einen Anfrage-Header um und belässt die übrigen Parameter in der URL. Hängen Sie zwei Parameter an die Webhook-URL an:
dataset=<DATASET>: einer der Datensatznamen aus der Tabelle oben. Er teilt Wirespeed mit, in welche Tabelle die Protokolle gehörenheader_Authorization=Bearer%20<WEBHOOK_SECRET>: sendet das Secret. Behalten Sie das URL-codierte Leerzeichen%20bei.
destination_conf:
destination_conf mit dem passenden dataset.
Logpush-Jobs erstellen
Erstellen Sie die Jobs über die Cloudflare-API mit einem Token, das die Kontoberechtigungen Logs: Edit (Logs Write) und Zero Trust: PII Read besitzt. Das API-Token der Integration selbst benötigt sie nicht. Logpush validiert das Ziel beim Erstellen des Jobs, indem es eine Testdatei hochlädt. Wirespeed muss also erreichbar und das Secret korrekt sein, sonst schlägt das Erstellen des Jobs fehl.
name in wirespeed-<dataset> und passen Sie dataset, den Parameter dataset in destination_conf sowie field_names an.
max_upload_bytes: Setzen Sie den Wert auf5000000(5 MB unkomprimierte Protokolle, die kleinste Batchgröße, die Logpush zulässt). Wirespeed akzeptiert Lieferungen von bis zu 5 MiB im komprimierten Zustand, sodass ein Batch von höchstens 5 MB unkomprimiert immer passt. Logpush erlaubt fürmax_upload_bytesWerte bis 1 GB, Wirespeed lehnt größere Lieferungen jedoch mit413ab und protokolliert eine Warnung in den Integrationsprotokollen. Behalten Sie daher5000000bei. Die Jobs, die Wirespeed automatisch erstellt, verwenden diesen Wert bereits. Wirespeed stellt jede Lieferung so, wie sie eingeht, noch komprimiert in eine Warteschlange und übergibt sie als Ganzes an seine Protokoll-Pipeline, die sie entpackt und jeden Datensatz speichert. Schlägt diese Übergabe fehl, wiederholt Wirespeed den gesamten Batch, und eine von Cloudflare erneut gesendete Lieferung wird nur einmal gespeichert.timestamp_format: Über die API erstellte Jobs verwenden standardmäßigunixnano. Wirespeed liest jedes Format,rfc3339ist in der Suche aber besser lesbar.field_names: Logpush sendet nur die aufgeführten Felder. Verwenden Sie die vollständigen Listen unten, damit Wirespeed alle Felder erhält.
destination_conf als Endpunkt ein. Wählen Sie alle Felder des Datensatzes aus. Das Dashboard setzt max_upload_bytes nicht. Setzen Sie den Wert daher anschließend über die API update job. Dieser Aufruf ersetzt output_options vollständig, geben Sie die Optionen also erneut an.
Feldlisten
Kopieren Sie die Liste für jeden Job inoutput_options.field_names. Veraltete Felder sind nicht enthalten.
gateway_dns
gateway_http
gateway_network
zero_trust_network_sessions
warp_toggle_changes
warp_config_changes
firewall_events
Benutzersynchronisierung
Wirespeed synchronisiert Ihre Zero-Trust-Benutzer über die Cloudflare-API users, sodass sie als Verzeichnisbenutzer erscheinen und Ziel von Access-Sitzungen widerrufen sein können. Die Synchronisierung verwendet die Berechtigung Access: Audit Logs Read und benötigt nichts weiter. Cloudflare nimmt einen Benutzer in diese Liste auf, sobald er sich zum ersten Mal authentifiziert, indem er sich bei einer Access-Anwendung anmeldet oder ein WARP-Gerät verbindet. Benutzer, die in Ihrem Identitätsanbieter existieren, einschließlich per SCIM bereitgestellter Benutzer, sich aber noch nie authentifiziert haben, werden nicht aufgeführt. Sie haben keine Access- oder WARP-Sitzung, die widerrufen werden könnte. Wirespeed ordnet synchronisierte Benutzer anhand der E-Mail-Adresse derselben Person in Ihren anderen Identitätsintegrationen zu. Wird ein Benutzer auch aus einem Identitätsanbieter wie Okta synchronisiert, führt Wirespeed jede Behebungsmaßnahme über genau einen Anbieter aus. Widerrufen Sie die Cloudflare-Sitzungen des Benutzers daher über den Cloudflare-Verzeichnisbenutzer, wenn auch seine Access- und WARP-Sitzungen beendet werden müssen.Widerruf von Sitzungen
Access-Sitzungen widerrufen ruft die Cloudflare-API revoke user mit der E-Mail-Adresse des Benutzers auf und, sofern der Benutzer synchronisiert wurde, mit seiner Cloudflare-Benutzer-ID. Die Aktion:- Beendet alle aktiven Cloudflare-Access-Sitzungen des Benutzers
- Widerruft die registrierten Geräte des Benutzers
- Verlangt vom Benutzer eine erneute Authentifizierung bei WARP für Gateway-Richtlinien, die eine WARP-Sitzungsdauer erzwingen

