Raccogli i log di WinSCP

Supportato in:

Google SecOps SIEM

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

WinSCP è un client SFTP, SCP e FTP open source per Windows che genera log di trasferimento file, autenticazione e log delle attività di sessione. L'agente Bindplane raccoglie i file di log delle sessioni di WinSCP direttamente dal file system locale.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

• Un'istanza Google SecOps
• Windows Server 2016 o versioni successive con supporto del servizio observiq-otel-collector
• Se l'esecuzione avviene tramite un proxy, assicurati che le porte del firewall siano aperte in base ai requisiti dell'agente Bindplane
• Un computer Windows che esegue WinSCP con il logging abilitato

Recupera le credenziali di Google SecOps per l'agente Bindplane

Per autenticare l'agente Bindplane in Google SecOps, scegli uno dei seguenti metodi:

• Nuovi deployment: utilizza l'API Chronicle (opzione 1).
• Deployment precedenti: continua a utilizzare il file di autenticazione dell'importazione (opzione 2) fino alla disattivazione dell'API Ingestion il 20 luglio 2027.

Opzione 1: crea un account di servizio per l'API Chronicle (consigliata)

1. Accedi alla Google Cloud console e seleziona il Google Cloud progetto collegato alla tua istanza Google SecOps.
2. Vai a IAM e amministrazione > Service account.
3. Fai clic su Crea service account.
4. Fornisci i seguenti dettagli di configurazione:
   • Nome account di servizio: inserisci un nome per l'account (ad esempio, bindplane-ingest).
   • Descrizione del service account: inserisci una descrizione (ad esempio, Bindplane agent log ingestion).
5. Fai clic su Crea e continua.
6. Nella sezione Concedi a questo account di servizio l'accesso al progetto, fai clic su Seleziona un ruolo e seleziona Editor Chronicle.
7. Fai clic su Continua e poi su Fine.
8. Fai clic sul account di servizio che hai creato, quindi vai alla scheda Chiavi.
9. Fai clic su Aggiungi chiave > Crea nuova chiave.
10. Seleziona JSON e fai clic su Crea. Il file della chiave viene scaricato sul computer.
11. Salva il file della chiave come ingestion-auth.json nella directory del raccoglitore Bindplane (/opt/observiq-otel-collector/ingestion-auth.json su Linux o C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json su Windows) oppure aggiorna creds_file_path in config.yaml in modo che corrisponda al percorso in cui lo salvi.
12. Vai a IAM e amministrazione > Impostazioni e copia il numero di progetto. Ti servirà per la configurazione dell'esportatore.

Nota: la chiave JSON è una credenziale. Limita l'accesso al file sull'host Bindplane e ruota la chiave in base alle norme della tua organizzazione.

Opzione 2: scarica il file di autenticazione dell'importazione (legacy)

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

Nota: questo file autentica l'agente nell'API Ingestion legacy (malachiteingestion-pa.googleapis.com), la cui fine del ciclo di vita è prevista da Google per il 20 luglio 2027. Pianifica di passare all'opzione 1 prima di questa data.

Recupera 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 dell'organizzazione.

   **Nota**: l'ID cliente è necessario per configurare l'esportatore dell'agente Bindplane.

Installa l'agente Bindplane

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

Installazione di Windows

1. Apri 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.

Risorse di installazione aggiuntive

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

Nota: la configurazione dell'esportatore dell'API Chronicle richiede il raccoglitore Bindplane versione 1.106.0 o successive. I comandi precedenti installano l'ultima release. Se stai aggiornando un'installazione esistente, esegui l'upgrade del raccoglitore prima di modificare la configurazione.

Configura l'agente Bindplane per importare i log e inviarli a Google SecOps

Individua il file di configurazione

• 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:
    filelog:
      include:
        - C:\Logs\WinSCP\*.log
      start_at: beginning
  
  exporters:
    chronicle/winscp:
      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
      creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: chronicle.googleapis.com
      log_type: WINSCP
      raw_log_field: body
      ingestion_labels:
        env: production
  
  service:
    pipelines:
      logs/winscp_to_chronicle:
        receivers:
          - filelog
        exporters:
          - chronicle/winscp
  

Parametri di configurazione

Sostituisci i seguenti segnaposto:

• Configurazione del ricevitore:

  • filelog: il tipo di ricevitore per la raccolta dei file di log dal disco
  • include: elenco dei percorsi dei file da monitorare. Imposta questo valore sulla posizione in cui WinSCP scrive i log delle sessioni (ad esempio, C:\Logs\WinSCP\*.log)
  • start_at: imposta su beginning per leggere i log esistenti o end per leggere solo le nuove voci

• Configurazione dell'esportatore:

  • winscp: nome descrittivo dell'esportatore
  • creds_file_path: percorso completo del file della chiave JSON del account di servizio (opzione 1):
    • Windows: C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
  • <customer_id>: ID cliente del passaggio precedente
  • location: sostituisci <LOCATION> con la regione della tua istanza Google SecOps (ad esempio, us, europe o asia-southeast1). L'esportatore antepone chronicle.googleapis.com a questo valore. Per l'elenco completo, consulta Endpoint regionali.
  • project: sostituisci <PROJECT_NUMBER> con il numero di progetto da IAM e amministrazione > Impostazioni.
  • endpoint: mantieni l'impostazione chronicle.googleapis.com.
  • WINSCP: tipo di log esattamente come appare in Chronicle
  • ingestion_labels: etichette facoltative in formato YAML (ad esempio, env: production)

• Configurazione della pipeline:

  • winscp_to_chronicle: nome descrittivo della pipeline

Esportatore dell'API Ingestion legacy

• Se utilizzi il file di autenticazione dell'importazione dell'opzione 2, sostituisci il blocco exporters con il seguente. Imposta creds_file_path sul percorso del file di autenticazione dell'importazione e, se la tua istanza si trova al di fuori degli Stati Uniti, sostituisci malachiteingestion-pa.googleapis.com con l'endpoint regionale (ad esempio, europe-malachiteingestion-pa.googleapis.com).

  exporters:
    chronicle/winscp:
      compression: gzip
      creds_file_path: 'C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json'
      customer_id: '<customer_id>'
      endpoint: malachiteingestion-pa.googleapis.com
      log_type: WINSCP
      raw_log_field: body
      ingestion_labels:
        env: production
  

Nota: questo esportatore smetterà di funzionare quando l'API Ingestion verrà disattivata il 20 luglio 2027.

Salva il file di configurazione

• Dopo la modifica, salva il file:
  • Windows: fai clic su File > Salva

Riavvia l'agente Bindplane per applicare le modifiche

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 verificare la presenza di errori:

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

Configura l'esportazione dei log di WinSCP

WinSCP scrive i log delle sessioni in una posizione configurata dall'utente. Devi abilitare il logging in WinSCP e indirizzare l'agente Bindplane alla directory dei log.

1. Apri WinSCP sul computer Windows.
2. Vai a Opzioni > Preferenze > Logging.
3. Abilita il logging delle sessioni:
   • Seleziona Abilita il logging delle sessioni a livello.
   • Seleziona il livello di logging Normale o Debug 1.
   • Imposta il nome del file di log su un percorso centralizzato (ad esempio, C:\Logs\WinSCP\winscp.log).
4. Fai clic su OK per salvare le impostazioni.

5. Crea la directory dei log, se non esiste:

   mkdir C:\Logs\WinSCP
   

6. Verifica che WinSCP scriva i file di log nella directory configurata dopo aver eseguito una sessione di trasferimento file.

7. Assicurati che il percorso include dell'agente Bindplane in config.yaml corrisponda alla directory dei log.

   Nota: per impostazione predefinita, WinSCP genera file di log delle sessioni XML (estensione .log). Se raccogli i log di più utenti, puoi utilizzare un percorso con caratteri jolly come C:\Users\*\AppData\Roaming\WinSCP\*.log nella configurazione dell'agente Bindplane. Il account di servizio dell'agente Bindplane deve avere accesso in lettura alla directory dei log.

Tabella di mappatura UDM

Campo log	Mappatura UDM	Logica
directory,console,consoleinstance,public_key,script,hostkey,total_size	additional.fields	Campi personalizzati aggiuntivi per l'evento
description	metadata.description	Descrizione dell'evento
timestamp	metadata.event_timestamp	Timestamp in cui si è verificato l'evento
	metadata.event_type	Il tipo di evento
src_ip	principal.asset.ip	Indirizzo IP della risorsa associata al principale
local_file	principal.file.full_path	Percorso completo del file associato al principale
src_ip	principal.ip	Indirizzo IP del principale
command_line	principal.process.command_line	Riga di comando utilizzata per avviare il processo
username	principal.user.userid	ID utente del principale
transfer_speed,result	security_result.detection_fields	Campi relativi al rilevamento nel risultato di sicurezza
file,target_file	target.file.full_path	Percorso completo del file di destinazione
file_type	target.file.mime_type	Tipo MIME del file di destinazione
file_size	target.file.size	Dimensioni del file di destinazione in byte
	metadata.product_name	Nome del prodotto che ha generato l'evento
	metadata.vendor_name	Nome del fornitore del prodotto

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.