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
- Accédez à la console d'administration Zscaler
- Naviguez vers la section appropriée (Device Management ou Inventory)
- Configurez les filtres d'export si nécessaire
- Sélectionnez tous les champs requis pour l'export
2. Génération du CSV
- Lancez le processus d'export
- Téléchargez les fichiers CSV générés
- Vérifiez la complétude et l'exactitude des données
- 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 :
- CSV d'export des appareils : Inventaire complet des appareils avec tous les champs spécifiés
- CSV d'export des logiciels : Inventaire logiciel avec les détails d'installation et de version
- Fréquence d'export : Fréquence de mise à jour des données (quotidienne, hebdomadaire, etc.)
- Méthode de livraison : Comment les fichiers CSV seront transférés (SFTP, email, etc.)
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é.
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.
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_orgAutomatiser 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.