Mengumpulkan log DNS Cisco Umbrella
Versi Parser: 17.0
Dokumen ini menjelaskan cara menyerap log DNS Cisco Umbrella ke Google Security Operations menggunakan Amazon S3. Cisco Umbrella adalah layanan keamanan berbasis cloud yang menyediakan perlindungan lapisan DNS, gateway web yang aman, dan fungsi broker keamanan akses cloud (CASB). Log DNS Umbrella mencatat aktivitas kueri DNS di seluruh jaringan Anda, termasuk domain yang diminta, kode respons, dan tindakan kebijakan keamanan yang diambil pada setiap permintaan.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps.
- Akses istimewa ke dasbor Cisco Umbrella dengan peran Admin Penuh atau Admin Hanya Baca.
- Akses istimewa ke AWS (S3, IAM).
Mengonfigurasi ekspor log Cisco Umbrella ke Amazon S3
Cisco Umbrella secara native mendukung ekspor log DNS ke bucket Amazon S3 yang Anda kelola.
- Login ke dasbor Cisco Umbrella di
https://dashboard.umbrella.com. - Buka Admin > Log Management.
- Klik Gunakan bucket Amazon S3 yang dikelola perusahaan Anda.
- Berikan detail konfigurasi berikut:
- Bucket Name: Masukkan nama bucket S3 yang akan Anda buat di bagian berikutnya (misalnya,
umbrella-dns-logs). - Region: Pilih region AWS tempat bucket Anda akan dibuat.
- Bucket Name: Masukkan nama bucket S3 yang akan Anda buat di bagian berikutnya (misalnya,
- Salin ID Akun AWS dan ID Eksternal yang ditampilkan oleh Umbrella. Anda akan memerlukan nilai ini untuk mengonfigurasi kebijakan kepercayaan IAM di AWS.
- Klik Simpan.
Mengonfigurasi bucket AWS S3 dan IAM untuk Google SecOps
- Buat bucket Amazon S3 dengan mengikuti panduan pengguna ini: Membuat bucket
- Simpan Name dan Region bucket untuk referensi di masa mendatang (misalnya,
umbrella-dns-logs). - Buat Pengguna dengan mengikuti panduan pengguna ini: Membuat pengguna IAM.
- Pilih User yang dibuat.
- Pilih tab kredensial keamanan.
- Klik Create Access Key di bagian Access Keys.
- Pilih Layanan pihak ketiga sebagai Kasus penggunaan.
- Klik Berikutnya.
- Opsional: Tambahkan tag deskripsi.
- Klik Create access key.
- Klik Download CSV file untuk menyimpan Access Key dan Secret Access Key untuk referensi di masa mendatang.
- Klik Done.
- Pilih tab Permissions.
- Klik Add permissions di bagian Kebijakan Izin.
- Pilih Add permissions.
- Pilih Attach policies directly.
- Telusuri kebijakan AmazonS3FullAccess.
- Pilih kebijakan.
- Klik Berikutnya.
- Klik Add permissions.
Mengonfigurasi kebijakan dan peran IAM untuk akses S3 Cisco Umbrella
Cisco Umbrella memerlukan peran IAM lintas akun untuk menulis log ke bucket S3 Anda.
- Di konsol AWS, buka IAM > Policies > Create policy > tab JSON.
Salin dan tempel kebijakan berikut (ganti
umbrella-dns-logsjika Anda memasukkan nama bucket yang berbeda):{ "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/*" ] } ] }Klik Next > Create policy. Beri nama
UmbrellaS3WritePolicy.Buka IAM > Roles > Create role > Custom trust policy.
Tempel kebijakan kepercayaan berikut, dengan mengganti
UMBRELLA_AWS_ACCOUNT_IDdanUMBRELLA_EXTERNAL_IDdengan nilai yang disalin dari dasbor 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" } } } ] }Klik Berikutnya.
Lampirkan kebijakan
UmbrellaS3WritePolicy.Beri nama peran
UmbrellaS3Roledan klik Create role.Salin Role ARN untuk digunakan di dasbor Umbrella.
Memverifikasi ekspor log Cisco Umbrella
- Kembali ke dasbor Cisco Umbrella.
- Buka Admin > Log Management.
- Masukkan Role ARN dari peran IAM yang Anda buat.
- Klik Verify untuk mengonfirmasi bahwa Umbrella dapat menulis ke bucket S3.
- Setelah verifikasi berhasil, Umbrella akan mulai mengekspor log DNS ke bucket S3.
Mengonfigurasi feed di Google SecOps untuk menyerap log DNS Cisco Umbrella
- Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
- Klik + Tambahkan Feed Baru.
- Di kolom Nama feed, masukkan nama untuk feed (misalnya,
Cisco Umbrella DNS logs). - Pilih Amazon S3 V2 sebagai Jenis sumber.
- Pilih Cisco Umbrella DNS sebagai Log type.
- Klik Berikutnya.
Tentukan nilai untuk parameter input berikut:
- S3 URI:
s3://umbrella-dns-logs/dnslogs/ - Opsi penghapusan sumber: Pilih opsi penghapusan sesuai preferensi Anda.
- Usia File Maksimum: Sertakan file yang diubah dalam jumlah hari terakhir. Defaultnya adalah 180 hari.
- Access Key ID: Kunci akses pengguna dengan akses ke bucket S3.
- Secret Access Key: Kunci rahasia pengguna dengan akses ke bucket S3.
- Namespace aset: Namespace aset.
- Label penyerapan: Label yang diterapkan ke peristiwa dari feed ini.
- S3 URI:
Klik Berikutnya.
Tinjau konfigurasi feed berita baru Anda di layar Finalize, lalu klik Submit.
Tabel Pemetaan UDM
| Kolom Log | Pemetaan UDM | Logika |
|---|---|---|
action |
security_result.action_details |
Nilai diambil dari kolom action jika ada di log JSON, atau dari column6 atau column7 di log CSV, dan dikonversi menjadi huruf besar (ALLOW atau BLOCK). |
amp.disposition |
security_result.detection_fields[].key |
Nilainya adalah ampDisposition. |
amp.disposition |
security_result.detection_fields[].value |
Nilai diambil dari kolom amp.disposition. |
amp.malware |
security_result.detection_fields[].key |
Nilainya adalah ampMalware. |
amp.malware |
security_result.detection_fields[].value |
Nilai diambil dari kolom amp.malware. |
amp.score |
security_result.detection_fields[].key |
Nilainya adalah ampScore. |
amp.score |
security_result.detection_fields[].value |
Nilai diambil dari kolom amp.score. |
blocked_categories |
security_result.category_details |
Nilai diambil dari kolom blocked_categories. |
blockedfiletype |
security_result.detection_fields[].key |
Nilainya adalah egress type. |
blockedfiletype |
security_result.detection_fields[].value |
Nilai diambil dari kolom blockedfiletype. |
bundleid |
additional.fields[].key |
Nilainya adalah bundleid. |
bundleid |
additional.fields[].value.string_value |
Nilai diambil dari kolom bundleid. |
categories[] |
security_result.category_details |
Nilai diambil dari kolom categories[].label. |
column1 |
metadata.event_timestamp.seconds |
Nilai diuraikan dari kolom column1 sebagai stempel waktu. Untuk log proxy, jika kolom date dan time ada, kolom tersebut akan digabungkan dan diuraikan sebagai stempel waktu. |
column10 |
network.http.user_agent |
Nilai diambil dari kolom column10. |
column10 |
additional.fields[].value.string_value |
Nilai diambil dari kolom column10. |
column11 |
target.port |
Nilai diambil dari kolom column11. |
column12 |
principal.resource.name |
Nilai diambil dari kolom column12. |
column13 |
security_result.rule_id |
Nilai diambil dari kolom column13. |
column14 |
security_result.action_details |
Nilai diambil dari kolom column14. |
column2 |
principal.user.user_display_name |
Nilai diambil dari kolom column2. |
column2 |
principal.user.userid |
Nilai diambil dari kolom column2. |
column2 |
principal.location.name |
Nilai diambil dari kolom column2. |
column3 |
principal.hostname |
Nilai diambil dari kolom column3. |
column3 |
principal.user.product_object_id |
Nilai diambil dari kolom column3. |
column3 |
principal.location.city |
Nilai diambil dari kolom column3. |
column3 |
additional.fields[].value.string_value |
Nilai diambil dari kolom column3. |
column4 |
principal.asset.ip |
Nilai diambil dari kolom column4. |
column4 |
principal.ip |
Nilai diambil dari kolom column4. |
column4 |
principal.port |
Nilai diambil dari kolom column4. |
column5 |
principal.asset.ip |
Nilai diambil dari kolom column5. |
column5 |
principal.ip |
Nilai diambil dari kolom column5. |
column5 |
target.asset.ip |
Nilai diambil dari kolom column5. |
column5 |
target.ip |
Nilai diambil dari kolom column5. |
column6 |
security_result.action_details |
Nilai diambil dari kolom column6. |
column6 |
target.port |
Nilai diambil dari kolom column6. |
column7 |
network.received_bytes |
Nilai diambil dari kolom column7. |
column7 |
additional.fields[].value.string_value |
Nilai diambil dari kolom column7. |
column8 |
principal.asset.ip |
Nilai diambil dari kolom column8. |
column8 |
principal.ip |
Nilai diambil dari kolom column8. |
column8 |
target.url |
Nilai diambil dari kolom column8. |
column9 |
principal.port |
Nilai diambil dari kolom column9. |
column9 |
network.http.referral_url |
Nilai diambil dari kolom column9. |
data_center_name |
principal.resource.name |
Nilai diambil dari kolom data_center_name. |
datacenter.label |
security_result.detection_fields[].key |
Nilainya adalah datacenter label. |
datacenter.label |
security_result.detection_fields[].value |
Nilai diambil dari kolom datacenter.label. |
destinationip |
target.asset.ip |
Nilai diambil dari kolom destinationip. |
destinationip |
target.ip |
Nilai diambil dari kolom destinationip. |
direction |
network.direction |
Nilai diambil dari kolom direction dan dikonversi menjadi huruf besar. |
domain |
network.dns.questions[].name |
Nilai diambil dari kolom domain, dengan titik di akhir dihapus jika ada. |
dstPort |
target.port |
Nilai diambil dari kolom dstPort. |
dstip |
target.asset.ip |
Nilai diambil dari kolom dstip. |
dstip |
target.ip |
Nilai diambil dari kolom dstip. |
egress.ip |
security_result.detection_fields[].key |
Nilainya adalah egress ip. |
egress.ip |
security_result.detection_fields[].value |
Nilai diambil dari kolom egress.ip. |
egress.type |
security_result.detection_fields[].key |
Nilainya adalah egress type. |
egress.type |
security_result.detection_fields[].value |
Nilai diambil dari kolom egress.type. |
externalip |
principal.asset.ip |
Nilai diambil dari kolom externalip. |
externalip |
principal.ip |
Nilai diambil dari kolom externalip. |
forwardingmethod |
additional.fields[].key |
Nilainya adalah forwardingmethod. |
forwardingmethod |
additional.fields[].value.string_value |
Nilai diambil dari kolom forwardingmethod. |
granular_identity |
principal.user.user_display_name |
Nilai diambil dari kolom granular_identity jika granular_identity dan most_granular_identity ada. Jika tidak, ID ini akan berasal dari kolom _policy_identity dan diurai lebih lanjut berdasarkan identityType. |
granular_identity |
principal.user.email_addresses |
Nilai diekstrak dari kolom granular_identity menggunakan ekspresi reguler. |
granular_identity |
principal.user.first_name |
Nilai diekstrak dari kolom granular_identity menggunakan ekspresi reguler. |
granular_identity |
principal.user.last_name |
Nilai diekstrak dari kolom granular_identity menggunakan ekspresi reguler. |
granular_identity |
principal.user.userid |
Nilai diekstrak dari kolom granular_identity menggunakan ekspresi reguler. |
granular_identity |
principal.hostname |
Nilai diambil dari kolom granular_identity. |
granular_identity |
principal.location.name |
Nilai diambil dari kolom granular_identity. |
identity_types |
additional.fields[].value.string_value |
Nilai diambil dari kolom identity_types. |
identities[] |
principal.user.product_object_id |
Nilai diambil dari kolom identities[]. |
identities |
principal.user.product_object_id |
Nilai diambil dari kolom identities. |
internalip |
principal.asset.ip |
Nilai diambil dari kolom internalip. |
internalip |
principal.ip |
Nilai diambil dari kolom internalip. |
isolated.fileaction |
security_result.detection_fields[].key |
Nilainya adalah isolated fileaction. |
isolated.fileaction |
security_result.detection_fields[].value |
Nilai diambil dari kolom isolated.fileaction. |
isolated.state |
security_result.detection_fields[].key |
Nilainya adalah isolated state. |
isolated.state |
security_result.detection_fields[].value |
Nilai diambil dari kolom isolated.state. |
most_granular_identity |
principal.user.identityType |
Nilai diambil dari kolom most_granular_identity jika granular_identity dan most_granular_identity ada. Jika tidak, nilai ini diambil dari kolom _policy_identity_type. |
nat_destination_ip |
principal.asset.ip |
Nilai diambil dari kolom nat_destination_ip. |
nat_destination_ip |
principal.ip |
Nilai diambil dari kolom nat_destination_ip. |
odns_categories |
security_result.category_details |
Nilai diambil dari kolom odns_categories. |
policy.ruleid |
security_result.rule_id |
Nilai diambil dari kolom policy.ruleid. |
policy.rulesetid |
security_result.detection_fields[].key |
Nilainya adalah rulesetid. |
policy.rulesetid |
security_result.detection_fields[].value |
Nilai diambil dari kolom policy.rulesetid. |
policy.timebasedrule |
security_result.detection_fields[].key |
Nilainya adalah timebasedrule. |
policy.timebasedrule |
security_result.detection_fields[].value |
Nilai diambil dari kolom policy.timebasedrule. |
port |
target.port |
Nilai diambil dari kolom port. |
query_type_name |
network.dns.questions[].type |
Bagian numerik diekstrak dari kolom query_type_name menggunakan ekspresi reguler dan dikonversi menjadi bilangan bulat. |
query_type_name |
additional.fields[].value.string_value |
Bagian string dalam tanda kurung diekstrak dari kolom query_type_name menggunakan ekspresi reguler. |
querytype |
network.dns.questions[].type |
Nilai diambil dari kolom querytype dan dipetakan ke nilai numerik berdasarkan jenis data DNS. |
referer |
network.http.referral_url |
Nilai diambil dari kolom referer. |
requestmethod |
network.http.method |
Nilai diambil dari kolom requestmethod. |
requestsize |
network.sent_bytes |
Nilai diambil dari kolom requestsize dan dikonversi menjadi bilangan bulat yang tidak bertanda tangan. |
response |
additional.fields[].value.string_value |
Nilai diambil dari kolom response. |
responsecode |
network.http.response_code |
Nilai diambil dari kolom responsecode. |
responsefilename |
target.file.names |
Nilai diambil dari kolom responsefilename. |
responsesize |
network.received_bytes |
Nilai diambil dari kolom responsesize dan dikonversi menjadi bilangan bulat yang tidak bertanda tangan. |
returncode |
network.dns.response_code |
Nilai diambil dari kolom returncode dan dikonversi menjadi bilangan bulat yang tidak bertanda tangan. |
securityoverridden |
additional.fields[].key |
Nilainya adalah securityoverridden. |
securityoverridden |
additional.fields[].value.string_value |
Nilai diambil dari kolom securityoverridden. |
sha256 |
target.file.sha256 |
Nilai diambil dari kolom sha256. |
source_ip |
principal.asset.ip |
Nilai diambil dari kolom source_ip jika ada di log JSON, atau dari column3 di log CSV. |
source_ip |
principal.ip |
Nilai diambil dari kolom source_ip jika ada di log JSON, atau dari column3 di log CSV. |
srcPort |
principal.port |
Nilai diambil dari kolom srcPort. |
statuscode |
network.http.response_code |
Nilai diambil dari kolom statuscode. |
tenantcontrols |
additional.fields[].key |
Nilainya adalah tenantcontrols. |
tenantcontrols |
additional.fields[].value.string_value |
Nilai diambil dari kolom tenantcontrols. |
timestamp |
metadata.event_timestamp.seconds |
Nilai diuraikan dari kolom timestamp sebagai stempel waktu. |
tunnel_name |
additional.fields[].key |
Nilainya adalah tunnel_name. |
tunnel_name |
additional.fields[].value.string_value |
Nilai diambil dari kolom tunnel_name. |
tunnel_type |
metadata.product_event_type |
Nilai diambil dari kolom tunnel_type. |
type |
additional.fields[].key |
Nilainya adalah type. |
type |
additional.fields[].value.string_value |
Nilai diambil dari kolom type. |
url |
target.url |
Nilai diambil dari kolom url. |
useragent |
network.http.user_agent |
Nilai diambil dari kolom useragent. |
verdict |
security_result.action_details |
Nilai diambil dari kolom verdict. |
warnstatus |
security_result.detection_fields[].key |
Nilainya adalah warnstatus. |
warnstatus |
security_result.detection_fields[].value |
Nilai diambil dari kolom warnstatus. Nilainya adalah DNS Lookup Type. Bagian string dalam tanda kurung diekstrak dari kolom query_type_name menggunakan ekspresi reguler, atau merupakan string kosong jika kolom tidak ada. Nilainya adalah DNS request and response were made. Ditentukan berdasarkan ada tidaknya kolom tertentu: NETWORK_DNS jika question.name ada, NETWORK_CONNECTION jika principal.ip dan target.ip ada, STATUS_UPDATE jika hanya principal.ip yang ada, atau GENERIC_EVENT jika tidak. Nilainya adalah UMBRELLA_DNS. Nilainya adalah Umbrella DNS. Nilainya adalah Cisco. Nilai awalnya ditetapkan ke DNS. Jika requestmethod adalah metode HTTP yang valid, metode tersebut akan diubah menjadi HTTP. Bagian numerik diekstrak dari kolom query_type_name menggunakan ekspresi reguler dan dikonversi menjadi bilangan bulat, atau berasal dari kolom querytype dan dipetakan ke nilai numerik berdasarkan jenis data DNS. Nilai ini berasal dari kolom useragent atau column10 menggunakan filter parseduseragent. Nilai diambil dari bagian terakhir kolom column3 setelah dipisahkan dengan koma, atau berupa string kosong jika kolom tidak ada. Nilai diambil dari bagian pertama kolom column3 setelah dipisahkan dengan koma, atau diambil dari kolom column2 jika column3 tidak ada. Nilai diekstrak dari kolom column2 atau column3 menggunakan ekspresi reguler. Nilai diekstrak dari kolom column2 atau column3 menggunakan ekspresi reguler. Nilai diekstrak dari kolom column2 atau column3 menggunakan ekspresi reguler. Nilai diekstrak dari kolom column2 atau column3 menggunakan ekspresi reguler. Nilai ini berasal dari kolom action, column6, column7, atau verdict dan dikonversi menjadi huruf besar (ALLOW atau BLOCK). Nilai ditetapkan ke NETWORK_MALICIOUS jika _categories berisi Malware, atau NETWORK_SUSPICIOUS jika _categories berisi Potentially Harmful. |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.