Collecter les journaux d'événements Palo Alto Cortex XDR
Ce document explique comment ingérer des journaux d'événements Palo Alto Cortex XDR dans Google Security Operations à l'aide de Google Cloud Storage. L'analyseur extrait les données d'événements de sécurité des journaux JSON Palo Alto Networks Cortex XDR. Il normalise les données dans le modèle de données unifié (UDM) en mappant les champs, en convertissant les types de données et en enrichissant les événements avec des métadonnées telles que le fournisseur, le produit et les types d'événements en fonction d'une logique conditionnelle liée aux champs event_type et event_sub_type. Il gère également les connexions réseau, les opérations sur les fichiers et le registre, les informations sur les processus et l'activité des utilisateurs.
Avant de commencer
Assurez-vous de remplir les conditions suivantes :
- Instance Google SecOps
- Google Cloud Le stockage est configuré et actif dans votre environnement Google Cloud
- Accès privilégié à Google Cloud et autorisations appropriées
- Accès privilégié à Palo Alto Cortex XDR
Créer un bucket Google Cloud Cloud Storage
- Connectez-vous à la console Google Cloud .
Accédez à la page Buckets Cloud Storage.
Cliquez sur Créer.
Sur la page Créer un bucket, saisissez les informations concernant votre bucket. Après chacune des étapes suivantes, cliquez sur Continuer :
Dans la section Premiers pas, procédez comme suit :
- Saisissez un nom unique qui répond aux exigences de dénomination des buckets (par exemple, cortex-xdr-events-secops).
Pour activer l'espace de noms hiérarchique, cliquez sur la flèche d'expansion pour développer la section Optimiser pour les charges de travail orientées fichiers et à forte intensité de données, puis sélectionnez Activer l'espace de noms hiérarchique sur ce bucket.
Pour ajouter une étiquette de bucket, cliquez sur la flèche de développement pour développer la section Étiquettes.
Cliquez sur Ajouter une étiquette, puis spécifiez une clé et une valeur pour votre étiquette.
Dans la section Choisir l'emplacement de stockage de vos données, procédez comme suit :
- Sélectionnez un type d'emplacement.
Utilisez le menu du type d'emplacement pour sélectionner un emplacement où les données d'objets de votre bucket seront stockées de manière permanente.
Pour configurer la réplication entre buckets, développez la section Configurer la réplication entre buckets.
Dans la section Choisir une classe de stockage pour vos données, sélectionnez une classe de stockage par défaut pour le bucket, ou bien classe automatique pour une gestion automatique des classes de stockage des données de votre bucket.
Dans la section Choisissez comment contrôler l'accès aux objets, sélectionnez Ne pas appliquer la protection contre l'accès public, puis sélectionnez un modèle de contrôle des accès pour les objets de votre bucket.
Dans la section Choisissez comment protéger les données des objets, procédez comme suit :
- Sous Protection des données, sélectionnez les options que vous souhaitez définir pour votre bucket.
- Pour choisir comment vos données d'objet seront chiffrées, cliquez sur la flèche de développement Chiffrement des données, puis sélectionnez une méthode de chiffrement des données.
Cliquez sur Créer.
Configurez une règle de gestion du cycle de vie des objets sur le bucket de destination nouvellement créé pour supprimer les objets au bout de sept jours :
- Dans la liste Buckets Cloud Storage, cliquez sur le nom de votre bucket.
- Sélectionnez l'onglet Cycle de vie, puis cliquez sur Ajouter une règle.
- Dans la section Sélectionner une action, sélectionnez Supprimer un objet.
- Dans la section Sélectionner les conditions de l'objet, sélectionnez Âge, puis définissez la valeur sur
7jours. - Cliquez sur Enregistrer.
Configurer le transfert d'événements Cortex XDR
- Connectez-vous à l'UI Web de Cortex XDR.
- Accédez à Settings > Configurations > Data Management > Event Forwarding (Paramètres > Configurations > Gestion des données > Transfert d'événements).
- Activez les licences dans la section Activation.
- Activez le transfert d'événements par Go pour exporter les journaux analysés pour Cortex XDR Pro par Go vers un SIEM externe pour le stockage.
- Activez le transfert d'événements Endpoints pour exporter les données brutes des points de terminaison pour Cortex XDR Pro EP et Cloud Endpoints.
- Enregistrez la sélection.
- Copiez le chemin d'accès de stockage affiché.
- Générez et téléchargez le jeton Web JSON du compte de service, qui contient la clé d'accès.
- Enregistrez-le dans un emplacement sécurisé.
Configurer Google Cloud Secret Manager
- Connectez-vous à votre GCP.
- Accédez à la page Secret Manager.
- Si c'est la première fois, vous serez invité à activer l'API Secret Manager.
- Créez un secret nommé EVENT_FRWD_CRTX_KEY et copiez le contenu du fichier JSON xdr_sa_key.json que vous avez téléchargé en tant que valeur du secret.
Configurer des flux
Pour configurer un flux, procédez comme suit :
- Accédez à Paramètres > Gestion des données > Flux. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Flux.
- Cliquez sur Ajouter un flux d'actualités.
- Sur la page suivante, cliquez sur Configurer un seul flux.
- Dans le champ Nom du flux, saisissez un nom pour le flux (par exemple, Journaux d'événements PANW Cortex XDR).
- Sélectionnez Google Cloud Storage V2 comme Type de source.
- Sélectionnez Événements Palo Alto Cortex XDR comme Type de journal.
- Cliquez sur Obtenir un compte de service pour le compte de service Chronicle.
- Cliquez sur Suivant.
Spécifiez les valeurs des paramètres d'entrée suivants :
- URI du bucket de stockage : Google Cloud URL du bucket de stockage (par exemple,
gs://cortex-xdr-events-secops/). Cette URL doit se terminer par une barre oblique (/). Options de suppression de la source : sélectionnez Ne pas supprimer les fichiers transférés.
Âge maximal du fichier : inclut les fichiers modifiés au cours d'un certain nombre de jours. La valeur par défaut est de 180 jours.
- URI du bucket de stockage : Google Cloud URL du bucket de stockage (par exemple,
Cliquez sur Suivant.
Vérifiez la configuration de votre nouveau flux d'actualités sur l'écran Finaliser, puis cliquez sur Envoyer.
Une fois le flux créé, recherchez-le dans la liste Flux, puis cliquez sur les trois points d'action à droite de la ligne.
Sélectionnez Désactiver le flux.
Configurer l'accès JSON secret à Cloud Storage
- Connectez-vous à votre GCP.
- Accédez à la page Secret Manager.
- Sélectionnez le secret EVENT_FRWD_CRTX_KEY.
- Accédez à l'onglet Autorisations.
- Fournissez les accès Administrateur des objets Storage et Lecteur des anciens buckets de l'espace de stockage au bucket cortex-xdr-events-secops créé précédemment.
Configurer les autorisations Google SecOps pour Cloud Storage
- Accédez à IAM et administration > IAM.
- Recherchez le compte de service Chronicle.
- Accordez le rôle Lecteur des objets Storage (roles/storage.objectViewer) au bucket cortex-xdr-events-secops créé précédemment.
Configurer l'ingestion des journaux d'événements PANW Cortex XDR dans Project Cloud Storage
- Dans Google Cloud, accédez à API et services > Bibliothèque.
- Activez les API Cloud Run et Artifact Registry.
- Ouvrez Cloud Shell en cliquant sur l'icône dans la barre de navigation supérieure.
Téléchargez un code personnalisé à l'aide de la commande suivante :
git clone https://github.com/PaloAltoNetworks/google-cloud-cortex-chronicle.gitAccédez au répertoire en exécutant la commande suivante :
cd google-cloud-cortex-chronicle/Ouvrez le fichier
env.propertiesavec un éditeur tel quevi.Fournissez les informations de configuration suivantes :
REGION=us-central1 # Update according to your project region REPO_NAME=panw-chronicle IMAGE_NAME=sync_cortex_bucket GCP_PROJECT_ID=chrxxxxxxxxx # Update according to your project ID JOB_NAME=cloud-run-job-cortex-data-sync # The Cloud Job name ROJECT_NUMBER=80xxxxx9 # Update according to your project number # JOB ENV VARIABLES SRC_BUCKET=xdr-us-xxxxx-event-forwarding # Update with the Cortex XDR GCS bucket name DEST_BUCKET=cortex-xdr-events-secops # Update with the GCS name of the bucket you created SECRET_NAME=EVENT_FRWD_CRTX_KEY # Need to match the secret you created JOB_SCHEDULE_MINS=30Fournissez les autorisations nécessaires au script
deploy.sh:chmod 744 deploy.shExécutez le script
deploy.sh:./deploy.shIdentifiez le compte de service Cloud Job utilisé à partir du résultat du script.
Accordez au compte de service Cloud Job l'autorisation Ancêtre de secrets Secret Manager pour accéder au secret que vous avez créé précédemment (dans notre exemple, EVENT_FRWD_CRTX_KEY).
Accédez à Secret Manager > EVENT_FRWD_CRTX_KEY (secret) > Autorisations.
Dans la plate-forme Google SecOps, accédez à Paramètres > Gestion des données > Flux > Nom du flux d'événements XDR > Activer le flux.
Table de mappage UDM
| Champ du journal | Mappage UDM | Logique |
|---|---|---|
action_file_path |
target.file.full_path |
Mappage direct |
action_file_size |
target.file.size |
Mappé directement et converti en entier non signé |
action_local_ip |
principal.ip |
Mappées directement et fusionnées avec d'autres adresses IP |
action_local_port |
principal.port |
Mappé directement et converti en entier |
action_module_path |
target.process.file.full_path |
Mappage direct |
action_network_connection_id |
network.session_id |
Mappage direct |
action_network_protocol |
network.ip_protocol |
Renommé protocol_number_src, analysé à l'aide de parse_ip_protocol.include et mappé sur network.ip_protocol |
action_process_image_command_line |
target.process.command_line |
Mappage direct |
action_process_image_md5 |
target.process.file.md5 |
Mappage direct |
action_process_image_path |
target.process.file.full_path |
Mappage direct |
action_process_image_sha256 |
target.process.file.sha256 |
Mappage direct |
action_process_os_pid |
target.process.pid |
Mappé directement et converti en chaîne |
action_process_user_sid |
target.user.windows_sid |
Mappage direct |
action_process_username |
target.user.userid, target.administrative_domain |
Convertie en minuscules, analysée pour le domaine et l'utilisateur, et mappée en conséquence |
action_registry_data |
target.registry.registry_value_data |
Mappage direct |
action_registry_key_name |
target.registry.registry_key |
Mappage direct |
action_registry_value_name |
target.registry.registry_value_name |
Mappage direct |
action_remote_ip |
target.ip |
Mappées directement et fusionnées avec d'autres adresses IP |
action_remote_port |
target.port |
Mappé directement et converti en entier |
action_total_download |
network.received_bytes |
Mappé directement et converti en entier non signé |
action_total_upload |
network.sent_bytes |
Mappé directement et converti en entier non signé |
agent_hostname |
principal.hostname, observer.hostname |
Converti en minuscules et mappé |
agent_ip_addresses |
observer.ip |
Analysé au format JSON, divisé en adresses IP individuelles et fusionné |
agent_os_sub_type |
target.platform_version |
Mappage direct |
event_id |
metadata.product_log_id |
Mappage direct |
event_sub_type |
metadata.product_event_type |
Converti en chaîne et utilisé pour le mappage conditionnel de metadata.event_type et metadata.product_event_type |
event_timestamp |
metadata.event_timestamp, timestamp |
Converti en chaîne, analysé en tant que code temporel UNIX_MS et mappé |
event_type |
metadata.event_type |
Converti en chaîne et utilisé pour le mappage conditionnel de metadata.event_type et metadata.product_event_type |
os_actor_process_command_line |
principal.process.command_line |
Mappage direct |
os_actor_process_image_md5 |
principal.process.file.md5 |
Mappage direct |
os_actor_process_image_path |
principal.process.file.full_path |
Mappage direct |
os_actor_process_image_sha256 |
principal.process.file.sha256 |
Mappage direct |
os_actor_process_instance_id |
principal.process.product_specific_process_id |
Préfixé par "PAN:" et mappé |
os_actor_process_os_pid |
principal.process.pid |
Converti en chaîne et mappé |
os_actor_primary_user_sid |
principal.user.windows_sid |
Mappé s'il commence par "S-" ou "s-" |
os_actor_primary_username |
principal.user.userid, principal.administrative_domain |
Convertie en minuscules, analysée pour le domaine et l'utilisateur, et mappée en conséquence |
_action |
security_result.action |
Fusionné dans _security_result, puis mappé |
metadata.log_type |
metadata.log_type |
Valeur codée en dur sur "PAN_CORTEX_XDR_EVENTS" |
metadata.product_name |
metadata.product_name |
Codé en dur sur "Cortex XDR" |
metadata.vendor_name |
metadata.vendor_name |
Codé en dur sur "PAN" |
target.platform |
target.platform |
Définissez sur "WINDOWS" si agent_os_sub_type contient "Windows". |
action_user_session_id |
event.idm.read_only_udm.network.session_id |
Mappé à partir du journal des modifications |
action_username |
event.idm.read_only_udm.principal.user.user_display_name |
Mappé à partir du journal des modifications |
agent_ip_addresses |
event.idm.read_only_udm.principal.ip et event.idm.read_only_udm.principal.asset.ip |
Mappé à partir du journal des modifications |
agent_os_sub_type |
event.idm.read_only_udm.principal.platform_version |
Mappé à partir du journal des modifications |
agent_id |
event.idm.read_only_udm.principal.asset.asset_id et event.idm.read_only_udm.principal.asset_id |
Mappé à partir du journal des modifications |
agent_os_type |
event.idm.read_only_udm.principal.platform |
Mappé à partir du journal des modifications |
action_process_token |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_process_fds |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_process_termination_date |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_process_termination_code |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_network_stats_is_last |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_user_is_local_session |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_user_status |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
event_version |
event.idm.read_only_udm.metadata.product_version |
Mappé à partir du journal des modifications |
action_file_previous_file_path |
event.idm.read_only_udm.principal.file.full_path |
Mappé à partir du journal des modifications |
agent_interface_map.ipv4 |
event.idm.read_only_udm.observer.ip |
Mappé à partir du journal des modifications |
agent_interface_map.mac |
event.idm.read_only_udm.observer.mac |
Mappé à partir du journal des modifications |
action_file_last_writer_actor |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_file_device_type |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_file_previous_file_name |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_file_name |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
agent_id |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
agent_version |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
agent_os_type |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
os_actor_thread_thread_id |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_file_type |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_file_prev_type |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
os_actor_process_signature_status |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
os_actor_process_logon_id |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
agent_content_version |
event.idm.read_only_udm.additional.fields |
Mappé à partir du journal des modifications |
action_module_image_size |
event.idm.read_only_udm.target.file.size |
Mappé à partir du journal des modifications |
action_file_md5 |
event.idm.read_only_udm.target.file.md5 |
Mappé à partir du journal des modifications |
action_file_sha256 |
event.idm.read_only_udm.target.file.sha256 |
Mappé à partir du journal des modifications |
action_module_md5 |
target.process.file.md5 |
Mappé à partir du journal des modifications |
action_module_sha256 |
target.process.file.sha256 |
Mappé à partir du journal des modifications |
metadata.event_type |
GENERIC_EVENT. |
Mappé à partir du journal des modifications |
Journal des modifications
Afficher le journal des modifications de cet analyseur
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.