Zscaler CSV Zscaler CSV

Exportez les données Zscaler (appareils et logiciels) via CSV

Ce guide explique comment exporter les données Zscaler pour les devices et les logiciels des fichiers CSV.

Objectif

Le connecteur Zscaler permet d'exporter les informations du parc informatique dans des fichiers CSV générés par des commandes PowerShell. Ces fichiers sont ensuite intégrés via un connecteur CSV sur notre plateforme.

Prérequis

  • Accès administratif à Zscaler.
  • PowerShell installé sur la machine de l'administrateur.
  • Permissions nécessaires pour exécuter les commandes PowerShell et accéder aux informations Zscaler.

Étapes pour générer les Fichiers CSV

Devices (appareils/terminaux)

Dans Device Management page > Enrolled Devices > Device Overview > Export.

  • Inclure les champs suivants :
    • Tous les champs du device details.
    • Les champs custom du device details (User, OS Type, Device Model, OS Version, and VPN State).
    • Disable Reasons
    • Service status

Logiciels

Dans Inventory > Software Inventory > Export avec les champs suivants :

  • Device
  • User
  • Software version
  • Vendor
  • OS
  • Location
  • Install Date
  • Version history

Configuration de l'export

Champs d'export des appareils

Lors de l'export des informations d'appareils, assurez-vous d'inclure les données suivantes :

Informations de base de l'appareil :

  • ID et nom de l'appareil
  • Utilisateur associé à l'appareil
  • Type et version du système d'exploitation
  • Modèle et fabricant de l'appareil
  • Horodatage de dernière connexion

Sécurité et conformité :

  • État de la connexion VPN
  • Statut de conformité aux politiques de sécurité
  • Statut d'enregistrement de l'appareil
  • Statut du service (actif/inactif)

Informations de gestion :

  • Raisons de désactivation (le cas échéant)
  • Version de l'agent de gestion
  • Informations de localisation (si disponibles)

Export de l'inventaire logiciel

L'inventaire logiciel doit capturer :

Détails des applications :

  • Nom et version du logiciel
  • Informations sur l'éditeur/vendeur
  • Date d'installation et historique
  • Informations de licence (si disponibles)

Association aux appareils :

  • Appareil et utilisateur associés
  • Système d'exploitation d'installation
  • Emplacement/chemin d'installation

Traitement des données

1. Préparation de l'export

  1. Accédez à la console d'administration Zscaler
  2. Naviguez vers la section appropriée (Device Management ou Inventory)
  3. Configurez les filtres d'export si nécessaire
  4. Sélectionnez tous les champs requis pour l'export

2. Génération du CSV

  1. Lancez le processus d'export
  2. Téléchargez les fichiers CSV générés
  3. Vérifiez la complétude et l'exactitude des données
  4. Préparez les fichiers pour l'intégration au connecteur

3. Validation des données

  • Assurez-vous que tous les champs requis sont présents
  • Vérifiez la cohérence du format des données
  • Recherchez les entrées manquantes ou corrompues
  • Validez les formats de dates et les caractères spéciaux

Informations à fournir dans OverView

Pour configurer le connecteur Zscaler CSV, veuillez fournir :

  1. CSV d'export des appareils : Inventaire complet des appareils avec tous les champs spécifiés
  2. CSV d'export des logiciels : Inventaire logiciel avec les détails d'installation et de version
  3. Fréquence d'export : Fréquence de mise à jour des données (quotidienne, hebdomadaire, etc.)
  4. Méthode de livraison : Comment les fichiers CSV seront transférés (SFTP, email, etc.)
Note
Fraîcheur des données

Assurez-vous d'effectuer des exports réguliers pour maintenir une visibilité à jour sur votre inventaire d'appareils et de logiciels. Nous recommandons des exports au moins hebdomadaires pour un suivi optimal de la sécurité.

Astuce
Automatisation des exports

Envisagez de configurer des exports automatisés via l'API Zscaler ou des rapports planifiés pour garantir une disponibilité cohérente des données.


Dépannage

Problèmes d'export courants

  • Données incomplètes : Vérifiez que tous les champs requis sont sélectionnés avant l'export
  • Erreurs de permissions : Assurez-vous que votre compte dispose des permissions nécessaires pour accéder à l'inventaire des appareils et logiciels
  • Fichiers volumineux : Envisagez de filtrer ou de segmenter les exports volumineux pour un traitement plus facile

Vérifications de qualité des données

  • Vérifiez que le nombre d'appareils correspond à l'inventaire attendu
  • Recherchez les doublons ou les appareils manquants
  • Validez les dates d'installation et les versions des logiciels
  • Assurez-vous que les associations utilisateurs sont correctes

Pour toute question ou assistance supplémentaire, n'hésitez pas à contacter notre support technique.

Importer les fichiers via DropPoint

Les fichiers du connecteur Zscaler sont déposés dans un bucket S3 dédié nommé zscaler. Placez vos fichiers CSV (ou JSON) à la racine de s3://zscaler/ : OverView détecte automatiquement les nouveaux fichiers et les importe lors de la prochaine synchronisation.

Où déposer les fichiers ?

Bucket : s3://zscaler/

Exemple : s3://zscaler/devices.csv

Plusieurs façons d'envoyer vos fichiers

Vous pouvez alimenter votre bucket de plusieurs manières :

  • Interface web OverView — importez vos fichiers, configurez le mapping, puis cliquez sur « Remplacer » pour rafraîchir les données sans avoir à refaire le mapping.
  • AWS CLI — pour un envoi ponctuel ou scripté.
  • SDK S3 (boto3, etc.) — pour automatiser entièrement des imports récurrents.

Via AWS CLI

# Upload a file to the zscaler bucket
aws s3 cp devices.csv s3://zscaler/devices.csv --profile ovs_your_org

# Or sync a whole local folder
aws s3 sync ./exports/ s3://zscaler/ --profile ovs_your_org

Automatiser l'import via S3

import boto3

s3 = boto3.client(
    "s3",
    endpoint_url="https://s3.oversoc.com",
    region_name="fr-par",
    aws_access_key_id="YOUR_ACCESS_KEY",
    aws_secret_access_key="YOUR_SECRET_KEY",
)

# Push the export into the zscaler bucket
s3.upload_file("devices.csv", "zscaler", "devices.csv")

Associez ce script à une tâche planifiée (cron sous Linux, Planificateur de tâches sous Windows) pour pousser automatiquement vos exports à intervalle régulier. Chaque dépôt déclenche un nouvel import côté OverView.

Prérequis : générez vos credentials S3 et configurez votre client (endpoint, profil) comme décrit dans le guide OverView DropPoint. Le profil et l'endpoint utilisés ici y sont expliqués.