Skip to main content
Verbinden Sie einen Zscaler Internet Access (ZIA) Cloud Nanolog Streaming Service (NSS) Feed, um Weblogs an Living Security zu senden. Dies ist eine Push-Integration. Sie ist von der Pull-basierten Integration Zscaler Client Connector getrennt.

Was diese Integration beiträgt

Der Weblog-Feed kann den Benutzer und das Gerät identifizieren, die an einer Webaktivität beteiligt sind, und kann normalisierte Aktivitäten wie blockierte Anfragen, schädliche Ziele, Blockierungen von Datenübertragungen und die Nutzung generativer KI beisteuern. Das Ergebnis hängt von den in Zscaler konfigurierten Feldern und Filtern ab.

Vorbereitung

Sie benötigen:
  • ein ZIA-Cloud-NSS-Abonnement und die Berechtigung zur Verwaltung von Cloud-NSS-Feeds
  • die Berechtigung zur Verwaltung von Integrationen und Zugriffsschlüsseln in Living Security
  • die Region der Ziel-Organisation in Living Security
  • einen sicheren Ort zur Aufbewahrung des generierten Zugriffsschlüssels
Zscaler erfordert für ein HTTPS-Cloud-NSS-Ziel ein öffentlich vertrauenswürdiges TLS-Zertifikat. Die regionalen Endpunkte von Living Security erfüllen diese Anforderung.

1. Living Security vorbereiten

1

Quelle und Stream erstellen

Gehen Sie zu Einstellungen → Integrationen → Catalog, fügen Sie Custom Push Source hinzu und verwenden Sie diese exakten Routing-Schlüssel:Der Unterstrich in web_logs ist erforderlich. Ein anderes Paar kann Daten akzeptieren, verwendet aber nicht den gepflegten Zscaler-NSS-Interpreter.
2

Zugriffsschlüssel erstellen

Gehen Sie zu Einstellungen → Access Keys, erstellen Sie einen Zugriffsschlüssel mit dem Geltungsbereich Push Ingest und kopieren Sie seinen Wert sofort.
3

Ziel-URL zusammenstellen

Verwenden Sie die URL für die Living-Security-Region:
  • USA: https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs
  • Europäische Union: https://api.eu-west-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs

2. Cloud-NSS-Feed erstellen

Gehen Sie im aktuellen ZIA Admin Portal zu Logs → Log Streaming → Internet Log Streaming — Nanolog Streaming Service, öffnen Sie Cloud NSS Feeds und wählen Sie Add Cloud NSS Feed. Die Menübezeichnungen können in älteren Versionen des ZIA-Portals abweichen; für die Navigation im Portal ist die Cloud-NSS-Weblog-Anleitung von Zscaler maßgeblich. Konfigurieren Sie den Feed:
Verwenden Sie nicht x-api-key und kombinieren Sie keinen alten API-Schlüssel und kein Secret mit einem Punkt. Der aktuelle Push-Ingest von Living Security akzeptiert den Zugriffsschlüssel mit Geltungsbereich ausschließlich im Header Authorization: Bearer ….
Verwenden Sie dieses exakte, flache Feed Output Format in einer Zeile:
Behalten Sie jedes Feld auf der obersten Ebene bei. Die eingestellte Unify-Anleitung hat diese Felder in ein event-Objekt eingebettet und sourcetype hinzugefügt. Dieser Umschlag kann als JSON akzeptiert werden, entspricht aber nicht dem aktuellen Interpreter und erzeugt daher keine Personen oder Aktivitäten.
Wählen Sie die Zeitzone, die Ihr Betriebsteam bei der Prüfung von Zscaler-Ereignissen erwartet. Living Security verarbeitet den vom Feed gelieferten Wert datetime.

3. Feed filtern und aktivieren

Verwenden Sie die Filter Policy Action und Policy Reason von Zscaler, um die Webaktivitäten zu senden, die Ihr Human-Risk-Programm benötigt. Vermeiden Sie eine niedrige Einstellung für Ereignisse pro Sekunde, da dadurch bei einer Verkehrsspitze Logs verworfen werden könnten. Wenn Ihre Organisation den Feed begrenzen muss, überwachen Sie beim Feinabstimmen sowohl die Zscaler-Zustellung als auch den Push History in Living Security. Speichern Sie den Feed, führen Sie den Konnektivitätstest von Zscaler aus und setzen Sie dann Status auf Enabled.

4. Zustellung und Interpretation überprüfen

  1. Öffnen Sie in Living Security Einstellungen → Integrationen → Verbunden → zscaler-nss-feed.
  2. Bestätigen Sie unter Push History, dass ein aktueller web_logs-Lauf die erwartete Datensatzanzahl anzeigt.
  3. Bestätigen Sie, dass aktuelle Zscaler-Benutzer oder Geräte-IPs den erwarteten Personen zugeordnet sind und dass Webaktivitäten nachgelagert verfügbar sind.
  4. Wenn der Lauf akzeptiert wird, aber keine Aktivität erscheint, überprüfen Sie erneut die exakte Quelle, den Stream und das flache Ausgabeformat.

Fehlerbehebung

Die API akzeptiert höchstens 10,000 Datensätze und 10 MB pro Anfrage, bei 600 Anfragen pro 60 Sekunden je Organisation. Den vollständigen Vertrag zu Antworten und Wiederholungsversuchen finden Sie unter Custom Push Source API.

Weiterführende Informationen

Custom Push Source API

Hier finden Sie Informationen zu Authentifizierung, Payload-Limits, Antworten, Wiederholungsversuchen und Laufüberprüfung.

Zscaler Client Connector

Verbinden Sie die separate Client Connector API für Geräte- und Posture-Daten.