Raccogli i log SWG di Dope Security

Parser Version: 1.0

Supportata in:

Questo documento spiega come importare i log di Dope Security SWG in Google Security Operations utilizzando Amazon S3.

Dope Security dope.swg è un gateway web sicuro basato su endpoint che fornisce filtro web in tempo reale, protezione da malware e controllo delle applicazioni cloud. Ogni dope.endpoint invia i log delle transazioni web a dope.cloud ogni 15 minuti, che vengono poi esportati automaticamente nel tuo bucket AWS S3 in formato GZIP JSONL compresso per l'integrazione SIEM.

Prima di iniziare

Assicurati di soddisfare i seguenti prerequisiti:

  • Un'istanza Google SecOps
  • Accesso con privilegi a Dope Security dope.console
  • Accesso privilegiato ad AWS (S3, IAM)
  • Il tuo tenant Dope Security deve trovarsi nella stessa regione AWS del tuo bucket S3 (verifica la regione nella pagina Impostazioni > SIEM)

Configura l'integrazione SIEM di Dope Security

Per configurare l'integrazione SIEM di Dope Security:

  1. Accedi alla dope.console all'indirizzo https://console.dope.security
  2. Vai a Impostazioni > SIEM > Impostazioni di integrazione SIEM.
  3. Nell'elenco SIEM Type (Tipo di SIEM), seleziona AWS S3.
  4. Prendi nota della regione AWS visualizzata sul lato destro della pagina (ad esempio, US-EAST-2).

  5. Lascia aperta questa pagina perché dovrai tornare qui per completare la configurazione dopo aver configurato AWS S3.

Configura il bucket AWS S3 e IAM per Google SecOps

  1. Crea un bucket Amazon S3. Per saperne di più, consulta Crea un bucket.
  2. Quando crei il bucket, assicurati che la Regione corrisponda alla regione mostrata nella pagina di integrazione SIEM di Dope Security (ad esempio, US East (Ohio) us-east-2).
  3. Salva il nome del bucket per riferimento futuro (ad esempio, chronicle-dope-swg-logs).

  4. Crea un utente. Per saperne di più, consulta Creazione di un utente IAM.

  5. Seleziona l'utente che hai creato.

  6. Seleziona la scheda Security credentials (Credenziali di sicurezza).

  7. Fai clic su Crea chiave di accesso nella sezione Chiavi di accesso.

  8. Seleziona Servizio di terze parti come Caso d'uso.

  9. Fai clic su Avanti.

  10. (Facoltativo) Aggiungi un tag di descrizione.

  11. Fai clic su Crea chiave di accesso.

  12. Fai clic su Scarica file .csv per salvare la chiave di accesso e la chiave di accesso segreta per riferimento futuro.

  13. Fai clic su Fine.

  14. Seleziona la scheda Autorizzazioni.

  15. Fai clic su Aggiungi autorizzazioni nella sezione Policy sulle autorizzazioni.

  16. Seleziona Aggiungi autorizzazioni.

  17. Seleziona Collega direttamente i criteri.

  18. Cerca la policy AmazonS3FullAccess.

  19. Seleziona la policy.

  20. Fai clic su Avanti.

  21. Fai clic su Aggiungi autorizzazioni.

Configura la connessione Amazon S3 di Dope Security

  1. Torna alla pagina dope.console in Impostazioni > SIEM > Impostazioni di integrazione SIEM.
  2. Nel campo Nome bucket S3, inserisci il nome del tuo bucket S3 (ad esempio chronicle-dope-swg-logs).
  3. Nel riquadro di destra, vedrai una sezione Policy del bucket con una policy JSON pregenerata.
  4. Fai clic su Copia accanto al JSON della policy per copiarlo negli appunti.
  5. In una nuova scheda del browser, vai alla console AWS S3.
  6. Seleziona il tuo bucket S3 (ad esempio chronicle-dope-swg-logs).
  7. Vai alla scheda Autorizzazioni.
  8. Scorri verso il basso fino alla sezione Policy del bucket.
  9. Fai clic su Modifica.
  10. Incolla il codice JSON della policy che hai copiato dalla console dope nell'area di testo Policy.
  11. Fai clic su Salva modifiche.
  12. Torna alla scheda del browser dope.console.
  13. Fai clic su Sincronizza nella parte inferiore della pagina Impostazioni di integrazione SIEM.
  14. Attendi il completamento della sincronizzazione.
  15. Verifica che venga visualizzato un segno di spunta verde accanto al campo S3 Bucket Name (Nome bucket S3).
  16. Verifica che il timestamp Ultima sincronizzazione venga visualizzato nell'angolo in alto a destra della pagina.

Configura un feed in Google SecOps per importare i log di Dope Security SWG

  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. Nella pagina successiva, fai clic su Configura un singolo feed.
  4. Inserisci un nome univoco per il Nome feed (ad esempio Dope Security SWG Logs).
  5. Seleziona Amazon S3 V2 come Tipo di origine.
  6. Seleziona DOPE_SWG come Log type (Tipo di log).
  7. Fai clic su Avanti e poi su Invia.
  8. Specifica i valori per i seguenti campi:

    • URI S3: s3://chronicle-dope-swg-logs/ (sostituisci con il nome del tuo bucket)
    • Opzione di eliminazione dell'origine: seleziona l'opzione di eliminazione in base alle tue preferenze.
    • Età massima dei file: includi i file modificati negli ultimi giorni (il valore predefinito è 180 giorni)
    • ID chiave di accesso: chiave di accesso utente con accesso al bucket S3 (dal passaggio 12 della configurazione di AWS)
    • Secret Access Key (Chiave di accesso segreta): chiave segreta dell'utente con accesso al bucket S3 (dal passaggio 12 della configurazione di AWS)
    • 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 e poi su Invia.

Riferimento per il formato dei dati di log

Dope Security esporta i log in formato JSONL (JSON Lines) con compressione GZIP. Ogni voce di log contiene i seguenti campi chiave:

Campo Descrizione
Timestamp Timestamp ISO 8601 della richiesta della transazione web
Durata Durata della connessione in millisecondi
Destinazione corrispondente Dominio con cui è stata abbinata la categoria di spam
IP di destinazione Indirizzo IP di destinazione per l'URL richiesto
ID tenant ID tenant univoco dope.cloud del cliente
ID agente ID agente univoco per dope.endpoint
Utente Utente che ha eseguito l'accesso su dope.endpoint
Utente OIDC Indirizzo email dell'utente autenticato (quando l'autenticazione OIDC è abilitata)
Categorie Numeri di categoria DOPE corrispondenti (0-88) per l'URL richiesto
Verdict Esito della policy: Consenti (0), Blocca (1), Avviso (2) o Bypass (3)
Dati inviati Quantità di dati inviati nella connessione (byte)
Dati ricevuti Quantità di dati ricevuti nella connessione (byte)
Tipo di policy Tipo di policy applicata: Web, Cloud Application Control (CAC), Categoria personalizzata, Bypass o Malware
Dettagli blocco Per i verdetti di blocco: categoria di contenuti non idonei, categoria personalizzata, applicazione cloud o tipo di malware
Nome file Nome di qualsiasi file scaricato
Hash file Hash dei file scaricati
Nome del processo Nome del processo che effettua la richiesta dell'URL
URL URL richiesto completo
Nome della policy Nome della policy applicata
Protocollo Protocollo utilizzato (ad esempio HTTP/2, HTTP/1.1)
Nome host Nome host del dispositivo
Metodo di richiesta HTTP Metodo di richiesta HTTP (ad esempio GET, POST, PUT)
Albero delle chiamate di processo Relazioni padre-figlio da operazioni di generazione di processi con argomenti di comando

Per le mappature complete di categorie e verdetti, consulta la documentazione Dope Security Category & Verdict Mappings.

Tabella di mappatura UDM

Campo log Mappatura UDM Logica
policy.categories, request.processTree additional.fields Uniti come elenco da policy.categories e request.processTree in JSON
timestamp metadata.event_timestamp Analizzato come timestamp ISO8601 sia in JSON che in CSV
metadata.event_type Impostato su NETWORK_HTTP se has_principal, has_target, has_http in JSON; altrimenti NETWORK_CONNECTION se has_principal e has_target; altrimenti USER_UNCATEGORIZED se has_user; altrimenti STATUS_UPDATE se has_principal; altrimenti GENERIC_EVENT; impostato su NETWORK_HTTP in CSV
schemaVersion metadata.product_version Valore copiato direttamente da schemaVersion in JSON
request.httpVersion network.http.user_agent Valore copiato direttamente da request.httpVersion in JSON
bandwidth.dataReceivedInBytes, bytes_received network.received_bytes Convertito in uinteger da bandwidth.dataReceivedInBytes in JSON o bytes_received in CSV se non vuoto e diverso da 0
bandwidth.dataSentInBytes, bytes_sent network.sent_bytes Convertito in uinteger da bandwidth.dataSentInBytes in JSON o bytes_sent in CSV se non vuoto e diverso da 0
request.duration network.session_duration.seconds Convertito in numero intero da request.duration in JSON
endpoint.agentID, endpoint_id principal.asset.asset_id Con prefisso DS: da endpoint.agentID in JSON o endpoint_id in CSV
endpoint.tenantID principal.asset.attribute.cloud.project.id Valore copiato direttamente da endpoint.tenantID in JSON
endpoint.deviceName principal.asset.hostname Valore copiato direttamente da endpoint.deviceName in JSON
endpoint.deviceName, endpoint_hostname principal.hostname Valore di endpoint.deviceName in JSON o endpoint_hostname in CSV
request.processName principal.process.command_line Valore copiato direttamente da request.processName in JSON
process_name principal.process.file.names Valore copiato direttamente da process_name nel file CSV
sso_user, user principal.user.account_type Impostato su DOMAIN_ACCOUNT_TYPE se sso_user non è vuoto, altrimenti su LOCAL_ACCOUNT_TYPE nel file CSV
endpoint.oidcUser principal.user.email_addresses Unito se endpoint.oidcUser corrisponde all'espressione regolare dell'email in JSON
endpoint.oidcUser principal.user.user_display_name Valore copiato direttamente se endpoint.oidcUser non corrisponde all'espressione regolare dell'email in JSON
endpoint.user, sso_user, user principal.user.userid Valore di endpoint.user in JSON; di sso_user se non vuoto, altrimenti di user in CSV
security_result security_result Unito da security_result in JSON
policy.verdict, verdict security_result.action Imposta su BLOCK se 1, ALLOW se 0, CHALLENGE se 2 da policy.verdict in JSON o verdict in CSV
categorie security_result.action_details Valore copiato direttamente dalle categorie nel file CSV
policy.policyName security_result.rule_name Valore copiato direttamente da policy.policyName in JSON
policy.policyType security_result.rule_type Valore copiato direttamente da policy.policyType in JSON
file_name target.file.names Valore copiato direttamente da file_name nel file CSV
file_hash target.file.sha256 Valore copiato direttamente da file_hash nel file CSV
destination.matchedDestination, domain target.hostname Valore di destination.matchedDestination se non è un IP in JSON; dal dominio in CSV
destination.matchedDestination, destination.destinationIP, ip target.ip Valore di destination.matchedDestination o destination.destinationIP se l'IP è in formato JSON; dall'IP in formato CSV
destination.url, url target.url Valore di destination.url in JSON; di url in CSV
metadata.product_name Imposta su "DOPE_SWG" in JSON; "SWG" in CSV
metadata.vendor_name Imposta su "DOPE_SWG" in JSON; "Dope Security" in CSV

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.