Skip to main content
Connectez un flux Cloud Nanolog Streaming Service (NSS) de Zscaler Internet Access (ZIA) pour envoyer des journaux web à Living Security. Il s’agit d’une intégration de type « push ». Elle est distincte de l’intégration Zscaler Client Connector, fondée sur la récupération des données (« pull »).

​
Apport de cette intégration

Le flux de journaux web permet d’identifier l’utilisateur et l’appareil concernés par l’activité web, et peut fournir des activités normalisées, telles que les requêtes bloquées, les destinations malveillantes, les blocages de transferts de données et l’utilisation de l’IA générative. Le résultat dépend des champs et des filtres configurés dans Zscaler.

​
Avant de commencer

Vous avez besoin des éléments suivants :
  • un abonnement ZIA Cloud NSS et l’autorisation de gérer les flux Cloud NSS
  • l’autorisation de gérer les intégrations et les clés d’accès dans Living Security
  • la région de l’organisation Living Security cible
  • un emplacement sécurisé pour conserver la clé d’accès générée
Zscaler exige un certificat TLS émis par une autorité publiquement reconnue pour une destination Cloud NSS en HTTPS. Les points de terminaison régionaux de Living Security répondent à cette exigence.

​
1. Préparer Living Security

1

Créer la source et le flux

Accédez à Paramètres → Intégrations → Catalogue, ajoutez Custom Push Source, puis utilisez exactement les clés de routage suivantes :Le trait de soulignement dans web_logs est obligatoire. Un autre couple de valeurs peut accepter des données, mais n’utilisera pas l’interpréteur Zscaler NSS maintenu.
2

Créer une clé d'accès

Accédez à Paramètres → Access Keys, créez une clé d’accès avec la portée Push Ingest, puis copiez immédiatement sa valeur.
3

Construire l'URL de destination

Utilisez l’URL correspondant à la région Living Security :
  • États-Unis : https://api.us-east-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs
  • Union européenne : https://api.eu-west-1.livingsecurity.ai/api/v1/push-ingest/zscaler-nss-feed/web_logs

​
2. Créer le flux Cloud NSS

Dans le portail d’administration ZIA actuel, accédez à Logs → Log Streaming → Internet Log Streaming — Nanolog Streaming Service, ouvrez Cloud NSS Feeds, puis sélectionnez Add Cloud NSS Feed. Les libellés des menus peuvent différer dans les anciennes versions du portail ZIA ; les instructions de Zscaler pour les journaux web Cloud NSS font foi pour la navigation dans le portail. Configurez le flux :
N’utilisez pas x-api-key et ne combinez pas une ancienne clé d’API et un secret séparés par un point. L’ingestion push actuelle de Living Security n’accepte la clé d’accès délimitée que dans l’en-tête Authorization: Bearer ….
Utilisez ce Feed Output Format exact, à plat, sur une seule ligne :
Conservez tous les champs au niveau supérieur. L’ancien guide Unify encapsulait ces champs dans un objet event et ajoutait sourcetype. Cette enveloppe peut être acceptée en tant que JSON, mais elle ne correspond pas à l’interpréteur actuel ; elle ne produit donc ni personnes ni activité.
Choisissez le fuseau horaire attendu par vos équipes d’exploitation lors de l’examen des événements Zscaler. Living Security analyse la valeur datetime fournie par le flux.

​
3. Filtrer et activer le flux

Utilisez les filtres Policy Action et Policy Reason de Zscaler pour envoyer l’activité web nécessaire à votre programme de gestion du risque humain. Évitez un paramètre de faible nombre d’événements par seconde, qui pourrait entraîner la perte de journaux lors d’un pic de trafic. Si votre organisation doit plafonner le flux, surveillez à la fois la livraison côté Zscaler et l’historique Push History de Living Security pendant le réglage. Enregistrez le flux, exécutez le test de connectivité de Zscaler, puis définissez Status sur Enabled.

​
4. Vérifier la livraison et l’interprétation

  1. Dans Living Security, ouvrez Paramètres → Intégrations → Connecté → zscaler-nss-feed.
  2. Dans Push History, vérifiez qu’une exécution web_logs récente affiche le nombre d’enregistrements attendu.
  3. Vérifiez que les utilisateurs Zscaler ou les adresses IP d’appareils récents apparaissent associés aux personnes attendues et que l’activité web est disponible en aval.
  4. Si l’exécution est acceptée mais qu’aucune activité n’apparaît, revérifiez la source, le flux et le format de sortie à plat exacts.

​
Dépannage

L’API accepte au maximum 10 000 enregistrements et 10 MB par requête, avec 600 requêtes par 60 secondes par organisation. Consultez Custom Push Source API pour connaître le détail des réponses et des règles de nouvelle tentative.

​
Voir aussi

Custom Push Source API

Consultez l’authentification, les limites de charge utile, les réponses, les nouvelles tentatives et la vérification des exécutions.

Zscaler Client Connector

Connectez l’API Client Connector distincte pour les données relatives aux appareils et à leur posture de sécurité.