mcpField
A
audit-log-generator

audit-log-generator

github.com/dengineproblemセキュリティ64 回インストール
リポジトリ

audit-log-generator について

セキュリティとコンプライアンスの監査ログ設計を支援するスキルです。システム活動の記録・確認に取り組むチーム向けに、イベント形式、規制対応、完全性管理、保持、監視を扱います。

主な機能

  1. 01JSONとCEFのログ形式
  2. 02認証・データアクセス・管理イベント
  3. 03GDPR、SOX、HIPAAのコンテキスト
  4. 04完全性とアクセス制御の指針
  5. 05保持、アラート、レポート

活用シーン

  1. 01監査イベントの項目を統一
  2. 02規制対象データへのアクセス記録
  3. 03改ざん防止ログ制御の計画
  4. 04保持・アラートポリシーの策定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dengineproblem/agents-monorepo --skill audit-log-generator

インストール後、Claude Code で/audit-log-generatorを入力して読み込まれたか確認します。

詳細

監査ログ生成エキスパート

セキュリティ、コンプライアンス、モニタリングのための監査ログの設計と実装に関するエキスパートです。

ログの主な要素

各レコードには次の情報を含める必要があります。

  • Timestamp：ミリ秒精度の UTC
  • Event ID：一意の識別子
  • Actor：操作を実行した人
  • Action：実行された操作（CREATE、READ、UPDATE、DELETE）
  • Resource：操作の対象
  • Source：IP アドレス、アプリケーション
  • Result：成功／失敗
  • Risk Level：重要度の分類

JSON 形式（推奨）

{
  "timestamp": "2024-01-15T14:30:45.123Z",
  "event_id": "evt_7f4a9b2c8e1d",
  "version": "1.0",
  "actor": {
    "user_id": "[email protected]",
    "session_id": "sess_abc123",
    "role": "admin"
  },
  "action": "DELETE",
  "resource": {
    "type": "database_record",
    "id": "customer_12345",
    "table": "customers",
    "classification": "PII"
  },
  "context": {
    "source_ip": "192.168.1.100",
    "user_agent": "Mozilla/5.0...",
    "application": "customer_portal",
    "api_endpoint": "/api/v1/customers/12345"
  },
  "result": {
    "status": "SUCCESS",
    "response_code": 200,
    "affected_records": 1
  },
  "metadata": {
    "risk_level": "HIGH",
    "compliance_tags": ["GDPR", "SOX"],
    "retention_years": 7,
    "checksum": "sha256:a1b2c3d4..."
  }
}

CEF（Common Event Format）

CEF:0|CompanyName|CustomerPortal|2.1|1001|User Data Deletion|8|
rt=Jan 15 2024 14:30:45 UTC src=192.168.1.100
[email protected] act=DELETE dst=customer_db
cs1Label=Table cs1=customers cs2Label=RecordID cs2=12345

イベントの分類

認証イベント
  • ログイン試行（成功／失敗）
  • パスワードの変更
  • MFA の有効化
  • アカウントのロック
  • 権限の昇格
データアクセスイベント
{
  "action": "READ",
  "data_classification": "SENSITIVE",
  "access_method": "API",
  "record_count": 150,
  "query_hash": "sha256:..."
}
管理イベント
  • 設定の変更
  • アクセス権の付与／取り消し
  • 権限の変更
  • バックアップ操作
セキュリティイベント
  • 認証失敗
  • 異常なアクセスパターン
  • セキュリティポリシー違反

コンプライアンス要件

GDPR
{
  "gdpr_context": {
    "lawful_basis": "legitimate_interest",
    "data_subject_id": "ds_789",
    "processing_purpose": "customer_service",
    "retention_justified": true,
    "cross_border_transfer": false
  }
}
SOX
  • 財務データへのアクセスの追跡
  • 職務の分離
  • 変更の記録
  • 経営陣によるアクセスのモニタリング
HIPAA
{
  "hipaa_context": {
    "phi_involved": true,
    "minimum_necessary": true,
    "covered_entity": "hospital_system",
    "patient_authorization": "auth_456"
  }
}

変更の追跡

{
  "change_tracking": {
    "before_state": {
      "customer_tier": "silver",
      "credit_limit": 5000
    },
    "after_state": {
      "customer_tier": "gold",
      "credit_limit": 10000
    },
    "change_reason": "promotion_campaign",
    "approver": "[email protected]"
  }
}

バッチ処理

{
  "batch_context": {
    "batch_id": "batch_2024_01_15_001",
    "total_records": 10000,
    "successful_records": 9987,
    "failed_records": 13,
    "processing_duration_ms": 45678,
    "error_summary": ["validation_failed: 13"]
  }
}

セキュリティ制御

暗号化
  • 保存データには AES-256 を使用
  • 転送データには TLS 1.3 を使用
  • ログの種類ごとに個別の鍵を使用
  • 鍵を定期的にローテーション
アクセス制御
{
  "log_access_policy": {
    "read_access": ["audit_team", "compliance_officer"],
    "search_access": ["security_analyst"],
    "export_access": ["legal_team"],
    "retention_management": ["data_governance"]
  }
}
改ざんの検出
  • 完全性の確保に Merkle ツリーを使用
  • PKI によるデジタル署名
  • 完全性を定期的に検証
  • 改変不可能なタイムスタンプ

Python による実装

import json
import hashlib
from datetime import datetime
from typing import Dict, Any, Optional
from enum import Enum

class AuditAction(Enum):
    CREATE = "CREATE"
    READ = "READ"
    UPDATE = "UPDATE"
    DELETE = "DELETE"
    LOGIN = "LOGIN"
    LOGOUT = "LOGOUT"

class RiskLevel(Enum):
    LOW = "LOW"
    MEDIUM = "MEDIUM"
    HIGH = "HIGH"
    CRITICAL = "CRITICAL"

class AuditLogger:
    def __init__(self, service_name: str):
        self.service_name = service_name

    def log(
        self,
        action: AuditAction,
        actor_id: str,
        resource_type: str,
        resource_id: str,
        result: str = "SUCCESS",
        risk_level: RiskLevel = RiskLevel.LOW,
        context: Optional[Dict[str, Any]] = None,
        before_state: Optional[Dict] = None,
        after_state: Optional[Dict] = None
    ) -> Dict[str, Any]:
        event_id = self._generate_event_id()
        timestamp = datetime.utcnow().isoformat() + "Z"

        log_entry = {
            "timestamp": timestamp,
            "event_id": event_id,
            "service": self.service_name,
            "actor": {"user_id": actor_id},
            "action": action.value,
            "resource": {
                "type": resource_type,
                "id": resource_id
            },
            "result": {"status": result},
            "metadata": {
                "risk_level": risk_level.value
            }
        }

        if context:
            log_entry["context"] = context

        if before_state or after_state:
            log_entry["change_tracking"] = {
                "before_state": before_state,
                "after_state": after_state
            }

        log_entry["metadata"]["checksum"] = self._calculate_checksum(log_entry)

        self._persist_log(log_entry)
        return log_entry

    def _generate_event_id(self) -> str:
        import uuid
        return f"evt_{uuid.uuid4().hex[:12]}"

    def _calculate_checksum(self, entry: Dict) -> str:
        content = json.dumps(entry, sort_keys=True)
        return f"sha256:{hashlib.sha256(content.encode()).hexdigest()[:16]}"

    def _persist_log(self, entry: Dict):
        # Отправка в систему логирования
        print(json.dumps(entry, indent=2))

保持ポリシー

retention_policies = {
    "authentication": {"years": 3, "hot_storage_days": 90},
    "data_access": {"years": 7, "hot_storage_days": 365},
    "administrative": {"years": 10, "hot_storage_days": 180},
    "security_incidents": {"years": 10, "hot_storage_days": 1095}
}

モニタリングとアラート

リアルタイムアラート
  • 認証失敗の急増
  • 特権アクセスのパターン
  • データ流出の兆候
  • コンプライアンスポリシー違反
定期レポート
  • 日次のアクセス概要
  • 週次のコンプライアンスダッシュボード
  • 月次の傾向分析
  • 四半期ごとの監査準備状況レポート

ベストプラクティス

  1. 不変性 — ログは追記のみ
  2. 暗号による保護 — 署名とチェックサム
  3. 分離保管 — 運用システムから隔離
  4. 定期的な検証 — 完全性の確認
  5. ドキュメント化 — データのサプライチェーン

コメント

Markdown 対応