Mengumpulkan log Tailscale

Didukung di:

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)

  1. Login ke Tailscale Admin Console.
  2. Catat nama tailnet Anda (misalnya, example.com atau nama organisasi Anda).
  3. 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

  1. Buat bucket Amazon S3 dengan mengikuti panduan pengguna ini: Membuat bucket
  2. Simpan Name dan Region bucket untuk referensi di masa mendatang (misalnya, tailscale-logs).
  3. Buat pengguna dengan mengikuti panduan pengguna ini: Membuat pengguna IAM.
  4. Pilih User yang dibuat.
  5. Pilih tab kredensial keamanan.
  6. Klik Create Access Key di bagian Access Keys.
  7. Pilih Layanan pihak ketiga sebagai Kasus penggunaan.
  8. Klik Berikutnya.
  9. Opsional: tambahkan tag deskripsi.
  10. Klik Create access key.
  11. Klik Download CSV file untuk menyimpan Access Key dan Secret Access Key untuk digunakan nanti.
  12. Klik Done.
  13. Pilih tab Izin.
  14. Klik Tambahkan izin di bagian Kebijakan Izin.
  15. Pilih Add permissions.
  16. Pilih Attach policies directly
  17. Telusuri dan pilih kebijakan AmazonS3FullAccess.
  18. Klik Berikutnya.
  19. Klik Add permissions.

Mengonfigurasi kebijakan dan peran IAM untuk upload S3

  1. Di AWS console, buka tab IAM > Policies > Create policy > JSON.
  2. 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-logs jika Anda memasukkan nama bucket yang berbeda.
  3. Klik Next > Create policy.

  4. Buka IAM > Roles > Create role > Custom trust policy.

  5. 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_NAME dengan nama tailnet Anda yang sebenarnya.
  6. Klik Berikutnya.

  7. Lampirkan kebijakan yang dibuat di langkah 1.

  8. Beri nama peran TailscaleS3StreamingRole dan klik Create role.

  9. Salin Role ARN untuk digunakan dalam konfigurasi Tailscale.

Mengonfigurasi streaming log S3 native Tailscale

Menyiapkan streaming Log Audit Konfigurasi

  1. Di Tailscale Admin Console, buka Logs > Configuration logs.
  2. Klik Mulai streaming.
  3. Pilih Amazon S3 sebagai tujuan.
  4. 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).
  5. Klik Mulai streaming.
  6. Pastikan statusnya ditampilkan sebagai Aktif.

Menyiapkan streaming Log Aliran Jaringan (khusus paket Enterprise)

  1. Jika belum diaktifkan, buka Settings > Network flow logs dan aktifkan log alur jaringan untuk tailnet Anda.
  2. Buka Logs > Network flow logs.
  3. Klik Mulai streaming.
  4. Pilih Amazon S3 sebagai tujuan.
  5. 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)
  6. Klik Mulai streaming.
  7. Pastikan statusnya ditampilkan sebagai Aktif.

Opsional: Membuat pengguna & kunci IAM hanya baca untuk Google SecOps

  1. Di AWS Console, buka IAM > Users > Add users.
  2. Klik Add users.
  3. Berikan detail konfigurasi berikut:
    • Pengguna: secops-reader
    • Access type: Access key — Programmatic access
  4. Klik Create user.
  5. Lampirkan kebijakan baca minimal (kustom): Users > secops-reader > Permissions > Add permissions > Attach policies directly > Create policy.
  6. 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"
        }
      ]
    }
    
  7. Tetapkan nama ke secops-reader-policy.

  8. Buka Create policy > telusuri/pilih > Next > Add permissions.

  9. Buka Security credentials > Access keys > Create access key.

  10. Download CSV (nilai ini dimasukkan ke dalam feed).

Mengonfigurasi feed di Google SecOps untuk menyerap log Tailscale

  1. Buka Setelan > Pengelolaan Data > Feed. Jika Anda menggunakan platform khusus SIEM, buka Settings > Feeds.
  2. Klik + Tambahkan Feed Baru.
  3. Di kolom Nama feed, masukkan nama untuk feed (misalnya, Tailscale logs).
  4. Pilih Amazon S3 V2 sebagai Jenis sumber.
  5. Pilih Tailscale sebagai Log type.
  6. Klik Berikutnya.
  7. 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.
  8. Klik Berikutnya.
  9. 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.