Raccogli i log DNS di Cisco Umbrella
Versione parser: 17.0
Questo documento spiega come importare i log DNS di Cisco Umbrella in Google Security Operations utilizzando Amazon S3. Cisco Umbrella è un servizio di sicurezza fornito tramite cloud che offre protezione a livello DNS, gateway web sicuro e funzionalità di Cloud Access Security Broker (CASB). I log DNS di Umbrella acquisiscono l'attività delle query DNS nella tua rete, inclusi i domini richiesti, i codici di risposta e le azioni delle policy di sicurezza intraprese per ogni richiesta.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Istanza Google SecOps.
- Accesso con privilegi alla dashboard di Cisco Umbrella con il ruolo Amministratore completo o Amministratore di sola lettura.
- Accesso privilegiato ad AWS (S3, IAM).
Configura l'esportazione dei log di Cisco Umbrella in Amazon S3
Cisco Umbrella supporta in modo nativo l'esportazione dei log DNS in un bucket Amazon S3 che gestisci.
- Accedi alla dashboard di Cisco Umbrella all'indirizzo
https://dashboard.umbrella.com. - Vai ad Amministratore > Gestione dei log.
- Fai clic su Utilizza il bucket Amazon S3 gestito dalla tua azienda.
- Fornisci i seguenti dettagli di configurazione:
- Nome bucket: inserisci il nome del bucket S3 che creerai nella sezione successiva (ad esempio,
umbrella-dns-logs). - Regione: seleziona la regione AWS in cui verrà creato il bucket.
- Nome bucket: inserisci il nome del bucket S3 che creerai nella sezione successiva (ad esempio,
- Copia l'ID account AWS e l'ID esterno visualizzati da Umbrella. Ti serviranno per configurare la policy di attendibilità IAM in AWS.
- Fai clic su Salva.
Configura il bucket AWS S3 e IAM per Google SecOps
- Crea un bucket Amazon S3 seguendo questa guida dell'utente: Creazione di un bucket
- Salva il nome e la regione del bucket per riferimento futuro (ad esempio,
umbrella-dns-logs). - Crea un utente seguendo questa guida dell'utente: Creazione di un utente IAM.
- Seleziona l'utente creato.
- Seleziona la scheda Credenziali di sicurezza.
- Fai clic su Create Access Key (Crea chiave di accesso) nella sezione Access Keys (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 Download CSV file (Scarica file CSV) per salvare la Access Key (Chiave di accesso) e la Secret Access Key (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 policy e il ruolo IAM per l'accesso a Cisco Umbrella S3
Cisco Umbrella richiede un ruolo IAM tra account per scrivere i log nel tuo bucket S3.
- Nella console AWS, vai a IAM > Policies > Create policy > scheda JSON.
Copia e incolla la seguente policy (sostituisci
umbrella-dns-logsse hai inserito un nome bucket diverso):{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowUmbrellaPutObjects", "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetBucketLocation" ], "Resource": [ "arn:aws:s3:::umbrella-dns-logs", "arn:aws:s3:::umbrella-dns-logs/*" ] } ] }Fai clic su Avanti > Crea policy. Assegnale il nome
UmbrellaS3WritePolicy.Vai a IAM > Ruoli > Crea ruolo > Policy di attendibilità personalizzata.
Incolla la seguente policy di attendibilità, sostituendo
UMBRELLA_AWS_ACCOUNT_IDeUMBRELLA_EXTERNAL_IDcon i valori copiati dalla dashboard di Umbrella:{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::UMBRELLA_AWS_ACCOUNT_ID:root" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "sts:ExternalId": "UMBRELLA_EXTERNAL_ID" } } } ] }Fai clic su Avanti.
Collega la policy
UmbrellaS3WritePolicy.Assegna al ruolo il nome
UmbrellaS3Rolee fai clic su Crea ruolo.Copia l'ARN del ruolo da utilizzare nella dashboard di Umbrella.
Verifica l'esportazione dei log di Cisco Umbrella
- Torna alla dashboard di Cisco Umbrella.
- Vai ad Amministratore > Gestione dei log.
- Inserisci l'ARN del ruolo dal ruolo IAM che hai creato.
- Fai clic su Verify (Verifica) per confermare che Umbrella può scrivere nel bucket S3.
- Una volta completata la verifica, Umbrella inizierà a esportare i log DNS nel bucket S3.
Configura un feed in Google SecOps per importare i log DNS di Cisco Umbrella
- Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
- Fai clic su + Aggiungi nuovo feed.
- Nel campo Nome feed, inserisci un nome per il feed (ad es.
Cisco Umbrella DNS logs). - Seleziona Amazon S3 V2 come Tipo di origine.
- Seleziona Cisco Umbrella DNS come Tipo di log.
- Fai clic su Avanti.
Specifica i valori per i seguenti parametri di input:
- URI S3:
s3://umbrella-dns-logs/dnslogs/ - Opzioni di eliminazione dell'origine: seleziona l'opzione di eliminazione in base alle tue preferenze.
- Età massima del 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.
- Chiave di accesso segreta: chiave segreta dell'utente con accesso al bucket S3.
- Spazio dei nomi dell'asset: lo spazio dei nomi dell'asset.
- Etichette di importazione: l'etichetta applicata agli eventi di questo feed.
- URI S3:
Fai clic su Avanti.
Controlla la nuova configurazione del feed di notizie nella schermata Finalizza e poi fai clic su Invia.
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
action |
security_result.action_details |
Il valore viene preso dal campo action, se esiste nei log JSON, o da column6 o column7 nei log CSV e convertito in lettere maiuscole (ALLOW o BLOCK). |
amp.disposition |
security_result.detection_fields[].key |
Il valore è ampDisposition. |
amp.disposition |
security_result.detection_fields[].value |
Il valore viene preso dal campo amp.disposition. |
amp.malware |
security_result.detection_fields[].key |
Il valore è ampMalware. |
amp.malware |
security_result.detection_fields[].value |
Il valore viene preso dal campo amp.malware. |
amp.score |
security_result.detection_fields[].key |
Il valore è ampScore. |
amp.score |
security_result.detection_fields[].value |
Il valore viene preso dal campo amp.score. |
blocked_categories |
security_result.category_details |
Il valore viene preso dal campo blocked_categories. |
blockedfiletype |
security_result.detection_fields[].key |
Il valore è egress type. |
blockedfiletype |
security_result.detection_fields[].value |
Il valore viene preso dal campo blockedfiletype. |
bundleid |
additional.fields[].key |
Il valore è bundleid. |
bundleid |
additional.fields[].value.string_value |
Il valore viene preso dal campo bundleid. |
categories[] |
security_result.category_details |
Il valore viene preso dal campo categories[].label. |
column1 |
metadata.event_timestamp.seconds |
Il valore viene analizzato dal campo column1 come timestamp. Per i log del proxy, se esistono i campi date e time, vengono combinati e analizzati come timestamp. |
column10 |
network.http.user_agent |
Il valore viene preso dal campo column10. |
column10 |
additional.fields[].value.string_value |
Il valore viene preso dal campo column10. |
column11 |
target.port |
Il valore viene preso dal campo column11. |
column12 |
principal.resource.name |
Il valore viene preso dal campo column12. |
column13 |
security_result.rule_id |
Il valore viene preso dal campo column13. |
column14 |
security_result.action_details |
Il valore viene preso dal campo column14. |
column2 |
principal.user.user_display_name |
Il valore viene preso dal campo column2. |
column2 |
principal.user.userid |
Il valore viene preso dal campo column2. |
column2 |
principal.location.name |
Il valore viene preso dal campo column2. |
column3 |
principal.hostname |
Il valore viene preso dal campo column3. |
column3 |
principal.user.product_object_id |
Il valore viene preso dal campo column3. |
column3 |
principal.location.city |
Il valore viene preso dal campo column3. |
column3 |
additional.fields[].value.string_value |
Il valore viene preso dal campo column3. |
column4 |
principal.asset.ip |
Il valore viene preso dal campo column4. |
column4 |
principal.ip |
Il valore viene preso dal campo column4. |
column4 |
principal.port |
Il valore viene preso dal campo column4. |
column5 |
principal.asset.ip |
Il valore viene preso dal campo column5. |
column5 |
principal.ip |
Il valore viene preso dal campo column5. |
column5 |
target.asset.ip |
Il valore viene preso dal campo column5. |
column5 |
target.ip |
Il valore viene preso dal campo column5. |
column6 |
security_result.action_details |
Il valore viene preso dal campo column6. |
column6 |
target.port |
Il valore viene preso dal campo column6. |
column7 |
network.received_bytes |
Il valore viene preso dal campo column7. |
column7 |
additional.fields[].value.string_value |
Il valore viene preso dal campo column7. |
column8 |
principal.asset.ip |
Il valore viene preso dal campo column8. |
column8 |
principal.ip |
Il valore viene preso dal campo column8. |
column8 |
target.url |
Il valore viene preso dal campo column8. |
column9 |
principal.port |
Il valore viene preso dal campo column9. |
column9 |
network.http.referral_url |
Il valore viene preso dal campo column9. |
data_center_name |
principal.resource.name |
Il valore viene preso dal campo data_center_name. |
datacenter.label |
security_result.detection_fields[].key |
Il valore è datacenter label. |
datacenter.label |
security_result.detection_fields[].value |
Il valore viene preso dal campo datacenter.label. |
destinationip |
target.asset.ip |
Il valore viene preso dal campo destinationip. |
destinationip |
target.ip |
Il valore viene preso dal campo destinationip. |
direction |
network.direction |
Il valore viene preso dal campo direction e convertito in maiuscolo. |
domain |
network.dns.questions[].name |
Il valore viene preso dal campo domain, con il punto finale rimosso se presente. |
dstPort |
target.port |
Il valore viene preso dal campo dstPort. |
dstip |
target.asset.ip |
Il valore viene preso dal campo dstip. |
dstip |
target.ip |
Il valore viene preso dal campo dstip. |
egress.ip |
security_result.detection_fields[].key |
Il valore è egress ip. |
egress.ip |
security_result.detection_fields[].value |
Il valore viene preso dal campo egress.ip. |
egress.type |
security_result.detection_fields[].key |
Il valore è egress type. |
egress.type |
security_result.detection_fields[].value |
Il valore viene preso dal campo egress.type. |
externalip |
principal.asset.ip |
Il valore viene preso dal campo externalip. |
externalip |
principal.ip |
Il valore viene preso dal campo externalip. |
forwardingmethod |
additional.fields[].key |
Il valore è forwardingmethod. |
forwardingmethod |
additional.fields[].value.string_value |
Il valore viene preso dal campo forwardingmethod. |
granular_identity |
principal.user.user_display_name |
Il valore viene preso dal campo granular_identity se sono presenti sia granular_identity che most_granular_identity. In caso contrario, viene derivato dal campo _policy_identity e analizzato ulteriormente in base a identityType. |
granular_identity |
principal.user.email_addresses |
Il valore viene estratto dal campo granular_identity utilizzando un'espressione regolare. |
granular_identity |
principal.user.first_name |
Il valore viene estratto dal campo granular_identity utilizzando un'espressione regolare. |
granular_identity |
principal.user.last_name |
Il valore viene estratto dal campo granular_identity utilizzando un'espressione regolare. |
granular_identity |
principal.user.userid |
Il valore viene estratto dal campo granular_identity utilizzando un'espressione regolare. |
granular_identity |
principal.hostname |
Il valore viene preso dal campo granular_identity. |
granular_identity |
principal.location.name |
Il valore viene preso dal campo granular_identity. |
identity_types |
additional.fields[].value.string_value |
Il valore viene preso dal campo identity_types. |
identities[] |
principal.user.product_object_id |
Il valore viene preso dal campo identities[]. |
identities |
principal.user.product_object_id |
Il valore viene preso dal campo identities. |
internalip |
principal.asset.ip |
Il valore viene preso dal campo internalip. |
internalip |
principal.ip |
Il valore viene preso dal campo internalip. |
isolated.fileaction |
security_result.detection_fields[].key |
Il valore è isolated fileaction. |
isolated.fileaction |
security_result.detection_fields[].value |
Il valore viene preso dal campo isolated.fileaction. |
isolated.state |
security_result.detection_fields[].key |
Il valore è isolated state. |
isolated.state |
security_result.detection_fields[].value |
Il valore viene preso dal campo isolated.state. |
most_granular_identity |
principal.user.identityType |
Il valore viene preso dal campo most_granular_identity se sono presenti sia granular_identity che most_granular_identity. In caso contrario, viene preso dal campo _policy_identity_type. |
nat_destination_ip |
principal.asset.ip |
Il valore viene preso dal campo nat_destination_ip. |
nat_destination_ip |
principal.ip |
Il valore viene preso dal campo nat_destination_ip. |
odns_categories |
security_result.category_details |
Il valore viene preso dal campo odns_categories. |
policy.ruleid |
security_result.rule_id |
Il valore viene preso dal campo policy.ruleid. |
policy.rulesetid |
security_result.detection_fields[].key |
Il valore è rulesetid. |
policy.rulesetid |
security_result.detection_fields[].value |
Il valore viene preso dal campo policy.rulesetid. |
policy.timebasedrule |
security_result.detection_fields[].key |
Il valore è timebasedrule. |
policy.timebasedrule |
security_result.detection_fields[].value |
Il valore viene preso dal campo policy.timebasedrule. |
port |
target.port |
Il valore viene preso dal campo port. |
query_type_name |
network.dns.questions[].type |
La parte numerica viene estratta dal campo query_type_name utilizzando un'espressione regolare e convertita in un numero intero. |
query_type_name |
additional.fields[].value.string_value |
La parte della stringa tra parentesi viene estratta dal campo query_type_name utilizzando un'espressione regolare. |
querytype |
network.dns.questions[].type |
Il valore viene preso dal campo querytype e mappato a un valore numerico in base al tipo di record DNS. |
referer |
network.http.referral_url |
Il valore viene preso dal campo referer. |
requestmethod |
network.http.method |
Il valore viene preso dal campo requestmethod. |
requestsize |
network.sent_bytes |
Il valore viene preso dal campo requestsize e convertito in un numero intero senza segno. |
response |
additional.fields[].value.string_value |
Il valore viene preso dal campo response. |
responsecode |
network.http.response_code |
Il valore viene preso dal campo responsecode. |
responsefilename |
target.file.names |
Il valore viene preso dal campo responsefilename. |
responsesize |
network.received_bytes |
Il valore viene preso dal campo responsesize e convertito in un numero intero senza segno. |
returncode |
network.dns.response_code |
Il valore viene preso dal campo returncode e convertito in un numero intero senza segno. |
securityoverridden |
additional.fields[].key |
Il valore è securityoverridden. |
securityoverridden |
additional.fields[].value.string_value |
Il valore viene preso dal campo securityoverridden. |
sha256 |
target.file.sha256 |
Il valore viene preso dal campo sha256. |
source_ip |
principal.asset.ip |
Il valore viene preso dal campo source_ip se esiste nei log JSON o da column3 nei log CSV. |
source_ip |
principal.ip |
Il valore viene preso dal campo source_ip se esiste nei log JSON o da column3 nei log CSV. |
srcPort |
principal.port |
Il valore viene preso dal campo srcPort. |
statuscode |
network.http.response_code |
Il valore viene preso dal campo statuscode. |
tenantcontrols |
additional.fields[].key |
Il valore è tenantcontrols. |
tenantcontrols |
additional.fields[].value.string_value |
Il valore viene preso dal campo tenantcontrols. |
timestamp |
metadata.event_timestamp.seconds |
Il valore viene analizzato dal campo timestamp come timestamp. |
tunnel_name |
additional.fields[].key |
Il valore è tunnel_name. |
tunnel_name |
additional.fields[].value.string_value |
Il valore viene preso dal campo tunnel_name. |
tunnel_type |
metadata.product_event_type |
Il valore viene preso dal campo tunnel_type. |
type |
additional.fields[].key |
Il valore è type. |
type |
additional.fields[].value.string_value |
Il valore viene preso dal campo type. |
url |
target.url |
Il valore viene preso dal campo url. |
useragent |
network.http.user_agent |
Il valore viene preso dal campo useragent. |
verdict |
security_result.action_details |
Il valore viene preso dal campo verdict. |
warnstatus |
security_result.detection_fields[].key |
Il valore è warnstatus. |
warnstatus |
security_result.detection_fields[].value |
Il valore viene preso dal campo warnstatus. Il valore è DNS Lookup Type. La parte della stringa tra parentesi viene estratta dal campo query_type_name utilizzando un'espressione regolare oppure è una stringa vuota se il campo non è presente. Il valore è DNS request and response were made. Determinato in base alla presenza di determinati campi: NETWORK_DNS se è presente question.name, NETWORK_CONNECTION se sono presenti sia principal.ip sia target.ip, STATUS_UPDATE se è presente solo principal.ip o GENERIC_EVENT in caso contrario. Il valore è UMBRELLA_DNS. Il valore è Umbrella DNS. Il valore è Cisco. Il valore è inizialmente impostato su DNS. Se requestmethod è un metodo HTTP valido, viene modificato in HTTP. La parte numerica viene estratta dal campo query_type_name utilizzando un'espressione regolare e convertita in un numero intero oppure viene derivata dal campo querytype e mappata a un valore numerico in base al tipo di record DNS. Il valore viene ricavato dal campo useragent o column10 utilizzando il filtro parseduseragent. Il valore viene preso dall'ultima parte del campo column3 dopo la suddivisione con virgole oppure è una stringa vuota se il campo non è presente. Il valore viene preso dalla prima parte del campo column3 dopo la suddivisione con virgole oppure dal campo column2 se column3 non è presente. Il valore viene estratto dal campo column2 o column3 utilizzando un'espressione regolare. Il valore viene estratto dal campo column2 o column3 utilizzando un'espressione regolare. Il valore viene estratto dal campo column2 o column3 utilizzando un'espressione regolare. Il valore viene estratto dal campo column2 o column3 utilizzando un'espressione regolare. Il valore viene ricavato dal campo action, column6, column7 o verdict e convertito in lettere maiuscole (ALLOW o BLOCK). Il valore è impostato su NETWORK_MALICIOUS se _categories contiene Malware o su NETWORK_SUSPICIOUS se _categories contiene Potentially Harmful. |
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.