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 » (envoi). Elle est distincte de l’intégration Zscaler Client Connector, qui repose sur un mécanisme « pull » (extraction).

​
Ce que cette intégration apporte

Le flux de journaux Web peut identifier l’utilisateur et l’appareil associés à l’activité Web, et peut fournir des activités normalisées, comme les requêtes bloquées, les destinations malveillantes, les blocages de transfert 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 stocker la clé d’accès générée.
Zscaler exige un certificat TLS approuvé publiquement pour une destination Cloud NSS en HTTPS. Les points de terminaison régionaux de Living Security satisfont à 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. Une paire différente 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 de 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 la version actuelle du portail d’administration ZIA, 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 de menu peuvent différer dans les versions antérieures du portail ZIA; les instructions de Zscaler sur les journaux Web Cloud NSS font autorité 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 avec un point. L’ingestion par envoi actuelle de Living Security accepte la clé d’accès à portée limitée uniquement dans l’en-tête Authorization: Bearer ….
Utilisez ce Feed Output Format exact et à 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 aucune personne ni aucune activité.
Choisissez le fuseau horaire attendu par votre équipe des opérations 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 requise par votre programme de gestion du risque humain. Évitez un paramètre de faible nombre d’événements par seconde, qui pourrait entraîner l’abandon 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 des envois (Push History) de Living Security pendant l’ajustement. Enregistrez le flux, exécutez le test de connectivité de Zscaler, puis réglez Status à 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, confirmez qu’une exécution web_logs récente affiche le nombre d’enregistrements attendu.
  3. Confirmez que les utilisateurs Zscaler ou les adresses IP d’appareils récents apparaissent en regard des 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 plus 10 000 enregistrements et 10 MB par requête, à raison de 600 requêtes par 60 secondes par organisation. Consultez Custom Push Source API pour connaître le contrat complet des réponses et des nouvelles tentatives.

​
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 obtenir les données sur les appareils et leur posture.