Collecter les journaux F5 BIG-IP ASM
Ce document explique comment ingérer les journaux F5 BIG-IP Application Security Manager (ASM) dans Google Security Operations à l'aide de BindPlane. L'analyseur gère différents formats de journaux (syslog, CSV, CEF, etc.) et les normalise au format UDM. Il utilise des modèles grok et des extractions clé-valeur pour analyser les champs, un filtrage XML pour les détails des violations, une logique conditionnelle pour la catégorisation des événements et le mappage de la gravité, et fusionne les champs extraits dans le schéma UDM.
Avant de commencer
- Assurez-vous de disposer d'une instance Google Security Operations.
- Assurez-vous d'utiliser Windows 2016 ou une version ultérieure, ou un hôte Linux avec
systemd. - Si vous exécutez l'outil derrière un proxy, assurez-vous que les ports du pare-feu sont ouverts.
- Assurez-vous de disposer d'un accès privilégié à F5 BIG-IP ASM.
Obtenir des identifiants Google SecOps pour l'agent BindPlane
Pour authentifier l'agent Bindplane auprès de Google SecOps, choisissez l'une des méthodes suivantes :
- Nouveaux déploiements : utilisez l'API Chronicle (option 1).
- Anciens déploiements : continuez à utiliser le fichier d'authentification d'ingestion (option 2) jusqu'à l'arrêt de l'API Ingestion le 20 juillet 2027.
Option 1 : Créer un compte de service pour l'API Chronicle (recommandé)
- Connectez-vous à la consoleGoogle Cloud et sélectionnez le projet Google Cloud associé à votre instance Google SecOps.
- Accédez à IAM et administration > Comptes de service.
- Cliquez sur Créer un compte de service.
- Fournissez les informations de configuration suivantes :
- Nom du compte de service : saisissez un nom pour le compte (par exemple,
bindplane-ingest). - Description du compte de service : saisissez une description (par exemple,
Bindplane agent log ingestion).
- Nom du compte de service : saisissez un nom pour le compte (par exemple,
- Cliquez sur Créer et continuer.
- Dans la section Autoriser ce compte de service à accéder au projet, cliquez sur Sélectionner un rôle, puis sélectionnez Éditeur Chronicle.
- Cliquez sur Continue (Continuer), puis sur Done (OK).
- Cliquez sur le compte de service que vous avez créé, puis accédez à l'onglet Clés.
- Cliquez sur Ajouter une clé > Créer une clé.
- Sélectionnez JSON, puis cliquez sur Créer. Le fichier de clé est téléchargé sur votre ordinateur.
- Enregistrez le fichier de clé sous le nom
ingestion-auth.jsondans le répertoire du collecteur Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsonsous Linux ouC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonsous Windows), ou mettez à jourcreds_file_pathdansconfig.yamlpour qu'il corresponde au chemin d'accès où vous l'enregistrez. - Accédez à IAM et administration > Paramètres, puis copiez le numéro du projet. Vous en aurez besoin pour configurer l'exportateur.
Option 2 : Télécharger le fichier d'authentification d'ingestion (ancien)
- Connectez-vous à la console Google SecOps.
- Accédez à Paramètres > Gestion des données > Agents de collecte. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > 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 où l'agent BindPlane sera installé.
Obtenir le numéro client Google SecOps
- Connectez-vous à la console Google SecOps.
- Accédez à Paramètres > Administration > Profil. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Profil.
- Copiez et enregistrez le numéro client de la section Détails de l'organisation.
Installer l'agent BindPlane
Installation de Windows
- Ouvrez l'invite de commande 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 sous Linux
- Ouvrez un terminal avec des droits d'accès racine 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 découvrir d'autres 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 :
- Trouvez le fichier
config.yaml. En général, il se trouve dans le répertoire/opt/observiq-otel-collector/sous Linux ou dans le répertoire d'installation sous Windows. - Ouvrez le fichier à l'aide d'un éditeur de texte (par exemple,
nano,viou Notepad).
- Trouvez le fichier
Modifiez le fichier
config.yamlcomme suit :receivers: udplog: # Replace the port and IP address as required listen_address: "0.0.0.0:514" exporters: chronicle/chronicle_w_labels: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds: '/path/to/ingestion-authentication-file.json' # Replace with your actual customer ID from Step 2 customer_id: <customer_id> endpoint: chronicle.googleapis.com # Add optional ingestion labels for better organization ingestion_labels: log_type: F5_ASM raw_log_field: body service: pipelines: logs/source0__chronicle_w_labels-0: receivers: - udplog exporters: - chronicle/chronicle_w_labelsRemplacez le port et l'adresse IP selon les besoins de votre infrastructure.
Remplacez
<LOCATION>par la région de votre instance Google SecOps (par exemple,us,europeouasia-southeast1). L'exportateur ajoute cette valeur en préfixe àchronicle.googleapis.com.Remplacez
<PROJECT_NUMBER>par le numéro de projet indiqué dans IAM et administration > Paramètres.Remplacez
<customer_id>par le numéro client réel.Remplacez
/path/to/ingestion-authentication-file.jsonpar le chemin d'accès où le fichier de clé du compte de service (option 1) a été enregistré dans la section Obtenir des identifiants Google SecOps pour l'agent BindPlane.
Ancien exportateur d'API d'ingestion
Si vous utilisez le fichier d'authentification d'ingestion de l'option 2, remplacez le bloc
exporterspar le code suivant. Définissezcredssur le chemin d'accès au fichier d'authentification d'ingestion. Si votre instance se trouve en dehors des États-Unis, remplacezmalachiteingestion-pa.googleapis.compar votre point de terminaison régional (par exemple,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/chronicle_w_labels: compression: gzip # Adjust the path to the credentials file you downloaded in Step 1 creds: '/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 ingestion_labels: log_type: F5_ASM raw_log_field: body
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-agentPour 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 la journalisation à distance sur F5 BIG-IP ASM
- Connectez-vous à l'interface utilisateur Web de la console ASM.
- Accédez à Security > Event Logs > Logging Profiles (Sécurité > Journaux d'événements > Profils de journalisation).
- Cliquez sur Créer.
Fournissez les informations de configuration suivantes :
- Nom du profil : saisissez un nom unique pour le profil.
- Sélectionnez Sécurité des applications.
- Dans l'onglet "Sécurité des applications", sélectionnez Avancé (si des configurations supplémentaires sont requises).
- Destination de stockage : sélectionnez Stockage distant.
- Format de journalisation : sélectionnez "Common Event Format (CEF)".
- Effacez le stockage local.
- Protocole : sélectionnez UDP ou TCP (selon la configuration de votre agent Bindplane).
- Adresses du serveur : saisissez l'adresse IP de l'agent BindPlane.
- Port :
514est sélectionné par défaut. Mettez à jour le paramètre de port en fonction de la configuration de votre agent Bindplane. - Cliquez sur Ajouter.
- Sélectionnez Garantir la journalisation.
- Sélectionnez Signaler les anomalies détectées.
- Facility (Établissement) : sélectionnez
LOG_LOCAL6(vous pouvez éventuellement sélectionner la catégorie d'établissement du trafic consigné, les valeurs possibles étant comprises entreLOG_LOCAL0etLOG_LOCAL7).
Cliquez sur Terminé.
Associer un profil de journalisation à une stratégie de sécurité
- Cliquez sur Local Traffic > Virtual Servers (Trafic local > Serveurs virtuels).
- Cliquez sur le nom du serveur virtuel utilisé par la stratégie de sécurité.
- Dans le menu Sécurité, sélectionnez Règles.
- Assurez-vous que le paramètre Règle de sécurité de l'application est activé et que l'option Règle est définie sur la règle de sécurité de votre choix.
- Assurez-vous que le paramètre Profil de journal est défini sur Activé.
- Dans la liste Available (Disponible), sélectionnez le profil à utiliser pour la stratégie de sécurité, puis déplacez-le vers la liste Selected (Sélectionné).
- Cliquez sur Mettre à jour.
Table de mappage UDM
| Champ du journal | Mappage UDM | Logique |
|---|---|---|
act |
security_result.action |
Si act est blocked, mappé sur BLOCK. Si act est passed ou legal, mappez sur ALLOW. Si act contient alerted, mappez vers QUARANTINE. Sinon, la valeur par défaut est ALLOW pour le format Splunk. |
app |
network.application_protocol |
Mappe directement vers HTTPS s'il est présent dans le journal brut. |
attack_type |
security_result.category_details, metadata.description |
Utilisé avec d'autres champs pour déterminer security_result.category. Si aucune autre description n'est disponible, elle devient la description de l'événement. Pour les journaux au format Splunk, il permet de déterminer la catégorie et le résumé si violations est vide. |
client_ip |
principal.ip, principal.asset.ip |
Mappage direct à l'adresse IP principale. |
cn1 |
network.http.response_code |
Correspond directement au code de réponse HTTP. |
cn2 |
security_result.severity_details |
Correspond directement aux détails de la gravité du résultat de sécurité. Utilisé avec response_code pour déterminer si un événement est une alerte. |
column1 |
principal.ip, principal.asset.ip |
Mappe vers l'adresse IP du compte principal pour certains journaux au format CSV. |
column2 |
target.port |
Mappe vers le port cible pour certains journaux au format CSV. |
column3 |
target.ip, target.asset.ip |
Mappe vers l'adresse IP cible pour certains journaux au format CSV. |
column4 |
security_result.severity |
Mappe vers la gravité du résultat de sécurité pour certains journaux au format CSV. Les valeurs Information, Informational, 0 et 4 sont mappées sur INFORMATIONAL. Warning, 1, 3 correspondent à MEDIUM. Error, 2 sont mappés sur ERROR. Critical, CRITICAL, critical correspondent à CRITICAL. |
column7 |
security_result.detection_fields, network.http.response_code |
Contient des données XML. viol_name dans request-violations est extrait et ajouté en tant que champs de détection avec la clé Request Violation Name_index. viol_name dans response_violations est extrait et ajouté en tant que champs de détection avec la clé Response Violation Name_index. response_code dans response_violations correspond à network.http.response_code. |
column8 |
security_result.rule_name |
Correspond au nom de la règle de résultat de sécurité pour certains journaux au format CSV. |
cs1 |
security_result.rule_name |
Correspond directement au nom de la règle de résultat de sécurité. |
cs2 |
security_result.summary |
Mappe directement au résumé du résultat de sécurité. |
cs5 |
principal.ip, principal.asset.ip, additional.fields |
Si cs5 contient une URL LDAP JNDI, elle est ajoutée en tant que champ supplémentaire avec la clé JNDI_LDAP_URL. Sinon, s'il contient des adresses IP séparées par une virgule, toute adresse IP différente de principal_ip est ajoutée en tant qu'adresse IP principale supplémentaire. |
cs6 |
principal.location.country_or_region |
Mappe directement vers le pays ou la région de l'établissement principal. |
data |
network.session_id, network.sent_bytes, network.tls.version |
Si elle est présente, elle est analysée au format JSON pour extraire sessionid, bits (mappé sur sent_bytes) et version. |
date_time |
metadata.event_timestamp |
Mappe directement au code temporel de l'événement après l'analyse et la conversion au format approprié. |
dest_ip |
target.ip, target.asset.ip |
Mappe directement vers l'adresse IP cible. |
dest_port |
target.port |
Mappe directement vers le port cible. |
dhost |
target.hostname |
Mappe directement au nom d'hôte cible. |
dpt |
target.port |
Mappe directement vers le port cible. |
dst |
target.ip |
Mappe directement vers l'adresse IP cible. |
dvc |
intermediary.ip |
Mappage direct à l'adresse IP intermédiaire. |
dvchost |
target.hostname, intermediary.hostname |
Mappe directement vers le nom d'hôte cible et le nom d'hôte intermédiaire. |
errdefs_msgno |
additional.fields |
Ajouté en tant que champ supplémentaire avec la clé errdefs_msgno. |
externalId |
additional.fields |
Ajouté en tant que champ supplémentaire avec la clé Support_Id. |
f5_host |
target.hostname, intermediary.hostname |
Mappe directement vers le nom d'hôte cible et le nom d'hôte intermédiaire. |
geo_info |
principal.location.country_or_region, security_result.detection_fields |
Correspond au pays ou à la région de l'emplacement principal. Également ajouté en tant que champ de détection avec la clé geo_info. |
host |
target.hostname |
Mappe directement au nom d'hôte cible. |
ids |
additional.fields |
Analysé en tant que liste d'ID d'assistance séparés par une virgule. Chaque ID est ajouté à un champ supplémentaire de type liste avec la clé supportid. |
ip_addr_intelli |
security_result.detection_fields |
Ajouté en tant que champ de détection avec la clé ip_addr_intelli. |
ip_client |
principal.ip |
Mappage direct à l'adresse IP principale. |
ip_route_domain |
principal.ip, principal.asset.ip |
La partie IP est extraite et mappée à l'adresse IP principale. |
irule |
security_result.rule_name |
Correspond directement au nom de la règle de résultat de sécurité. |
irule-version |
security_result.rule_version |
Mappe directement à la version de la règle de résultat de sécurité. |
level |
security_result.severity, security_result.severity_details |
Permet de déterminer la gravité du résultat de sécurité. error ou warning sont mappés sur HIGH. notice correspond à MEDIUM. information ou info sont mappés sur LOW. La valeur brute est également mappée à severity_details. |
logtime |
metadata.event_timestamp |
Correspond directement au code temporel de l'événement après l'analyse. |
management_ip_address, management_ip_address_2 |
intermediary.ip |
Mappage direct à l'adresse IP intermédiaire. |
method |
network.http.method |
Mappe directement à la méthode HTTP. |
msg |
security_result.summary, metadata.description |
Correspond directement au résumé des résultats de sécurité pour certains formats de journaux. Si aucune autre description n'est disponible, elle devient la description de l'événement. |
policy_name |
security_result.about.resource.name, security_result.rule_name |
Mappe directement au nom de la ressource de résultat de sécurité ou au nom de la règle. |
process |
target.application |
Mappe directement vers l'application cible. |
process_id |
principal.process.pid |
Mappe directement l'ID de processus principal. |
protocol |
network.application_protocol, network.ip_protocol, app_protocol |
Mappe directement au protocole d'application ou au protocole IP en fonction du format du journal. |
proxy_id |
security_result.rule_id |
Correspond directement à l'ID de règle du résultat de sécurité. |
query_string |
additional.fields |
Ajouté en tant que champ supplémentaire avec la clé query_string. |
referrer |
network.http.referral_url |
Mappage direct à l'URL de provenance HTTP. |
req_method |
network.http.method |
Mappe directement à la méthode HTTP. |
req_status |
security_result.action, security_result.action_details, security_result.detection_fields |
Si la valeur est blocked, security_result.action est mappé sur BLOCK. Si passed ou legal, mappez sur ALLOW. Si elle contient alerted, elle est mappée sur QUARANTINE. La valeur brute est également mappée sur action_details et ajoutée en tant que champ de détection avec la clé req_status. |
request |
target.url |
Mappe directement vers l'URL cible. |
requestMethod |
network.http.method |
Mappe directement à la méthode HTTP. |
resp |
security_result.detection_fields |
Ajouté en tant que champ de détection avec la clé resp. |
resp_code |
network.http.response_code |
Correspond directement au code de réponse HTTP. |
response |
security_result.summary |
Mappe directement au résumé du résultat de sécurité. |
response_code |
network.http.response_code |
Correspond directement au code de réponse HTTP. |
route_domain |
additional.fields |
Ajouté en tant que champ supplémentaire avec la clé route_domain. |
rt |
metadata.event_timestamp |
Correspond directement au code temporel de l'événement après l'analyse. |
sev |
security_result.severity, security_result.severity_details |
Permet de déterminer la gravité du résultat de sécurité. ERROR correspond à ERROR. La valeur brute est également mappée à severity_details. |
severity |
security_result.severity, security_result.severity_details |
Permet de déterminer la gravité du résultat de sécurité. Informational correspond à LOW, Error ou warning à HIGH, critical à CRITICAL, notice à MEDIUM, et information ou info à LOW. La valeur brute est également mappée à severity_details. |
sig_ids |
security_result.rule_id |
Correspond directement à l'ID de règle du résultat de sécurité. |
sig_names |
security_result.rule_name |
Correspond directement au nom de la règle de résultat de sécurité. |
snat_ip |
principal.nat_ip |
Mappe directement à l'adresse IP NAT principale. |
snat_port |
principal.nat_port |
Mappe directement au port NAT principal. |
src |
principal.ip, principal.asset.ip |
Mappage direct à l'adresse IP principale. |
spt |
principal.port |
Mappe directement au port principal. |
sub_violates |
security_result.about.resource.attribute.labels |
Ajouté en tant qu'étiquette avec la clé Sub Violations aux attributs de ressource de résultat de sécurité. |
sub_violations |
security_result.about.resource.attribute.labels |
Ajouté en tant qu'étiquette avec la clé Sub Violations aux attributs de ressource de résultat de sécurité. |
summary |
security_result.summary |
Mappe directement au résumé du résultat de sécurité. |
support_id |
metadata.product_log_id |
Préfixé par support_id - et mappé à l'ID du journal du produit. |
suid |
network.session_id |
Mappe directement vers l'ID de session réseau. |
suser |
principal.user.userid |
Mappe directement l'ID utilisateur principal. |
timestamp |
metadata.event_timestamp |
Mappe directement au code temporel de l'événement après l'analyse et la conversion au format approprié. |
unit_host |
principal.hostname, principal.asset.hostname |
Correspond directement au nom d'hôte principal. |
uri |
principal.url |
Mappage direct à l'URL du compte principal. |
user_id |
principal.user.userid |
Mappe directement l'ID utilisateur principal. |
user_name |
principal.user.user_display_name |
Mappe directement au nom à afficher de l'utilisateur principal. |
username |
principal.user.userid |
Mappe directement l'ID utilisateur principal. |
useragent |
network.http.user_agent, network.http.parsed_user_agent |
Correspond directement au user-agent HTTP. Également analysé et mappé au user-agent analysé. |
virtualserver |
network.tls.client.server_name |
Mappe directement au nom du serveur client TLS. |
violate_details |
security_result.detection_fields, network.http.response_code |
Contient des données XML. viol_name dans request-violations est extrait et ajouté en tant que champs de détection avec la clé Request Violation Name_index. viol_name dans response_violations est extrait et ajouté en tant que champs de détection avec la clé Response Violation Name_index. response_code dans response_violations correspond à network.http.response_code. |
violate_rate |
security_result.detection_fields |
Ajouté en tant que champ de détection avec la clé violate_rate. |
violation_rating |
security_result.about.resource.attribute.labels |
Ajouté en tant qu'étiquette avec la clé Violations Rating aux attributs de ressource de résultat de sécurité. |
violations |
security_result.description |
Correspond directement à la description du résultat de sécurité. Pour les journaux au format Splunk, il permet de déterminer le résumé, s'il est présent. |
virus_name |
security_result.threat_name |
Mappe directement au nom de la menace du résultat de sécurité. |
vs_name |
network.tls.client.server_name |
Mappe directement au nom du serveur client TLS. |
websocket_direction |
network.direction |
Si la valeur est clientToServer, elle est mappée sur INBOUND. Si la valeur est ServerToclient, elle est mappée sur OUTBOUND. |
websocket_message_type |
security_result.detection_fields |
Ajouté en tant que champ de détection avec la clé WebsocketMessageType. |
x_fwd_hdr_val |
principal.ip, principal.asset.ip |
Mappage direct à l'adresse IP principale. |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.