Collecter les journaux F5 BIG-IP ASM

Compatible avec :

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.
  1. Connectez-vous à la consoleGoogle Cloud et sélectionnez le projet Google Cloud associé à votre instance Google SecOps.
  2. Accédez à IAM et administration > Comptes de service.
  3. Cliquez sur Créer un compte de service.
  4. 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).
  5. Cliquez sur Créer et continuer.
  6. Dans la section Autoriser ce compte de service à accéder au projet, cliquez sur Sélectionner un rôle, puis sélectionnez Éditeur Chronicle.
  7. Cliquez sur Continue (Continuer), puis sur Done (OK).
  8. Cliquez sur le compte de service que vous avez créé, puis accédez à l'onglet Clés.
  9. Cliquez sur Ajouter une clé > Créer une clé.
  10. Sélectionnez JSON, puis cliquez sur Créer. Le fichier de clé est téléchargé sur votre ordinateur.
  11. Enregistrez le fichier de clé sous le nom ingestion-auth.json dans le répertoire du collecteur Bindplane (/opt/observiq-otel-collector/ingestion-auth.json sous Linux ou C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json sous Windows), ou mettez à jour creds_file_path dans config.yaml pour qu'il corresponde au chemin d'accès où vous l'enregistrez.
  12. 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)

  1. Connectez-vous à la console Google SecOps.
  2. 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.
  3. Téléchargez le fichier d'authentification d'ingestion.
  4. 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

  1. Connectez-vous à la console Google SecOps.
  2. Accédez à Paramètres > Administration > Profil. Si vous utilisez une plate-forme SIEM uniquement, accédez à Paramètres > Profil.
  3. Copiez et enregistrez le numéro client de la section Détails de l'organisation.

Installer l'agent BindPlane

Installation de Windows

  1. Ouvrez l'invite de commande ou PowerShell en tant qu'administrateur.
  2. Exécutez la commande suivante :

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    

Installation sous Linux

  1. Ouvrez un terminal avec des droits d'accès racine ou sudo.
  2. 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

Configurer l'agent Bindplane pour ingérer Syslog et l'envoyer à Google SecOps

  1. Accédez au fichier de configuration :

    1. 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.
    2. Ouvrez le fichier à l'aide d'un éditeur de texte (par exemple, nano, vi ou Notepad).
  2. 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:
            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_labels
    
  3. Remplacez le port et l'adresse IP selon les besoins de votre infrastructure.

  4. Remplacez <LOCATION> par la région de votre instance Google SecOps (par exemple, us, europe ou asia-southeast1). L'exportateur ajoute cette valeur en préfixe à chronicle.googleapis.com.

  5. Remplacez <PROJECT_NUMBER> par le numéro de projet indiqué dans IAM et administration > Paramètres.

  6. Remplacez <customer_id> par le numéro client réel.

  7. Remplacez /path/to/ingestion-authentication-file.json par 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 exporters par le code suivant. Définissez creds sur le chemin d'accès au fichier d'authentification d'ingestion. Si votre instance se trouve en dehors des États-Unis, remplacez malachiteingestion-pa.googleapis.com par 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-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 la journalisation à distance sur F5 BIG-IP ASM

  1. Connectez-vous à l'interface utilisateur Web de la console ASM.
  2. Accédez à Security > Event Logs > Logging Profiles (Sécurité > Journaux d'événements > Profils de journalisation).
  3. Cliquez sur Créer.
  4. 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 : 514 est 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 entre LOG_LOCAL0 et LOG_LOCAL7).
  5. Cliquez sur Terminé.

Associer un profil de journalisation à une stratégie de sécurité

  1. Cliquez sur Local Traffic > Virtual Servers (Trafic local > Serveurs virtuels).
  2. Cliquez sur le nom du serveur virtuel utilisé par la stratégie de sécurité.
  3. Dans le menu Sécurité, sélectionnez Règles.
  4. 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.
  5. Assurez-vous que le paramètre Profil de journal est défini sur Activé.
  6. 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é).
  7. 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.