Mengumpulkan log Tailscale
Dokumen ini menjelaskan cara menyerap log Tailscale ke Google Security Operations menggunakan fitur streaming log Amazon S3 native Tailscale. Tailscale menghasilkan data operasional dalam bentuk log audit konfigurasi dan log aliran jaringan. Integrasi ini menggunakan kemampuan streaming S3 bawaan Tailscale untuk otomatis mengirim log ini ke Google SecOps untuk analisis dan pemantauan.
Sebelum memulai
Pastikan Anda memiliki prasyarat berikut:
- Instance Google SecOps
- Akses istimewa ke Tailscale Admin Console (peran Owner, Admin, Network admin, atau admin IT)
- Akses istimewa ke AWS (S3, IAM)
Mengumpulkan prasyarat Tailscale (informasi tailnet)
- Login ke Tailscale Admin Console.
- Catat nama tailnet Anda (misalnya,
example.comatau nama organisasi Anda). - Pastikan Anda memiliki paket yang diperlukan:
- Streaming log audit konfigurasi: Tersedia di paket Personal, Personal Plus, dan Enterprise.
- Streaming log aliran jaringan: Hanya tersedia di paket Enterprise.
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,
tailscale-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 digunakan nanti.
- Klik Done.
- Pilih tab Izin.
- Klik Tambahkan izin di bagian Kebijakan Izin.
- Pilih Add permissions.
- Pilih Attach policies directly
- Telusuri dan pilih kebijakan AmazonS3FullAccess.
- Klik Berikutnya.
- Klik Add permissions.
Mengonfigurasi kebijakan dan peran IAM untuk upload S3
- Di AWS console, buka tab IAM > Policies > Create policy > JSON.
Masukkan kebijakan berikut:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowTailscalePutObjects", "Effect": "Allow", "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::tailscale-logs/*" } ] }- Ganti
tailscale-logsjika Anda memasukkan nama bucket yang berbeda.
- Ganti
Klik Next > Create policy.
Buka IAM > Roles > Create role > Custom trust policy.
Masukkan kebijakan kepercayaan berikut:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::982722776073:role/tailscale-log-streaming" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "sts:ExternalId": "YOUR_TAILNET_NAME" } } } ] }- Ganti
YOUR_TAILNET_NAMEdengan nama tailnet Anda yang sebenarnya.
- Ganti
Klik Berikutnya.
Lampirkan kebijakan yang dibuat di langkah 1.
Beri nama peran
TailscaleS3StreamingRoledan klik Create role.Salin Role ARN untuk digunakan dalam konfigurasi Tailscale.
Mengonfigurasi streaming log S3 native Tailscale
Menyiapkan streaming Log Audit Konfigurasi
- Di Tailscale Admin Console, buka Logs > Configuration logs.
- Klik Mulai streaming.
- Pilih Amazon S3 sebagai tujuan.
- Berikan detail konfigurasi berikut:
- ID Akun AWS: ID Akun AWS Anda.
- S3 Bucket Name:
tailscale-logs. - Role ARN: ARN peran IAM yang Anda buat.
- S3 Key Prefix:
tailscale/configuration/(opsional).
- Klik Mulai streaming.
- Pastikan statusnya ditampilkan sebagai Aktif.
Menyiapkan streaming Log Aliran Jaringan (khusus paket Enterprise)
- Jika belum diaktifkan, buka Settings > Network flow logs dan aktifkan log alur jaringan untuk tailnet Anda.
- Buka Logs > Network flow logs.
- Klik Mulai streaming.
- Pilih Amazon S3 sebagai tujuan.
- Berikan detail konfigurasi berikut:
- ID Akun AWS: ID Akun AWS Anda
- S3 Bucket Name:
tailscale-logs - Role ARN: ARN peran IAM yang Anda buat
- S3 Key Prefix:
tailscale/network/(opsional)
- Klik Mulai streaming.
- Pastikan statusnya ditampilkan sebagai Aktif.
Opsional: Membuat pengguna & kunci IAM hanya baca untuk Google SecOps
- Di AWS Console, buka IAM > Users > Add users.
- Klik Add users.
- Berikan detail konfigurasi berikut:
- Pengguna:
secops-reader - Access type: Access key — Programmatic access
- Pengguna:
- Klik Create user.
- Lampirkan kebijakan baca minimal (kustom): Users > secops-reader > Permissions > Add permissions > Attach policies directly > Create policy.
Di editor JSON, masukkan kebijakan berikut:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": ["s3:GetObject"], "Resource": "arn:aws:s3:::tailscale-logs/*" }, { "Effect": "Allow", "Action": ["s3:ListBucket"], "Resource": "arn:aws:s3:::tailscale-logs" } ] }Tetapkan nama ke
secops-reader-policy.Buka Create policy > telusuri/pilih > Next > Add permissions.
Buka Security credentials > Access keys > Create access key.
Download CSV (nilai ini dimasukkan ke dalam feed).
Mengonfigurasi feed di Google SecOps untuk menyerap log Tailscale
- 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,
Tailscale logs). - Pilih Amazon S3 V2 sebagai Jenis sumber.
- Pilih Tailscale sebagai Log type.
- Klik Berikutnya.
- Tentukan nilai untuk parameter input berikut:
- S3 URI:
s3://tailscale-logs/tailscale/ - 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 |
|---|---|---|
exit_traf_src_port_label |
additional.fields |
Digabung |
exit_traf_txBytes_label |
additional.fields |
Digabung |
exit_traf_txPkts_label |
additional.fields |
Digabung |
nodeId_label |
additional.fields |
Digabung |
origin_label |
additional.fields |
Digabung |
phy_traf_rxBytes_label |
additional.fields |
Digabung |
phy_traf_rxPkts_label |
additional.fields |
Digabung |
phy_traf_txBytes_label |
additional.fields |
Digabung |
phy_traf_txPkts_label |
additional.fields |
Digabung |
target1_id_label |
additional.fields |
Digabung |
target1_type_label |
additional.fields |
Digabung |
vir_traf_rxBytes_label |
additional.fields |
Digabung |
vir_traf_rxPkts_label |
additional.fields |
Digabung |
vir_traf_txBytes_label |
additional.fields |
Digabung |
vir_traf_txPkts_label |
additional.fields |
Digabung |
action |
extensions.auth.type |
Dipetakan: LOGIN → AUTHTYPE_UNSPECIFIED |
start |
metadata.event_timestamp |
Diurai sebagai ISO8601 |
event_type |
metadata.event_type |
Dipetakan secara langsung |
exit_traf.txPkts |
network.received_bytes |
Dipetakan secara langsung |
index |
network.received_bytes |
Dipetakan: 0 → uinteger |
phy_traf.rxBytes |
network.received_bytes |
Dipetakan secara langsung |
phy_traf.rxPkts |
network.received_bytes |
Dipetakan secara langsung |
exit_traf.txBytes |
network.sent_bytes |
Dipetakan secara langsung |
index |
network.sent_bytes |
Dipetakan: 0 → uinteger |
phy_traf.txBytes |
network.sent_bytes |
Dipetakan secara langsung |
phy_traf.txPkts |
network.sent_bytes |
Dipetakan secara langsung |
target1.name |
principal.asset.hostname |
Dipetakan secara langsung |
src_ip |
principal.asset.ip |
Digabung |
target1.name |
principal.hostname |
Dipetakan secara langsung |
src_ip |
principal.ip |
Digabung |
src_port |
principal.port |
Dipetakan secara langsung |
action |
security_result.action_details |
Dipetakan secara langsung |
action_details_label |
security_result.detection_fields |
Digabung |
eventGroupID_label |
security_result.detection_fields |
Digabung |
dst_ip |
target.asset.ip |
Digabung |
dst_ip |
target.ip |
Digabung |
dst_port |
target.port |
Dipetakan secara langsung |
actor_loginName |
target.user.email_addresses |
Digabung |
actor_display_name |
target.user.user_display_name |
Dipetakan secara langsung |
actor_id |
target.user.userid |
Dipetakan secara langsung |
| T/A | extensions.auth.type |
Konstanta: AUTHTYPE_UNSPECIFIED |
| T/A | metadata.event_type |
Konstanta: GENERIC_EVENT |
Log Perubahan
Melihat Log Perubahan untuk parser ini
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.