Raccogli i log di Snipe-IT

Supportata in:

Questo documento spiega come importare i log di Snipe-IT in Google Security Operations utilizzando Google Cloud Storage. Snipe-IT è un sistema di gestione degli asset IT open source che monitora hardware, licenze software, accessori, materiali di consumo e altri asset IT durante il loro ciclo di vita.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Un progetto GCP con l'API Storage di Cloud Storage abilitata
  • Autorizzazioni per creare e gestire i bucket GCS
  • Autorizzazioni per gestire le policy IAM sui bucket GCS
  • Autorizzazioni per creare funzioni Cloud Run, argomenti Pub/Sub e job Cloud Scheduler
  • Accesso con privilegi al tenant Snipe-IT

Raccogli i prerequisiti di Snipe-IT (token API e URL di base)

  1. Accedi a Snipe-IT.
  2. Apri il menu utente (avatar in alto a destra) e fai clic su Gestisci chiavi API.
  3. Fai clic su Crea nuovo token:
    • Nome/Etichetta: inserisci un'etichetta descrittiva (ad esempio Google SecOps export).
  4. Fai clic su Genera.
  5. Copia il token API (verrà mostrato una sola volta). Conservala in un luogo sicuro.
  6. Determina l'URL di base dell'API, in genere: https://<your-domain>/api/v1
    • Esempio: https://snipeit.example.com/api/v1

Crea un bucket Google Cloud Storage

  1. Vai alla console Google 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 snipe-it-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.

Crea un account di servizio per la funzione Cloud Run

La funzione Cloud Run richiede un account di servizio con autorizzazioni di scrittura nel bucket GCS.

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 snipeit-assets-to-gcs-sa.
    • Descrizione service account: inserisci Service account for Cloud Run function to collect Snipe-IT logs.
  4. Fai clic su Crea e continua.
  5. Nella sezione Concedi a questo account di servizio l'accesso al progetto:
    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 GCS 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 GCS

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

  1. Vai a Cloud Storage > Bucket.
  2. Fai clic sul nome del bucket.
  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 snipeit-assets-to-gcs-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à 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 snipeit-assets-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 gli asset hardware dall'API Snipe-IT e li scrive in GCS.

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

    Impostazione Valore
    Nome servizio snipeit-assets-to-gcs
    Regione Seleziona la regione corrispondente al tuo bucket GCS (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 (snipeit-assets-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 (snipeit-assets-to-gcs-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 snipe-it-logs
    GCS_PREFIX snipeit/assets
    SNIPE_BASE_URL https://snipeit.example.com/api/v1
    SNIPE_API_TOKEN your-api-token
    PAGE_SIZE 500
    MAX_PAGES 200
  10. Scorri verso il basso nella scheda Variabili e secret fino a Richieste:

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

    • Nella sezione Risorse:
      • Memoria: seleziona 512 MiB o un valore superiore.
      • CPU: seleziona 1.
    • Fai clic su Fine.
  12. Scorri fino ad Ambiente di esecuzione:

    • Seleziona Predefinita (opzione consigliata).
  13. Nella sezione Scalabilità della revisione:

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

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

  16. 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
          import urllib.parse
      
          # Initialize HTTP client
          http = urllib3.PoolManager()
      
          # Initialize Storage client
          storage_client = storage.Client()
      
          @functions_framework.cloud_event
          def main(cloud_event):
              """
              Cloud Run function triggered by Pub/Sub to fetch hardware assets from Snipe-IT API 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', 'snipeit/assets')
              base_url = os.environ.get('SNIPE_BASE_URL', '').rstrip('/')
              token = os.environ.get('SNIPE_API_TOKEN')
              page_size = int(os.environ.get('PAGE_SIZE', '500'))
              max_pages = int(os.environ.get('MAX_PAGES', '200'))
      
              if not all([bucket_name, base_url, token]):
                  print('Error: Missing required environment variables')
                  return
      
              try:
                  # Get GCS bucket
                  bucket = storage_client.bucket(bucket_name)
      
                  # Fetch and write pages
                  ts = datetime.now(timezone.utc)
                  offset = 0
                  page = 0
                  total = 0
      
                  headers = {
                      'Authorization': f'Bearer {token}',
                      'Accept': 'application/json',
                      'Content-Type': 'application/json'
                  }
      
                  while page < max_pages:
                      # Fetch page from Snipe-IT API
                      params = {
                          'limit': page_size,
                          'offset': offset,
                          'sort': 'id',
                          'order': 'asc'
                      }
                      qs = urllib.parse.urlencode(params)
                      url = f"{base_url}/hardware?{qs}"
      
                      print(f'Fetching page {page} from {url}')
      
                      response = http.request('GET', url, headers=headers, timeout=60.0)
      
                      if response.status != 200:
                          print(f'Error: API returned status {response.status}')
                          break
      
                      data = json.loads(response.data.decode('utf-8'))
      
                      # Get rows from response (Snipe-IT uses 'rows' field)
                      rows = data.get('rows', [])
                      total_available = data.get('total', 0)
      
                      # Write page to GCS
                      blob_name = f"{prefix}/{ts.strftime('%Y/%m/%d')}/snipeit-hardware-{page:05d}.json"
                      blob = bucket.blob(blob_name)
                      body = json.dumps(data, separators=(',', ':')).encode('utf-8')
                      blob.upload_from_string(body, content_type='application/json')
      
                      print(f'Wrote page {page} with {len(rows)} rows to {blob_name}')
      
                      total += len(rows)
      
                      # Check if we've reached the end
                      # Snipe-IT returns empty rows array when no more data
                      if len(rows) == 0:
                          print(f'No more results (empty rows array)')
                          break
      
                      # Also check if we've fetched all available records
                      if offset + len(rows) >= total_available:
                          print(f'Reached end of data (offset {offset + len(rows)} >= total {total_available})')
                          break
      
                      page += 1
                      offset += page_size
      
                  print(f'Successfully processed {page + 1} pages with {total} total objects')
      
              except Exception as e:
                  print(f'Error processing logs: {str(e)}')
                  raise
          ```
      
    • 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 snipeit-assets-to-gcs-hourly
    Regione Seleziona la stessa regione della funzione Cloud Run
    Frequenza 0 * * * * (ogni ora, allo scoccare dell'ora)
    Fuso orario Seleziona il fuso orario (consigliato UTC)
    Tipo di target Pub/Sub
    Argomento Seleziona l'argomento (snipeit-assets-trigger)
    Corpo del messaggio {} (oggetto JSON vuoto)
  4. Fai clic su Crea.

Opzioni di frequenza di pianificazione

  • Scegli la frequenza in base al volume dei log e ai requisiti di latenza:

    Frequenza Espressione cron Caso d'uso
    Ogni 5 minuti */5 * * * * Volume elevato, bassa latenza
    Ogni 15 minuti */15 * * * * Volume medio
    Ogni ora 0 * * * * Standard (consigliato)
    Ogni 6 ore 0 */6 * * * Basso volume, elaborazione batch
    Ogni giorno 0 0 * * * Raccolta dei dati storici

Testa il job dello scheduler

  1. Nella console Cloud Scheduler, trova il tuo job.
  2. Fai clic su Forza esecuzione per attivare manualmente.
  3. Attendi qualche secondo e vai a Cloud Run > Servizi > snipeit-assets-to-gcs > Log.
  4. Verifica che la funzione sia stata eseguita correttamente.
  5. Controlla il bucket GCS 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 GCS. 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.
  3. Fai clic su Configura un singolo feed.
  4. Nel campo Nome feed, inserisci un nome per il feed (ad es. Snipe-IT logs).
  5. Seleziona Google Cloud Storage V2 come Tipo di origine.
  6. Seleziona Snipe-IT 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 GCS.

  1. Vai a Cloud Storage > Bucket.
  2. Fai clic sul nome del bucket.
  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 Snipe-IT

  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.
  3. Fai clic su Configura un singolo feed.
  4. Nel campo Nome feed, inserisci un nome per il feed (ad es. Snipe-IT logs).
  5. Seleziona Google Cloud Storage V2 come Tipo di origine.
  6. Seleziona Snipe-IT 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 GCS con il percorso del prefisso:

      gs://snipe-it-logs/snipeit/assets/
      
      • Sostituisci:

        • snipe-it-logs: il nome del tuo bucket GCS.
        • snipeit/assets: percorso del prefisso/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 negli ultimi 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.

Tabella di mappatura UDM

Campo del log mappatura UDM Logica
created_at.datetime entity.asset.attribute.creation_time Analizzato come UNIX_MS
age entity.asset.attribute.labels.value Mappatura diretta
alt_barcode entity.asset.attribute.labels.value Mappatura diretta
asset_eol_date entity.asset.attribute.labels.value Mappatura diretta
asset_tag entity.asset.attribute.labels.value Mappatura diretta
asset_type_value entity.asset.attribute.labels.value Mappatura diretta
assets_classification_value entity.asset.attribute.labels.value Mappatura diretta
category.id entity.asset.attribute.labels.value Mappatura diretta
custom_fields.RAM.value entity.asset.attribute.labels.value Mappatura diretta
custom_fields.SSD.value entity.asset.attribute.labels.value Mappatura diretta
last_update_time.formatted entity.asset.attribute.labels.value Mappatura diretta
manufacturer.id entity.asset.attribute.labels.value Mappatura diretta
model_id entity.asset.attribute.labels.value Mappatura diretta
model_number entity.asset.attribute.labels.value Mappatura diretta
updated_at.datetime entity.asset.attribute.last_update_time Analizzato come UNIX_MS
category.name entity.asset.category Mappatura diretta
custom_fields.Processor.value entity.asset.hardware.cpu_model Mappatura diretta
manufacturer.name entity.asset.hardware.manufacturer Mappatura diretta
model.name entity.asset.hardware.model Mappatura diretta
serial entity.asset.hardware.serial_number Mappatura diretta
name entity.asset.hostname Mappatura diretta
location.name entity.asset.location.name Mappatura diretta
id entity.asset.product_object_id Mappatura diretta
custom_fields.Owner.value entity.labels.value Mappatura diretta
deleted_at entity.labels.value Mappatura diretta
eol entity.labels.value Mappatura diretta
expected_checkin entity.labels.value Mappatura diretta
image entity.labels.value Mappatura diretta
last_audit_date entity.labels.value Mappatura diretta
next_audit_date.date entity.labels.value Mappatura diretta
notes entity.labels.value Mappatura diretta
order_number entity.labels.value Mappatura diretta
purchase_cost entity.labels.value Mappatura diretta
purchase_date.date entity.labels.value Mappatura diretta
purchase_date.formatted entity.labels.value Mappatura diretta
qr entity.labels.value Mappatura diretta
requestable entity.labels.value Mappatura diretta
requests_counter entity.labels.value Mappatura diretta
rtd_location.id entity.labels.value Mappatura diretta
status_label.id entity.labels.value Mappatura diretta
status_label.status_meta entity.labels.value Mappatura diretta
status_label.status_type entity.labels.value Mappatura diretta
supplier.id entity.labels.value Mappatura diretta
supplier.name entity.labels.value Mappatura diretta
updated_at.formatted entity.labels.value Mappatura diretta
warranty_expires.date entity.labels.value Mappatura diretta
warranty_expires.formatted entity.labels.value Mappatura diretta
warranty_months entity.labels.value Mappatura diretta
assigned_to.username entity.user.attribute.labels.value Mappatura diretta
available_actions.checkin entity.user.attribute.labels.value Mappatura diretta
available_actions.checkout entity.user.attribute.labels.value Mappatura diretta
available_actions.clone entity.user.attribute.labels.value Mappatura diretta
available_actions.delete entity.user.attribute.labels.value Mappatura diretta
available_actions.restore entity.user.attribute.labels.value Mappatura diretta
available_actions.update entity.user.attribute.labels.value Mappatura diretta
checkin_counter entity.user.attribute.labels.value Mappatura diretta
checkout_counter entity.user.attribute.labels.value Mappatura diretta
company.id entity.user.attribute.labels.value Mappatura diretta
created_by.id entity.user.attribute.labels.value Mappatura diretta
created_by.name entity.user.attribute.labels.value Mappatura diretta
last_checkin.datetime entity.user.attribute.labels.value Mappatura diretta
last_checkin.formatted entity.user.attribute.labels.value Mappatura diretta
last_checkout.formatted entity.user.attribute.labels.value Mappatura diretta
assigned_to.type entity.user.attribute.roles.name Mappatura diretta
company.name entity.user.company_name Mappatura diretta
assigned_to_email entity.user.email_addresses Unita
assigned_to.employee_number entity.user.employee_id Mappatura diretta
assigned_to.first_name entity.user.first_name Mappatura diretta
last_checkout.datetime entity.user.last_login_time Analizzato come UNIX_MS
assigned_to.last_name entity.user.last_name Mappatura diretta
assigned_to.name entity.user.user_display_name Mappatura diretta
assigned_to.id entity.user.userid Mappatura diretta
has_asset metadata.entity_type Mappatura: true → ASSET
has_user metadata.entity_type Mappatura: true → USER
has_asset metadata.product_name Mappatura: true → CMDB
has_user metadata.product_name Mappatura: true → CMDB
has_asset metadata.vendor_name Mappatura: true → Snipe-IT
has_user metadata.vendor_name Mappatura: true → Snipe-IT
N/D entity.asset.attribute.labels.key Costante: model_id
N/D entity.asset.platform_software.platform Costante: WINDOWS
N/D entity.labels.key Costante: purchase_date
N/D entity.user.attribute.labels.key Costante: checkout
N/D metadata.entity_type Costante: ASSET
N/D metadata.product_name Costante: CMDB
N/D metadata.vendor_name Costante: Snipe-IT

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.