このページは Cloud Translation API によって翻訳されました。

Snipe-IT のログを収集する

以下でサポートされています。

Google SecOps SIEM

このドキュメントでは、Amazon S3 を使用して Snipe-IT ログを Google Security Operations に取り込む方法について説明します。

始める前に

次の前提条件を満たしていることを確認してください。

Google SecOps インスタンス。
Snipe-IT テナントに対する特権アクセス。
AWS（S3、Identity and Access Management（IAM）、Lambda、EventBridge）への特権アクセス。

Snipe-IT の前提条件（API トークンとベース URL）を収集する

Snipe-IT にログインします。
ユーザーメニュー（右上のアバター）を開き、[API キーを管理] をクリックします。
[Create New API Key] をクリックします。
- 名前/ラベル: わかりやすいラベルを入力します（例: Google SecOps export）。
- [生成] をクリックします。
API トークンをコピーします（このトークンは 1 回だけ表示されます）。安全に保管してください。
API ベース URL を特定します。通常は次のようになります。
- https://<your-domain>/api/v1
- 例: https://snipeit.example.com/api/v1

Google SecOps 用に AWS S3 バケットと IAM を構成する

バケットの作成のユーザーガイドに沿って、Amazon S3 バケットを作成します。
後で参照できるように、バケットの名前とリージョンを保存します（例: snipe-it-logs）。
IAM ユーザーの作成のユーザーガイドに沿って、ユーザーを作成します。
作成したユーザーを選択します。
[セキュリティ認証情報] タブを選択します。
[アクセスキー] セクションで [アクセスキーを作成] をクリックします。
[ユースケース] として [サードパーティサービス] を選択します。
[次へ] をクリックします。
省略可: 説明タグを追加します。
[アクセスキーを作成] をクリックします。
[CSV ファイルをダウンロード] をクリックし、[アクセスキー] と [シークレットアクセスキー] を保存して、今後の参照に備えます。
[完了] をクリックします。
[権限] タブを選択します。
[権限ポリシー] セクションの [権限を追加] をクリックします。
[権限を追加] を選択します。
[ポリシーを直接アタッチする] を選択します。
AmazonS3FullAccess ポリシーを検索します。
ポリシーを選択します。
[次へ] をクリックします。
[権限を追加] をクリックします。

S3 アップロードの IAM ポリシーとロールを構成する

AWS コンソールで、[IAM] > [ポリシー] に移動します。
[ポリシーを作成> [JSON] タブ] をクリックします。
次のポリシーをコピーして貼り付けます。

ポリシー JSON（別のバケット名を入力した場合は snipe-it-logs を置き換えます）:

{
  "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"
    }
  ]
}

[次へ] > [ポリシーを作成] をクリックします。
[IAM] > [ロール] > [ロールの作成] > [AWS サービス] > [Lambda] に移動します。
新しく作成したポリシーを関連付けます。
ロールに「SnipeITToS3Role」という名前を付けて、[ロールを作成] をクリックします。

Lambda 関数を作成する

AWS コンソールで、[Lambda] > [Functions] > [Create function] に移動します。
[Author from scratch] をクリックします。
次の構成情報を提供してください。

設定値

名前 snipeit_assets_to_s3

ランタイム Python 3.13

アーキテクチャ x86_64

実行ロール SnipeITToS3Role

設定	値
名前	`snipeit_assets_to_s3`
ランタイム	Python 3.13
アーキテクチャ	x86_64
実行ロール	`SnipeITToS3Role`

関数を作成したら、[コード] タブを開き、スタブを削除して次のコード（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())

[構成] > [環境変数] に移動します。
[編集>新しい環境変数を追加] をクリックします。
次の表に示す環境変数を入力します。例の値を実際の値に置き換えてください。

環境変数

キー値の例

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
関数が作成されたら、そのページにとどまるか、[Lambda] > [関数] > [your-function] を開きます。
[CONFIGURATION] タブを選択します。
[全般設定] パネルで、[編集] をクリックします。
[Timeout] を [5 minutes (300 seconds)] に変更し、[Save] をクリックします。

キー	値の例
`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`

EventBridge スケジュールを作成する

[Amazon EventBridge] > [Scheduler] > [スケジュールの作成] に移動します。
次の構成の詳細を入力します。
- 定期的なスケジュール: レート（1 hour）。
- ターゲット: Lambda 関数 snipeit_assets_to_s3。
- 名前: snipeit_assets_to_s3-1h
[スケジュールを作成] をクリックします。

（省略可）Google SecOps の読み取り専用 IAM ユーザーと鍵を作成する

AWS コンソール > IAM > ユーザーに移動します。
[ユーザーを追加] をクリックします。
次の構成の詳細を入力します。
- ユーザー: 「secops-reader」と入力します。
- アクセスの種類: [アクセスキー - プログラムによるアクセス] を選択します。
[ユーザーを作成] をクリックします。
最小限の読み取りポリシー（カスタム）を関連付ける: [ユーザー] > [secops-reader] > [権限] > [権限を追加] > [ポリシーを直接関連付ける] > [ポリシーを作成]。

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"
    }
  ]
}

名前 = secops-reader-policy。
[ポリシーを作成> 検索/選択> 次へ> 権限を追加] をクリックします。
secops-reader のアクセスキーを作成します。[セキュリティ認証情報] > [アクセスキー] に移動します。
[アクセスキーを作成] をクリックします。
.CSV をダウンロードします。（これらの値はフィードに貼り付けます）。

Snipe-IT のログを取り込むように Google SecOps でフィードを構成する

[SIEM 設定] > [フィード] に移動します。
[+ 新しいフィードを追加] をクリックします。
[フィード名] フィールドに、フィードの名前を入力します（例: Snipe-IT logs）。
[ソースタイプ] として [Amazon S3 V2] を選択します。
[ログタイプ] として [Snipe-IT] を選択します。
[次へ] をクリックします。
次の入力パラメータの値を指定します。
- S3 URI: s3://snipe-it-logs/snipeit/assets/
- Source deletion options: 必要に応じて削除オプションを選択します。
- ファイルの最大経過日数: 指定した日数以内に変更されたファイルを含めます。デフォルトは 180 日です。
- アクセスキー ID: S3 バケットにアクセスできるユーザーアクセスキー。
- シークレットアクセスキー: S3 バケットにアクセスできるユーザーのシークレットキー。
- アセットの名前空間: アセットの名前空間。
- Ingestion labels: このフィードのイベントに適用されるラベル。
[次へ] をクリックします。
[Finalize] 画面で新しいフィードの設定を確認し、[送信] をクリックします。

さらにサポートが必要な場合 コミュニティメンバーや Google SecOps のプロフェッショナルから回答を得ることができます。