Collecter les journaux VPN F5
Ce document explique comment ingérer des journaux de VPN F5 dans Google Security Operations à l'aide de Bindplane. L'analyseur extrait des informations liées à la sécurité des journaux. Il utilise des expressions régulières pour identifier et analyser les champs clés tels que les codes temporels, les adresses IP et les noms d'hôte, puis structure ces données au format Google SecOps Unified Data Model (UDM) pour l'analyse.
Avant de commencer
Assurez-vous de remplir les conditions suivantes :
- Une 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, les ports du pare-feu sont ouverts.
- Accès privilégié à F5-BIG-IP APM (Access Policy Manager)
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 ce guide d'installation.
Configurer l'agent Bindplane pour ingérer Syslog et l'envoyer à Google SecOps
- Accédez au fichier de configuration :
- Recherchez 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).
- Recherchez le fichier
Modifiez le fichier
config.yaml
comme suit :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: 'F5_VPN' 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 Syslog pour F5 BIG-IP APM v11.x et versions ultérieures
- Connectez-vous à F5 BIG-IP APM à l'aide de la CLI ou de SSH.
Saisissez la commande suivante pour ajouter le serveur syslog :
tmsh syslog remote server {<Name> {host <bindplane-ip> remote-port <bindplane-port>}}
Veillez à remplacer les paramètres suivants :
<Name>
: saisissez le nom de la source F5-BIG-IP APM (par exemple,BIGIP_APM
).<bindplane-ip>
: saisissez l'adresse IP de l'agent Bindplane.<bindplane-port>
: saisissez le numéro de port de l'agent Bindplane.
Saisissez la commande suivante pour enregistrer les modifications :
tmsh save sys config partitions all
Table de mappage UDM
Champ du journal | Mappage UDM | Logique |
---|---|---|
cmd_data | principal.process.command_line | La valeur est extraite du champ "msg". |
errdefs_msgno | additional.fields.errdefs_msgno.string_value | La valeur est extraite du champ "msg". |
event_time | metadata.event_timestamp | La valeur est analysée et convertie en code temporel. |
nom d'hôte | principal.hostname, observer.hostname, principal.asset.hostname, observer.asset.hostname, hostip | La valeur est extraite du champ de message et utilisée pour remplir les champs de nom d'hôte dans l'UDM. Sert également à renseigner le champ "hostip". |
Message | security_result.description | La valeur est extraite du champ de message et utilisée pour remplir le champ de description dans l'objet security_result. |
prin_ip | principal.ip, principal.asset.ip | La valeur est extraite du champ de message et utilisée pour remplir les champs d'adresse IP dans l'UDM. |
additional.fields.Canonical_Info.string_value | La valeur est dérivée du message du journal. | |
additional.fields.IDP.string_value | La valeur est dérivée du message du journal. | |
additional.fields.Plugin_Support.string_value | La valeur est dérivée du message du journal. | |
additional.fields.SMB Stage.string_value | La valeur est dérivée du message du journal. | |
additional.fields.SP.string_value | La valeur est dérivée du message du journal. | |
additional.fields.Timezone.string_value | La valeur est dérivée du message du journal. | |
additional.fields.Tunnel Type.string_value | La valeur est dérivée du message du journal. | |
additional.fields.UI_Mode.string_value | La valeur est dérivée du message du journal. | |
additional.fields.Version.string_value | La valeur est dérivée du message du journal. | |
additional.fields.from_rule_item.string_value | La valeur est dérivée du message du journal. | |
additional.fields.policy_result.string_value | La valeur est dérivée du message du journal. | |
additional.fields.ppp_id.string_value | La valeur est dérivée du message du journal. | |
additional.fields.resource.string_value | La valeur est dérivée du message du journal. | |
additional.fields.rule.string_value | La valeur est dérivée du message du journal. | |
additional.fields.server_vip_ip.string_value | La valeur est dérivée du message du journal. | |
additional.fields.server_vip_name.string_value | La valeur est dérivée du message du journal. | |
additional.fields.to_rule_item.string_value | La valeur est dérivée du message du journal. | |
additional.fields.tunnel_resource.string_value | La valeur est dérivée du message du journal. | |
metadata.description | La valeur est dérivée du message du journal. | |
metadata.event_type | La valeur est codée en dur dans le code du parseur pour certains événements et est dérivée du message du journal pour d'autres. | |
metadata.log_type | La valeur correspond au type de lot. | |
metadata.product_event_type | La valeur est dérivée du message du journal. | |
metadata.product_name | La valeur est codée en dur dans le code du parseur. | |
metadata.vendor_name | La valeur est codée en dur dans le code du parseur. | |
network.application_protocol | La valeur est dérivée du message du journal. | |
network.direction | La valeur est dérivée du message du journal. | |
network.http.method | La valeur est dérivée du message du journal. | |
network.http.parsed_user_agent | La valeur est dérivée du champ network.http.user_agent. | |
network.http.referral_url | La valeur est dérivée du message du journal. | |
network.http.response_code | La valeur est dérivée du message du journal. | |
network.http.user_agent | La valeur est dérivée du message du journal. | |
network.ip_protocol | La valeur est dérivée du message du journal. | |
network.received_bytes | La valeur est dérivée du message du journal. | |
network.sent_bytes | La valeur est dérivée du message du journal. | |
network.session_id | La valeur est dérivée du message du journal. | |
network.tls.cipher | La valeur est dérivée du message du journal. | |
network.tls.version | La valeur est dérivée du message du journal. | |
observer.asset.hostname | La valeur est définie sur le champ "Nom d'hôte". | |
observer.asset.ip | La valeur est définie sur le champ hostip. | |
observer.hostname | La valeur est définie sur le champ "Nom d'hôte". | |
observer.ip | La valeur est définie sur le champ hostip. | |
principal.application | La valeur est dérivée du message du journal. | |
principal.asset.hostname | La valeur est définie sur le champ "Nom d'hôte". | |
principal.asset.ip | La valeur est définie sur le champ hostip ou prin_ip, le cas échéant. | |
principal.asset.product_object_id | La valeur est dérivée du message du journal. | |
principal.hostname | La valeur est définie sur le champ "Nom d'hôte". | |
principal.ip | La valeur est définie sur le champ hostip ou prin_ip, le cas échéant. | |
principal.location.country_or_region | La valeur est dérivée du message du journal. | |
principal.platform | La valeur est dérivée du message du journal. | |
principal.port | La valeur est dérivée du message du journal. | |
principal.process.command_line | La valeur est dérivée du message du journal. | |
principal.process.pid | La valeur est dérivée du message du journal. | |
principal.resource.name | La valeur est dérivée du message du journal. | |
principal.resource.type | La valeur est codée en dur dans le code du parseur pour certains événements et est dérivée du message du journal pour d'autres. | |
principal.user.email_addresses | La valeur est dérivée du message du journal. | |
principal.user.userid | La valeur est dérivée du message du journal. | |
security_result.action | La valeur est dérivée du message du journal. | |
security_result.description | La valeur est dérivée du message du journal. | |
security_result.rule_name | La valeur est dérivée du message du journal. | |
security_result.severity | La valeur est dérivée du message du journal. | |
security_result.severity_details | La valeur est dérivée du message du journal. | |
security_result.summary | La valeur est dérivée du message du journal. | |
src.ip | La valeur est dérivée du message du journal. | |
src.location.country_or_region | La valeur est dérivée du message du journal. | |
src.port | La valeur est dérivée du message du journal. | |
target.asset.hostname | La valeur est dérivée du message du journal. | |
target.asset.ip | La valeur est dérivée du message du journal. | |
target.hostname | La valeur est dérivée du message du journal. | |
target.ip | La valeur est dérivée du message du journal. | |
target.port | La valeur est dérivée du message du journal. | |
target.process.command_line | La valeur est dérivée du message du journal. | |
target.process.pid | La valeur est dérivée du message du journal. | |
target.resource.id | La valeur est dérivée du message du journal. | |
target.url | La valeur est dérivée du message du journal. | |
target.user.userid | La valeur est dérivée du message du journal. |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.