Halaman ini diterjemahkan oleh Cloud Translation API.

Mengumpulkan log Snipe-IT

Didukung di:

Google SecOps SIEM

Dokumen ini menjelaskan cara menyerap log Snipe-IT ke Google Security Operations menggunakan Amazon S3.

Sebelum memulai

Pastikan Anda memenuhi prasyarat berikut:

Instance Google SecOps.
Akses istimewa ke tenant Snipe-IT.
Akses istimewa ke AWS (S3, Identity and Access Management (IAM), Lambda, EventBridge).

Kumpulkan prasyarat Snipe-IT (token API dan URL dasar)

Login ke Snipe-IT.
Buka menu pengguna Anda (avatar di kanan atas) dan klik Kelola kunci API.
Klik Create New API Key:
- Nama/Label: Masukkan label deskriptif (misalnya, Google SecOps export).
- Klik Generate.
Salin token API (hanya akan ditampilkan satu kali). Simpan dengan aman.
Tentukan URL dasar API Anda, biasanya:
- https://<your-domain>/api/v1
- Contoh: https://snipeit.example.com/api/v1

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, snipe-it-logs).
Buat Pengguna dengan mengikuti panduan pengguna ini: Membuat pengguna IAM.
Pilih Pengguna 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 Selesai.
Pilih tab Permissions.
Klik Tambahkan izin di bagian Kebijakan izin.
Pilih Tambahkan izin.
Pilih Lampirkan kebijakan secara langsung.
Cari kebijakan AmazonS3FullAccess.
Pilih kebijakan.
Klik Berikutnya.
Klik Add permissions.

Mengonfigurasi kebijakan dan peran IAM untuk upload S3

Di konsol AWS, buka IAM > Policies.
Klik Buat kebijakan > tab JSON.
Salin dan tempel kebijakan berikut.

Policy JSON (ganti snipe-it-logs jika Anda memasukkan nama bucket yang berbeda):

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowPutObjects",
      "Effect": "Allow",
      "Action": "s3:PutObject",
      "Resource": "arn:aws:s3:::snipe-it-logs/*"
    },
    {
      "Sid": "AllowGetStateObject",
      "Effect": "Allow",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::snipe-it-logs/snipeit/state.json"
    }
  ]
}

Klik Berikutnya > Buat kebijakan.
Buka IAM > Roles > Create role > AWS service > Lambda.
Lampirkan kebijakan yang baru dibuat.
Beri nama peran SnipeITToS3Role, lalu klik Buat peran.

Buat fungsi Lambda

Di Konsol AWS, buka Lambda > Functions > Create function.
Klik Buat dari awal.
Berikan detail konfigurasi berikut:

Setelan Nilai

Nama snipeit_assets_to_s3

Runtime Python 3.13

Arsitektur x86_64

Peran eksekusi SnipeITToS3Role

Setelan	Nilai
Nama	`snipeit_assets_to_s3`
Runtime	Python 3.13
Arsitektur	x86_64
Peran eksekusi	`SnipeITToS3Role`

Setelah fungsi dibuat, buka tab Code, hapus stub, dan tempelkan kode berikut (snipeit_assets_to_s3.py).

#!/usr/bin/env python3
# Lambda: Pull Snipe-IT hardware (assets) via REST API and write raw JSON pages to S3 (no transform)

import os, json, time, urllib.parse
from urllib.request import Request, urlopen
import boto3

BASE = os.environ["SNIPE_BASE_URL"].rstrip("/")  # e.g. https://snipeit.example.com/api/v1
TOKEN = os.environ["SNIPE_API_TOKEN"]
BUCKET = os.environ["S3_BUCKET"]
PREFIX = os.environ.get("S3_PREFIX", "snipeit/assets/")
PAGE_SIZE = int(os.environ.get("PAGE_SIZE", "500"))  # Snipe-IT max 500 per request
MAX_PAGES = int(os.environ.get("MAX_PAGES", "200"))

s3 = boto3.client("s3")

def _headers():
    return {"Authorization": f"Bearer {TOKEN}", "Accept": "application/json"}

def fetch_page(offset: int) -> dict:
    params = {"limit": PAGE_SIZE, "offset": offset, "sort": "id", "order": "asc"}
    qs = urllib.parse.urlencode(params)
    url = f"{BASE}/hardware?{qs}"
    req = Request(url, method="GET", headers=_headers())
    with urlopen(req, timeout=60) as r:
        return json.loads(r.read().decode("utf-8"))

def write_page(payload: dict, ts: float, page: int) -> str:
    key = f"{PREFIX}/{time.strftime('%Y/%m/%d', time.gmtime(ts))}/snipeit-hardware-{page:05d}.json"
    body = json.dumps(payload, separators=(",", ":")).encode("utf-8")
    s3.put_object(Bucket=BUCKET, Key=key, Body=body, ContentType="application/json")
    return key

def lambda_handler(event=None, context=None):
    ts = time.time()
    offset = 0
    page = 0
    total = 0

    while page < MAX_PAGES:
        data = fetch_page(offset)
        rows = data.get("rows") or data.get("data") or []
        write_page(data, ts, page)
        total += len(rows)
        if len(rows) < PAGE_SIZE:
            break
        page += 1
        offset += PAGE_SIZE

    return {"ok": True, "pages": page + 1, "objects": total}

if __name__ == "__main__":
    print(lambda_handler())

Buka Configuration > Environment variables.
Klik Edit > Tambahkan variabel lingkungan baru.
Masukkan variabel lingkungan yang diberikan dalam tabel berikut dengan mengganti nilai contoh dengan nilai Anda.

Variabel lingkungan

Kunci Nilai contoh

S3_BUCKET snipe-it-logs

S3_PREFIX snipeit/assets/

SNIPE_BASE_URL https://snipeit.example.com/api/v1

SNIPE_API_TOKEN <your-api-token>

PAGE_SIZE 500

MAX_PAGES 200
Setelah fungsi dibuat, tetap buka halamannya (atau buka Lambda > Functions > your-function).
Pilih tab Configuration
Di panel Konfigurasi umum, klik Edit.
Ubah Waktu Tunggu menjadi 5 menit (300 detik), lalu klik Simpan.

Kunci	Nilai contoh
`S3_BUCKET`	`snipe-it-logs`
`S3_PREFIX`	`snipeit/assets/`
`SNIPE_BASE_URL`	`https://snipeit.example.com/api/v1`
`SNIPE_API_TOKEN`	`<your-api-token>`
`PAGE_SIZE`	`500`
`MAX_PAGES`	`200`

Membuat jadwal EventBridge

Buka Amazon EventBridge > Scheduler > Create schedule.
Berikan detail konfigurasi berikut:
- Jadwal berulang: Tarif (1 hour).
- Target: Fungsi Lambda Anda snipeit_assets_to_s3.
- Name: snipeit_assets_to_s3-1h.
Klik Buat jadwal.

(Opsional) Buat pengguna dan kunci IAM hanya baca untuk Google SecOps

Buka Konsol AWS > IAM > Pengguna.
Klik Add users.
Berikan detail konfigurasi berikut:
- Pengguna: Masukkan secops-reader.
- Jenis akses: Pilih Kunci akses â€" Akses terprogram.
Klik Buat pengguna.
Lampirkan kebijakan baca minimal (kustom): Pengguna > secops-reader > Izin > Tambahkan izin > Lampirkan kebijakan secara langsung > Buat kebijakan.

JSON:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:GetObject"],
      "Resource": "arn:aws:s3:::snipe-it-logs/*"
    },
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket"],
      "Resource": "arn:aws:s3:::snipe-it-logs"
    }
  ]
}

Nama = secops-reader-policy.
Klik Buat kebijakan > cari/pilih > Berikutnya > Tambahkan izin.
Buat kunci akses untuk secops-reader: Kredensial keamanan > Kunci akses.
Klik Create access key.
Download .CSV. (Anda akan menempelkan nilai ini ke feed).

Mengonfigurasi feed di Google SecOps untuk menyerap log Snipe-IT

Buka Setelan SIEM > Feed.
Klik + Tambahkan Feed Baru.
Di kolom Nama feed, masukkan nama untuk feed (misalnya, Snipe-IT logs).
Pilih Amazon S3 V2 sebagai Jenis sumber.
Pilih Snipe-IT sebagai Jenis log.
Klik Berikutnya.
Tentukan nilai untuk parameter input berikut:
- URI S3: s3://snipe-it-logs/snipeit/assets/
- Opsi penghapusan sumber: Pilih opsi penghapusan sesuai preferensi Anda.
- Usia File Maksimum: Menyertakan file yang diubah dalam jumlah hari terakhir. Defaultnya adalah 180 hari.
- ID Kunci Akses: Kunci akses pengguna dengan akses ke bucket S3.
- Kunci Akses Rahasia: Kunci rahasia pengguna dengan akses ke bucket S3.
- Namespace aset: Namespace aset.
- Label penyerapan: Label yang diterapkan ke peristiwa dari feed ini.
Klik Berikutnya.
Tinjau konfigurasi feed baru Anda di layar Selesaikan, lalu klik Kirim.

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.