Raccogli i log di CrushFTP

Parser Version: 1.0

Supportato in:

Questo documento spiega come importare i log di CrushFTP in Google Security Operations utilizzando l'agente Bindplane.

CrushFTP è un server di trasferimento file aziendale che genera messaggi syslog per i trasferimenti di file, l'autenticazione degli utenti e gli eventi di sistema. Il parser estrae i campi e li mappa al modello UDM (Unified Data Model).

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Windows Server 2016 o versioni successive o host Linux con systemd
  • Connettività di rete tra l'agente Bindplane e il server CrushFTP
  • Se l'agente viene eseguito dietro un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
  • Accesso privilegiato alla UI web di CrushFTP

Ottieni il file di autenticazione dell'acquisizione di Google SecOps

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni SIEM > Agenti di raccolta.
  3. Scarica il file di autenticazione dell'acquisizione.
  4. Salva il file in modo sicuro sul sistema in cui verrà installato l'agente Bindplane.

Recuperare l'ID cliente Google SecOps

  1. Accedi alla console Google SecOps.
  2. Vai a Impostazioni SIEM > Profilo.
  3. Copia e salva l'ID cliente dalla sezione Dettagli organizzazione.

Installa l'agente Bindplane

Installa l'agente Bindplane sul tuo sistema operativo Windows o Linux seguendo le istruzioni riportate di seguito.

Installazione di Windows

  1. Apri il prompt dei comandi o PowerShell come amministratore.
  2. Esegui questo comando:

    msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
    
  3. Attendi il completamento dell'installazione.

  4. Verifica l'installazione eseguendo:

    sc query observiq-otel-collector
    

    Il servizio dovrebbe essere visualizzato come IN ESECUZIONE.

Installazione di Linux

  1. Apri un terminale con privilegi root o sudo.
  2. Esegui questo comando:

    sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
    
  3. Attendi il completamento dell'installazione.

  4. Verifica l'installazione eseguendo:

    sudo systemctl status observiq-otel-collector
    

    Il servizio dovrebbe essere visualizzato come attivo (in esecuzione).

Risorse aggiuntive per l'installazione

Per ulteriori opzioni di installazione e risoluzione dei problemi, consulta la guida all'installazione dell'agente Bindplane.

Configura l'agente Bindplane per importare il syslog e inviarlo a Google SecOps

Individua il file di configurazione

  • Linux:

    sudo nano /etc/bindplane-agent/config.yaml
    
  • Windows:

    notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
    

Modifica il file di configurazione

  • Sostituisci l'intero contenuto di config.yaml con la seguente configurazione:

    receivers:
        udplog:
            listen_address: "0.0.0.0:514"
    
    exporters:
        chronicle/crushftp:
            compression: gzip
            creds_file_path: '/etc/bindplane-agent/ingestion-auth.json'
            customer_id: '<customer_id>'
            endpoint: malachiteingestion-pa.googleapis.com
            log_type: CRUSHFTP
            raw_log_field: body
    
    service:
        pipelines:
            logs/crushftp_to_chronicle:
                receivers:
                    - udplog
                exporters:
                    - chronicle/crushftp
    

Parametri di configurazione

Sostituisci i seguenti segnaposto:

  • Configurazione del destinatario:

    • listen_address: indirizzo IP e porta su cui ascoltare:
      • 0.0.0.0 per ascoltare su tutte le interfacce (consigliato)
      • La porta 514 è la porta syslog standard (richiede l'accesso root su Linux; utilizza 1514 per l'accesso non root)
  • Configurazione dell'esportatore:

    • creds_file_path: Percorso completo del file di autenticazione dell'acquisizione:
      • Linux: /etc/bindplane-agent/ingestion-auth.json
      • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
    • customer_id: ID cliente copiato dalla console Google SecOps
    • endpoint: URL dell'endpoint regionale:
      • Stati Uniti: malachiteingestion-pa.googleapis.com
      • Europa: europe-malachiteingestion-pa.googleapis.com
      • Asia: asia-southeast1-malachiteingestion-pa.googleapis.com
      • Consulta Endpoint regionali per l'elenco completo

Salva il file di configurazione

  • Dopo la modifica, salva il file:
    • Linux: premi Ctrl+O, poi Enter e infine Ctrl+X.
    • Windows: fai clic su File > Salva.

Riavvia l'agente Bindplane per applicare le modifiche

  • Per riavviare l'agente Bindplane in Linux, esegui questo comando:

    sudo systemctl restart observiq-otel-collector
    
    1. Verifica che il servizio sia in esecuzione:

      sudo systemctl status observiq-otel-collector
      
    2. Controlla i log per individuare eventuali errori:

      sudo journalctl -u observiq-otel-collector -f
      
  • Per riavviare l'agente Bindplane in Windows, scegli una delle seguenti opzioni:

    • Prompt dei comandi o PowerShell come amministratore:

      net stop observiq-otel-collector && net start observiq-otel-collector
      
    • Console dei servizi:

      1. Premi Win+R, digita services.msc e premi Invio.
      2. Individua observIQ OpenTelemetry Collector.
      3. Fai clic con il tasto destro del mouse e seleziona Riavvia.
      4. Verifica che il servizio sia in esecuzione:

        sc query observiq-otel-collector
        
      5. Controlla i log per individuare eventuali errori:

        type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
        

Configura il syslog di CrushFTP

  1. Accedi all'interfaccia utente web di CrushFTP.
  2. Vai alla sezione Preferences > Logging > Syslog.
  3. Fornisci i seguenti dettagli di configurazione:
    • Seleziona la casella di controllo Attiva.
    • Host: inserisci l'indirizzo IP dell'agente Bindplane.
    • Porta: inserisci il numero di porta dell'agente Bindplane.
    • Protocollo: seleziona UDP (o TCP, a seconda della configurazione di Bindplane).
    • Logging Provider (Provider di logging): seleziona SysLog.
  4. Fai clic su Salva impostazioni.

Tabella di mappatura UDM

Campo log Mappatura UDM Logica
exists_label additional.fields Unita
msg metadata.description Mappato direttamente
timestamp metadata.event_timestamp Analizzato come MM/dd/yyyy HH:mm:ss.SSS
has_principal metadata.event_type Mappatura: true → NETWORK_CONNECTION, true → FILE_UNCATEGORIZED, true → STATUS_UPDATE
prod_event_type metadata.product_event_type Mappato direttamente
http_method network.http.method Mappata direttamente
Response_code network.http.response_code Rinominate/mappate
sessionid network.session_id Mappato direttamente
src_ip principal.asset.ip Unita
group principal.group.group_display_name Mappato direttamente
src_host principal.hostname Mappato direttamente
src_ip principal.ip Unita
src_port principal.port Rinominate/mappate
email principal.user.email_addresses Mappato: ^.+@.+$ → email
owner principal.user.userid Mappata direttamente
Description security_result.description Mappato direttamente
http_version_label security_result.detection_fields Unita
domainname target.asset.hostname Mappata direttamente
target_ip target.asset.ip Unita
url target.file.full_path Mappata direttamente
name target.file.names Unita
size target.file.size Rinominate/mappate
domainname target.hostname Mappato direttamente
target_ip target.ip Unita
target_port target.port Rinominate/mappate
modified_label target.resource.attribute.labels Unita
permissions_label target.resource.attribute.labels Unita
privs_label target.resource.attribute.labels Unita
target_url target.url Mappato direttamente
N/D metadata.event_type Costante: GENERIC_EVENT
N/D metadata.product_name Costante: CrushFTP
N/D metadata.vendor_name Costante: CrushFTP

Log delle modifiche

Visualizza il log delle modifiche per questo parser

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.