Raccogli i log SWG di Dope Security
Parser Version: 1.0
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:
- Accedi alla dope.console all'indirizzo https://console.dope.security
- Vai a Impostazioni > SIEM > Impostazioni di integrazione SIEM.
- Nell'elenco SIEM Type (Tipo di SIEM), seleziona AWS S3.
Prendi nota della regione AWS visualizzata sul lato destro della pagina (ad esempio, US-EAST-2).
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
- Crea un bucket Amazon S3. Per saperne di più, consulta Crea un bucket.
- 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).
Salva il nome del bucket per riferimento futuro (ad esempio,
chronicle-dope-swg-logs).Crea un utente. Per saperne di più, consulta Creazione di un utente IAM.
Seleziona l'utente che hai creato.
Seleziona la scheda Security credentials (Credenziali di sicurezza).
Fai clic su Crea chiave di accesso nella sezione Chiavi di accesso.
Seleziona Servizio di terze parti come Caso d'uso.
Fai clic su Avanti.
(Facoltativo) Aggiungi un tag di descrizione.
Fai clic su Crea chiave di accesso.
Fai clic su Scarica file .csv per salvare la chiave di accesso e la chiave di accesso segreta per riferimento futuro.
Fai clic su Fine.
Seleziona la scheda Autorizzazioni.
Fai clic su Aggiungi autorizzazioni nella sezione Policy sulle autorizzazioni.
Seleziona Aggiungi autorizzazioni.
Seleziona Collega direttamente i criteri.
Cerca la policy AmazonS3FullAccess.
Seleziona la policy.
Fai clic su Avanti.
Fai clic su Aggiungi autorizzazioni.
Configura la connessione Amazon S3 di Dope Security
- Torna alla pagina dope.console in Impostazioni > SIEM > Impostazioni di integrazione SIEM.
- Nel campo Nome bucket S3, inserisci il nome del tuo bucket S3 (ad esempio
chronicle-dope-swg-logs). - Nel riquadro di destra, vedrai una sezione Policy del bucket con una policy JSON pregenerata.
- Fai clic su Copia accanto al JSON della policy per copiarlo negli appunti.
- In una nuova scheda del browser, vai alla console AWS S3.
- Seleziona il tuo bucket S3 (ad esempio
chronicle-dope-swg-logs). - Vai alla scheda Autorizzazioni.
- Scorri verso il basso fino alla sezione Policy del bucket.
- Fai clic su Modifica.
- Incolla il codice JSON della policy che hai copiato dalla console dope nell'area di testo Policy.
- Fai clic su Salva modifiche.
- Torna alla scheda del browser dope.console.
- Fai clic su Sincronizza nella parte inferiore della pagina Impostazioni di integrazione SIEM.
- Attendi il completamento della sincronizzazione.
- Verifica che venga visualizzato un segno di spunta verde accanto al campo S3 Bucket Name (Nome bucket S3).
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
- Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
- Fai clic su Aggiungi nuovo feed.
- Nella pagina successiva, fai clic su Configura un singolo feed.
- Inserisci un nome univoco per il Nome feed (ad esempio
Dope Security SWG Logs). - Seleziona Amazon S3 V2 come Tipo di origine.
- Seleziona DOPE_SWG come Log type (Tipo di log).
- Fai clic su Avanti e poi su Invia.
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.
- URI S3:
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.