Raccogli i log di CrowdStrike FileVantage

Parser Version: 1.0

Supportata in:

Questo documento spiega come importare i log di CrowdStrike FileVantage in Google Security Operations utilizzando Cloud Storage. CrowdStrike FileVantage è una soluzione di monitoraggio dell'integrità dei file che monitora le modifiche a file e directory critici nel tuo ambiente.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Un progetto Google Cloud con l'API Storage di Cloud Storage abilitata
  • Autorizzazioni per creare e gestire i bucket Cloud Storage
  • Autorizzazioni per gestire le policy di Identity and Access Management (IAM) sui bucket Cloud Storage
  • Autorizzazioni per creare servizi Cloud Run, argomenti Pub/Sub e job Cloud Scheduler
  • Accesso con privilegi alla console CrowdStrike Falcon

crea un bucket Cloud Storage

  1. Vai alla consoleGoogle Cloud .
  2. Seleziona il tuo progetto o creane uno nuovo.
  3. Nel menu di navigazione, vai a Cloud Storage > Bucket.
  4. Fai clic su Crea bucket.
  5. Fornisci i seguenti dettagli di configurazione:

    Impostazione Valore
    Assegna un nome al bucket Inserisci un nome globalmente univoco (ad esempio crowdstrike-filevantage-logs)
    Tipo di località Scegli in base alle tue esigenze (Regione, A due regioni, Multiregionale)
    Località Seleziona la località (ad esempio us-central1)
    Classe di archiviazione Standard (consigliato per i log ad accesso frequente)
    Controllo degli accessi Uniforme (consigliato)
    Strumenti di protezione (Facoltativo) Abilita il controllo delle versioni degli oggetti o la policy di conservazione
  6. Fai clic su Crea.

Raccogli le credenziali API di CrowdStrike FileVantage

  1. Accedi alla console CrowdStrike Falcon.
  2. Vai ad Assistenza e risorse > Client e chiavi API.
  3. Fai clic su Aggiungi nuovo client API.
  4. Fornisci i seguenti dettagli di configurazione:
    • Nome client: inserisci un nome descrittivo (ad esempio Google SecOps FileVantage Integration).
    • Descrizione: inserisci una breve descrizione dello scopo dell'integrazione.
    • Ambiti API: seleziona Falcon FileVantage:read.
  5. Fai clic su Aggiungi per completare la procedura.
  6. Copia e salva in un luogo sicuro i seguenti dettagli:

    • ID client
    • Client secret
    • URL di base (determina la regione cloud)

Verifica le autorizzazioni

Per verificare che l'account disponga delle autorizzazioni richieste:

  1. Accedi alla console CrowdStrike Falcon.
  2. Vai ad Assistenza e risorse > Client e chiavi API.
  3. Se riesci a visualizzare la pagina Client e chiavi API e a creare nuovi client API, disponi delle autorizzazioni necessarie.
  4. Se non riesci ad accedere a questa pagina, contatta l'amministratore di CrowdStrike per concedere il ruolo di amministratore di Falcon.

Testa l'accesso all'API

  • Testa le tue credenziali prima di procedere con l'integrazione:

    # Replace with your actual credentials
    FALCON_CLIENT_ID="your-client-id"
    FALCON_CLIENT_SECRET="your-client-secret"
    FALCON_BASE_URL="https://api.crowdstrike.com"
    
    # Get OAuth token
    TOKEN=$(curl -s -X POST "${FALCON_BASE_URL}/oauth2/token" \
      -H "Content-Type: application/x-www-form-urlencoded" \
      -d "client_id=${FALCON_CLIENT_ID}&client_secret=${FALCON_CLIENT_SECRET}&grant_type=client_credentials" \
      | grep -o '"access_token":"[^"]*' | cut -d'"' -f4)
    
    # Test FileVantage API access
    curl -v -H "Authorization: Bearer ${TOKEN}" \
      "${FALCON_BASE_URL}/filevantage/queries/changes/v3?limit=1"
    

Crea un account di servizio per la funzione Cloud Run

La funzione Cloud Run richiede un account di servizio con le autorizzazioni per scrivere nel bucket Cloud Storage ed essere richiamata da Pub/Sub.

Crea service account

  1. Nella console Google Cloud , vai a IAM e amministrazione > Account di servizio.
  2. Fai clic su Crea account di servizio.
  3. Fornisci i seguenti dettagli di configurazione:
    • Nome service account: inserisci crowdstrike-filevantage-sa.
    • Descrizione service account: inserisci Service account for Cloud Run function to collect CrowdStrike FileVantage logs.
  4. Fai clic su Crea e continua.
  5. Nella sezione Concedi a questo account di servizio l'accesso al progetto, aggiungi i seguenti ruoli:
    1. Fai clic su Seleziona un ruolo.
    2. Cerca e seleziona Storage Object Admin.
    3. Fai clic su + Aggiungi un altro ruolo.
    4. Cerca e seleziona Cloud Run Invoker.
    5. Fai clic su + Aggiungi un altro ruolo.
    6. Cerca e seleziona Cloud Functions Invoker.
  6. Fai clic su Continua.
  7. Fai clic su Fine.

Questi ruoli sono obbligatori per:

  • Storage Object Admin: scrive i log nel bucket Cloud Storage e gestisce i file di stato
  • Cloud Run Invoker: consente a Pub/Sub di richiamare la funzione
  • Cloud Functions Invoker: consente la chiamata della funzione

Concedi le autorizzazioni IAM sul bucket Cloud Storage

Concedi al account di servizio le autorizzazioni in scrittura sul bucket Cloud Storage:

  1. Vai a Cloud Storage > Bucket.
  2. Fai clic sul nome del bucket (ad esempio crowdstrike-filevantage-logs).
  3. Vai alla scheda Autorizzazioni.
  4. Fai clic su Concedi l'accesso.
  5. Fornisci i seguenti dettagli di configurazione:
    • Aggiungi entità: inserisci l'indirizzo email del account di servizio (ad esempio crowdstrike-filevantage-sa@PROJECT_ID.iam.gserviceaccount.com).
    • Assegna i ruoli: seleziona Storage Object Admin.
  6. Fai clic su Salva.

Crea argomento Pub/Sub

Crea un argomento Pub/Sub in cui Cloud Scheduler pubblicherà i messaggi e a cui la funzione Cloud Run si iscriverà.

  1. Nella console Google Cloud , vai a Pub/Sub > Argomenti.
  2. Fai clic su Crea argomento.
  3. Fornisci i seguenti dettagli di configurazione:
    • ID argomento: inserisci crowdstrike-filevantage-trigger.
    • Lascia invariate le altre impostazioni predefinite.
  4. Fai clic su Crea.

Crea una funzione Cloud Run per raccogliere i log

La funzione Cloud Run viene attivata dai messaggi Pub/Sub di Cloud Scheduler per recuperare i log dall'API CrowdStrike FileVantage e scriverli in Cloud Storage.

  1. Nella console Google Cloud , vai a Cloud Run.
  2. Fai clic su Crea servizio.
  3. Seleziona Funzione (utilizza un editor per la modifica in linea per creare una funzione).
  4. Nella sezione Configura, fornisci i seguenti dettagli di configurazione:

    Impostazione Valore
    Nome servizio crowdstrike-filevantage-collector
    Regione Seleziona la regione corrispondente al tuo bucket Cloud Storage (ad esempio, us-central1)
    Tempo di esecuzione Seleziona Python 3.12 o versioni successive
  5. Nella sezione Trigger (facoltativo):

    1. Fai clic su + Aggiungi trigger.
    2. Seleziona Cloud Pub/Sub.
    3. In Seleziona un argomento Cloud Pub/Sub, scegli l'argomento Pub/Sub (crowdstrike-filevantage-trigger).
    4. Fai clic su Salva.
  6. Nella sezione Autenticazione:

    1. Seleziona Richiedi autenticazione.
    2. Controlla Identity and Access Management (IAM).
  7. Scorri verso il basso ed espandi Container, networking, sicurezza.

  8. Vai alla scheda Sicurezza:

    • Service account: seleziona il account di servizio (crowdstrike-filevantage-sa).
  9. Vai alla scheda Container:

    1. Fai clic su Variabili e secret.
    2. Fai clic su + Aggiungi variabile per ogni variabile di ambiente:
    Nome variabile Valore di esempio
    GCS_BUCKET crowdstrike-filevantage-logs
    GCS_PREFIX filevantage/
    STATE_KEY filevantage/state.json
    FALCON_CLIENT_ID your-client-id
    FALCON_CLIENT_SECRET your-client-secret
    FALCON_BASE_URL https://api.crowdstrike.com (US-1) / https://api.us-2.crowdstrike.com (US-2) / https://api.eu-1.crowdstrike.com (EU-1)
  10. Nella sezione Variabili e secret, scorri verso il basso fino a Richieste:

    • Timeout della richiesta: inserisci 600 secondi (10 minuti).
  11. Vai alla scheda Impostazioni:

    • Nella sezione Risorse:
      • Memoria: seleziona 512 MiB o un valore superiore.
      • CPU: seleziona 1.
  12. Nella sezione Scalabilità della revisione:

    • Numero minimo di istanze: inserisci 0.
    • Numero massimo di istanze: inserisci 100 (o regola in base al carico previsto).
  13. Fai clic su Crea.

  14. Attendi la creazione del servizio (1-2 minuti).

  15. Dopo aver creato il servizio, l'editor di codice incorporato si apre automaticamente.

Aggiungi codice per la funzione

  1. Inserisci main in Entry point della funzione
  2. Nell'editor di codice incorporato, crea due file:

    • Primo file: main.py:
    import functions_framework
    from google.cloud import storage
    import json
    import os
    import urllib3
    from datetime import datetime, timezone, timedelta
    import time
    
    # Initialize HTTP client with timeouts
    http = urllib3.PoolManager(
        timeout=urllib3.Timeout(connect=5.0, read=30.0),
        retries=False,
    )
    
    # Initialize Storage client
    storage_client = storage.Client()
    
    @functions_framework.cloud_event
    def main(cloud_event):
        """
        Cloud Run function triggered by Pub/Sub to fetch CrowdStrike FileVantage logs and write to GCS.
    
        Args:
            cloud_event: CloudEvent object containing Pub/Sub message
        """
    
        # Get environment variables
        bucket_name = os.environ.get('GCS_BUCKET')
        prefix = os.environ.get('GCS_PREFIX', 'filevantage/')
        state_key = os.environ.get('STATE_KEY', 'filevantage/state.json')
        client_id = os.environ.get('FALCON_CLIENT_ID')
        client_secret = os.environ.get('FALCON_CLIENT_SECRET')
        base_url = os.environ.get('FALCON_BASE_URL')
    
        if not all([bucket_name, client_id, client_secret, base_url]):
            print('Error: Missing required environment variables')
            return
    
        try:
            # Get GCS bucket
            bucket = storage_client.bucket(bucket_name)
    
            # Get OAuth token
            token_url = f"{base_url}/oauth2/token"
            token_headers = {
                'Content-Type': 'application/x-www-form-urlencoded',
                'Accept': 'application/json'
            }
            token_data = f"client_id={client_id}&client_secret={client_secret}&grant_type=client_credentials"
    
            token_response = http.request(
                'POST',
                token_url,
                body=token_data.encode('utf-8'),
                headers=token_headers
            )
    
            if token_response.status != 200:
                print(f"Failed to get OAuth token: {token_response.status}")
                print(f"Response: {token_response.data.decode('utf-8')}")
                return
    
            token_data_json = json.loads(token_response.data.decode('utf-8'))
            access_token = token_data_json['access_token']
    
            # Get last checkpoint
            last_timestamp = get_last_checkpoint(bucket, state_key)
    
            # Fetch file changes using v3 endpoint (high volume query)
            changes_url = f"{base_url}/filevantage/queries/changes/v3"
            headers = {
                'Authorization': f'Bearer {access_token}',
                'Accept': 'application/json'
            }
    
            # Build query parameters
            params = []
            params.append('limit=5000')
            params.append('sort=action_timestamp|asc')
    
            if last_timestamp:
                params.append(f"filter=action_timestamp:>'{last_timestamp}'")
    
            query_url = f"{changes_url}?{'&'.join(params)}"
    
            backoff = 1.0
            max_retries = 3
    
            for attempt in range(max_retries):
                response = http.request('GET', query_url, headers=headers)
    
                if response.status == 429:
                    retry_after = int(response.headers.get('Retry-After', str(int(backoff))))
                    print(f"Rate limited (429). Retrying after {retry_after}s...")
                    time.sleep(retry_after)
                    backoff = min(backoff * 2, 30.0)
                    continue
    
                if response.status != 200:
                    print(f"Failed to query changes: {response.status}")
                    print(f"Response: {response.data.decode('utf-8')}")
                    return
    
                break
            else:
                print("Max retries exceeded")
                return
    
            response_data = json.loads(response.data.decode('utf-8'))
            change_ids = response_data.get('resources', [])
    
            if not change_ids:
                print("No new changes found")
                return
    
            # Get detailed change information using v2 endpoint
            details_url = f"{base_url}/filevantage/entities/changes/v2"
            batch_size = 500
            all_changes = []
            latest_timestamp = last_timestamp
    
            for i in range(0, len(change_ids), batch_size):
                batch_ids = change_ids[i:i + batch_size]
    
                # Build query string with multiple ids parameters
                ids_params = '&'.join([f'ids={id}' for id in batch_ids])
                details_query_url = f"{details_url}?{ids_params}"
    
                backoff = 1.0
                for attempt in range(max_retries):
                    details_response = http.request('GET', details_query_url, headers=headers)
    
                    if details_response.status == 429:
                        retry_after = int(details_response.headers.get('Retry-After', str(int(backoff))))
                        print(f"Rate limited (429). Retrying after {retry_after}s...")
                        time.sleep(retry_after)
                        backoff = min(backoff * 2, 30.0)
                        continue
    
                    if details_response.status == 200:
                        details_data = json.loads(details_response.data.decode('utf-8'))
                        changes = details_data.get('resources', [])
                        all_changes.extend(changes)
    
                        # Track latest timestamp
                        for change in changes:
                            change_time = change.get('action_timestamp')
                            if change_time and (not latest_timestamp or change_time > latest_timestamp):
                                latest_timestamp = change_time
                        break
                    else:
                        print(f"Failed to get change details (batch {i//batch_size + 1}): {details_response.status}")
                        break
    
            if all_changes:
                # Store logs in GCS
                timestamp = datetime.now(timezone.utc).strftime('%Y%m%d_%H%M%S')
                blob_name = f"{prefix}filevantage_changes_{timestamp}.json"
                blob = bucket.blob(blob_name)
                log_lines = '\n'.join(json.dumps(change) for change in all_changes)
                blob.upload_from_string(log_lines, content_type='application/json')
    
                # Update checkpoint
                save_checkpoint(bucket, state_key, latest_timestamp)
    
                print(f"Stored {len(all_changes)} changes in GCS: {blob_name}")
    
        except Exception as e:
            print(f"Error: {str(e)}")
            raise
    
    def get_last_checkpoint(bucket, key):
        """Get the last processed timestamp from GCS state file"""
        try:
            blob = bucket.blob(key)
            if blob.exists():
                state_data = blob.download_as_text()
                state = json.loads(state_data)
                return state.get('last_timestamp')
        except Exception as e:
            print(f"Error reading checkpoint: {e}")
        return None
    
    def save_checkpoint(bucket, key, timestamp):
        """Save the last processed timestamp to GCS state file"""
        try:
            state = {
                'last_timestamp': timestamp,
                'updated_at': datetime.now(timezone.utc).isoformat()
            }
            blob = bucket.blob(key)
            blob.upload_from_string(
                json.dumps(state),
                content_type='application/json'
            )
        except Exception as e:
            print(f"Error saving checkpoint: {e}")
    
    • Secondo file: requirements.txt:
    functions-framework==3.*
    google-cloud-storage==2.*
    urllib3>=2.0.0
    
  3. Fai clic su Esegui il deployment per salvare la funzione ed eseguirne il deployment.

  4. Attendi il completamento del deployment (2-3 minuti).

Crea job Cloud Scheduler

Cloud Scheduler pubblica messaggi nell'argomento Pub/Sub a intervalli regolari, attivando la funzione Cloud Run.

  1. Nella console Google Cloud , vai a Cloud Scheduler.
  2. Fai clic su Crea job.
  3. Fornisci i seguenti dettagli di configurazione:

    Impostazione Valore
    Nome crowdstrike-filevantage-hourly
    Regione Seleziona la stessa regione della funzione Cloud Run
    Frequenza */15 * * * * (ogni 15 minuti)
    Fuso orario Seleziona il fuso orario (consigliato UTC)
    Tipo di target Pub/Sub
    Argomento Seleziona l'argomento Pub/Sub (crowdstrike-filevantage-trigger)
    Corpo del messaggio {} (oggetto JSON vuoto)
  4. Fai clic su Crea.

Testa il job dello scheduler

  1. Nella console Cloud Scheduler, individua il tuo job (crowdstrike-filevantage-hourly).
  2. Fai clic su Forza esecuzione per attivare manualmente.
  3. Attendi qualche secondo e vai a Cloud Run > Servizi > crowdstrike-filevantage-collector > Log.
  4. Verifica che la funzione sia stata eseguita correttamente.
  5. Controlla il bucket Cloud Storage (crowdstrike-filevantage-logs) per verificare che i log siano stati scritti.

Recupera il account di servizio Google SecOps

Google SecOps utilizza un account di servizio univoco per leggere i dati dal tuo bucket Cloud Storage. Devi concedere a questo account di servizio l'accesso al tuo bucket.

Recupera l'indirizzo email del account di servizio

  1. Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
  2. Fai clic su Aggiungi nuovo feed di notizie.
  3. Fai clic su Configura un singolo feed.
  4. Nel campo Nome feed, inserisci un nome per il feed (ad es. CrowdStrike FileVantage logs).
  5. Seleziona Google Cloud Storage V2 come Tipo di origine.
  6. Seleziona CrowdStrike Filevantage come Tipo di log.
  7. Fai clic su Ottieni service account. Viene visualizzato un indirizzo email univoco del account di servizio, ad esempio:

    chronicle-12345678@chronicle-gcp-prod.iam.gserviceaccount.com
    
  8. Copia questo indirizzo email per utilizzarlo nel passaggio successivo.

Concedi le autorizzazioni IAM al account di servizio Google SecOps

Il account di servizio Google SecOps deve avere il ruolo Storage Object Viewer nel bucket Cloud Storage.

  1. Vai a Cloud Storage > Bucket.
  2. Fai clic sul nome del bucket (ad esempio crowdstrike-filevantage-logs).
  3. Vai alla scheda Autorizzazioni.
  4. Fai clic su Concedi l'accesso.
  5. Fornisci i seguenti dettagli di configurazione:
    • Aggiungi entità: incolla l'indirizzo email del account di servizio Google SecOps.
    • Assegna ruoli: seleziona Visualizzatore oggetti Storage.
  6. Fai clic su Salva.

Configura un feed in Google SecOps per importare i log di CrowdStrike FileVantage

  1. Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
  2. Fai clic su Aggiungi nuovo feed di notizie.
  3. Fai clic su Configura un singolo feed.
  4. Nel campo Nome feed, inserisci un nome per il feed (ad es. CrowdStrike FileVantage logs).
  5. Seleziona Google Cloud Storage V2 come Tipo di origine.
  6. Seleziona CrowdStrike Filevantage come Tipo di log.
  7. Fai clic su Avanti.
  8. Specifica i valori per i seguenti parametri di input:

    • URL bucket di archiviazione: inserisci l'URI del bucket Cloud Storage con il percorso del prefisso:

      gs://crowdstrike-filevantage-logs/filevantage/
      
      • Sostituisci:

        • crowdstrike-filevantage-logs: il nome del tuo bucket Cloud Storage.
        • filevantage/: prefisso/percorso della cartella in cui sono archiviati i log.
    • Opzione di eliminazione dell'origine: seleziona l'opzione di eliminazione in base alle tue preferenze:

      • Mai: non elimina mai i file dopo i trasferimenti (opzione consigliata per i test).
      • Elimina i file trasferiti: elimina i file dopo il trasferimento riuscito.
      • Elimina i file trasferiti e le directory vuote: elimina i file e le directory vuote dopo il trasferimento riuscito.

    • Età massima del file: includi i file modificati nell'ultimo numero di giorni. Il valore predefinito è 180 giorni.

    • Spazio dei nomi dell'asset: lo spazio dei nomi dell'asset.

    • Etichette di importazione: l'etichetta da applicare agli eventi di questo feed.

  9. Fai clic su Avanti.

  10. Controlla la nuova configurazione del feed di notizie nella schermata Finalizza, quindi fai clic su Invia.

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.