Collecter les journaux Palo Alto Prisma SD-WAN
Ce document explique comment ingérer les journaux Palo Alto Prisma SD-WAN (anciennement Cloudgenix SD-WAN) dans Google Security Operations à l'aide de Bindplane. L'analyseur extrait les champs des journaux syslog et de flux, et les mappe au modèle de données unifié (UDM). Il gère les messages syslog structurés et non structurés, en effectuant l'analyse clé-valeur et la correspondance Grok pour extraire les informations pertinentes telles que les adresses IP source/de destination, les noms d'hôte, les types d'événements et les détails de sécurité, et remplit les champs UDM en conséquence. L'analyseur traite également les journaux de flux, en extrayant les informations réseau et en les mappant aux schémas de résultats réseau, principal, cible, intermédiaire et de sécurité de l'UDM.
Avant de commencer
Assurez-vous de remplir les conditions suivantes :
- Instance Google SecOps
- Windows 2016 ou version ultérieure, ou un hôte Linux avec
systemd
- Si vous exécutez le programme derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts.
- Accès privilégié à Palo Alto Prisma SD-WAN (anciennement Cloudgenix SD-WAN)
Obtenir le fichier d'authentification d'ingestion Google SecOps
- Connectez-vous à la console Google SecOps.
- Accédez à Paramètres du SIEM > Agents de collecte.
- Téléchargez le fichier d'authentification d'ingestion. Enregistrez le fichier de manière sécurisée sur le système sur lequel Bindplane sera installé.
Obtenir l'ID client Google SecOps
- Connectez-vous à la console Google SecOps.
- Accédez à Paramètres SIEM> Profil.
- Copiez et enregistrez le numéro client de la section Informations sur l'organisation.
Installer l'agent Bindplane
Installez l'agent Bindplane sur votre système d'exploitation Windows ou Linux en suivant les instructions ci-dessous.
Installation de fenêtres
- Ouvrez l'invite de commandes ou PowerShell en tant qu'administrateur.
Exécutez la commande suivante :
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
Installation de Linux
- Ouvrez un terminal avec les droits root ou sudo.
Exécutez la commande suivante :
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
Ressources d'installation supplémentaires
Pour plus d'options d'installation, consultez le guide d'installation.
Configurer l'agent Bindplane pour ingérer Syslog et l'envoyer à Google SecOps
- Accédez au fichier de configuration :
- Trouvez le fichier
config.yaml
. Il se trouve généralement dans le répertoire/etc/bindplane-agent/
sous Linux ou dans le répertoire d'installation sous Windows. - Ouvrez le fichier à l'aide d'un éditeur de texte (par exemple,
nano
,vi
ou le Bloc-notes).
- Trouvez le fichier
Modifiez le fichier
config.yaml
comme suit :```yaml receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds_file_path: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <customer_id> endpoint: malachiteingestion-pa.googleapis.com # Add optional ingestion labels for better organization log_type: 'CLOUDGENIX_SDWAN' raw_log_field: body ingestion_labels: service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labels ```
- Remplacez le port et l'adresse IP selon les besoins de votre infrastructure.
- Remplacez
<customer_id>
par le numéro client réel. - Mettez à jour
/path/to/ingestion-authentication-file.json
en indiquant le chemin d'accès où le fichier d'authentification a été enregistré dans la section Obtenir le fichier d'authentification pour l'ingestion Google SecOps.
Redémarrez l'agent Bindplane pour appliquer les modifications.
Pour redémarrer l'agent Bindplane sous Linux, exécutez la commande suivante :
sudo systemctl restart bindplane-agent
Pour redémarrer l'agent Bindplane sous Windows, vous pouvez utiliser la console Services ou saisir la commande suivante :
net stop BindPlaneAgent && net start BindPlaneAgent
Configurer le profil Syslog Prisma SD-WAN
- Connectez-vous à Prisma SD-WAN.
- Accédez à Gérer > Ressources > Profils de configuration.
- Sélectionnez Syslog.
- Cliquez sur Créer un profil Syslog.
- Fournissez les informations de configuration suivantes :
- Nom : saisissez un nom pour ce profil.
- Cochez la case Activer la journalisation des flux.
- Gravité : sélectionnez le niveau de gravité (critique, majeure ou mineure).
- Protocole : sélectionnez le type de protocole UDP ou TCP, en fonction de la configuration de votre agent Bindplane.
- Cochez la case d'option Adresse IP du serveur.
- Saisissez l'adresse IP de l'agent Bindplane.
- Port du serveur : saisissez le numéro de port de l'agent Bindplane.
- Cliquez sur Enregistrer.
Table de mappage UDM
Champ de journal | Mappage UDM | Logique |
---|---|---|
ACTION |
security_result.action |
Si ACTION_CODE est défini sur "1", définissez-le sur "ALLOW". Sinon, si ACTION_CODE n'est pas vide, définissez-le sur "BLOCK". Sinon, la valeur par défaut est "UNKNOWN_ACTION" (ACTION_INCONNUE) à partir d'un point antérieur de l'analyseur. |
ACTION_CODE |
security_result.action |
Utilisé dans la logique pour déterminer security_result.action . |
APP_NAME |
network.http.user_agent |
Mappé directement. |
BYTES_RECVD |
network.received_bytes |
Mappé directement, converti en entier non signé. |
BYTES_SENT |
network.sent_bytes |
Mappé directement, converti en entier non signé. |
CLOUDGENIX_HOST |
principal.hostname |
Mappé directement si le champ NAME est vide. Utilisé comme nom d'hôte intermédiaire si NAME est présent. |
CODE |
metadata.product_event_type |
Concaténé avec FACILITY pour former metadata.product_event_type . Également utilisé pour déterminer metadata.event_type (par exemple, si CODE contient "DOWN", metadata.event_type est défini sur "STATUS_SHUTDOWN"). |
DESTINATION_ZONE_NAME |
about.labels |
Mappé directement en tant que libellé avec la clé "DESTINATION_ZONE_NAME". |
DEVICE_TIME |
metadata.event_timestamp |
Directement mappée après avoir été analysée en tant que date. |
DST_INTERFACE |
target.hostname |
Mappé directement. |
DST_IP |
target.ip |
Mappé directement. |
DST_PORT |
target.port |
Mappé directement, converti en entier. |
ELEMENT_ID |
about.labels |
Mappé directement en tant que libellé avec la clé "ELEMENT_ID". |
EVENT_TIME |
metadata.event_timestamp |
Directement mappée après avoir été analysée en tant que date. |
FACILITY |
metadata.product_event_type |
Concaténé avec CODE pour former metadata.product_event_type . |
FLOW_EVENT |
security_result.summary |
Utilisé dans la chaîne security_result.summary . |
IDENTIFIER |
about.labels |
Directement mappé en tant que libellé avec la clé "IDENTIFIER". |
ION_HOST |
principal.hostname |
Mappé directement si les champs CLOUDGENIX_HOST et NAME sont vides. |
MSG |
metadata.description |
Mappé directement. Également utilisé pour la correspondance des expressions régulières afin de déterminer metadata.event_type et d'extraire target.ip . |
NAME |
principal.hostname |
Mappé directement. Si CLOUDGENIX_HOST est présent, il devient intermediary.hostname . |
PROCESS_NAME |
principal.process.file.full_path |
Mappé directement. |
PROTOCOL_NAME |
network.ip_protocol |
Mappé directement et converti en majuscules. |
REMOTE_HOSTNAME |
target.hostname |
Mappé directement. |
REMOTE_IP |
target.ip |
Mappé directement. |
RULE_NAME |
security_result.rule_name |
Mappé directement. |
SEVERITY |
security_result.severity , security_result.severity_details |
Associé à security_result.severity_details . Il est également utilisé pour déterminer security_result.severity (par exemple, si SEVERITY est "minor", security_result.severity est défini sur "LOW"). |
SOURCE_ZONE_NAME |
about.labels |
Mappé directement en tant qu'étiquette avec la clé "SOURCE_ZONE_NAME". |
SRC_INTERFACE |
principal.hostname |
Mappé directement. |
SRC_IP |
principal.ip |
Mappé directement. |
SRC_PORT |
principal.port |
Mappé directement, converti en entier. |
VPN_LINK_ID |
target.resource.id |
Mappé directement. |
(Logique de l'analyseur) | is_alert |
Définissez sur "true" si log_type est "alert" ou "alarm". |
(Logique de l'analyseur) | is_significant |
Définissez sur "true" si log_type est "alert" ou "alarm". |
(Logique de l'analyseur) | metadata.event_type |
Déterminé par une série d'instructions conditionnelles basées sur les valeurs de CODE , MSG , src_ip et dest_ip . La valeur par défaut est "GENERIC_EVENT". |
(Logique de l'analyseur) | metadata.log_type |
Définissez-le sur "CLOUDGENIX_SDWAN". |
(Logique de l'analyseur) | metadata.product_event_type |
La valeur par défaut est la concaténation de CODE et FACILITY . Définissez la valeur sur "cgxFlowLogV1" pour les journaux de flux. |
(Logique de l'analyseur) | metadata.product_name |
Définissez-le sur "CloudGenix SD-WAN". |
(Logique de l'analyseur) | metadata.vendor_name |
Défini sur "Palo Alto Networks". |
(Logique de l'analyseur) | principal.process.pid |
Définissez la valeur de pid à partir du journal brut pour les journaux de flux. |
(Logique de l'analyseur) | security_result.action |
La valeur par défaut est "UNKNOWN_ACTION". |
(Logique de l'analyseur) | security_result.severity |
La valeur par défaut est "UNKNOWN_SEVERITY". Définissez en fonction de la valeur de SEVERITY . Définissez-le sur "INFORMATIONAL" pour les journaux de flux. |
(Logique de l'analyseur) | security_result.summary |
Définissez la valeur de CODE pour les messages syslog. Définissez une chaîne descriptive incluant FLOW_EVENT , SRC_IP et DST_IP pour les journaux de flux. |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.