Compliance AIops

Compliance AIops

免責事項：コミュニティが管理するオープンソースプロジェクトです。いかなるフレームワーク団体やGRCベンダーとも提携、推奨、後援関係にありません。 HIPAA、PCI-DSS、SOC 2、GDPR、OSCALは説明のために参照しています。これらのフレームワークおよび商標はそれぞれの所有者に帰属します。MITライセンスです。

AIエージェントのインフラ運用向けに統制されたコンプライアンス証跡ツールです。統制されたAIopsエージェントがすでに書き込んでいる監査証跡、つまり共通のaudit_logスキーマを持つローカルの~/.<tool>-aiops/audit.db SQLite監査証跡を読み取り、フレームワークに対応付けられ、ハッシュチェーンで封印されたコンプライアンス証跡に変換します。インフラをスキャンすることも、GRCプラットフォームに置き換わることもありません。すでに生成されている監査証跡を、監査人向けの改ざん検知可能な証跡バンドルに変換します。

AIops-toolsシリーズの他のツールとは異なり、プラットフォームのラッパーではありません。外部APIも、ネットワーク接続も、プラットフォームの認証情報も必要ありません。入力はディスク上の監査データベースのみで、読み取り専用でアクセスします。そのため、このシリーズで最も簡単にセルフテストできるツールでもあります。完全オフラインで、決定論的に動作します。

認証ではなく、証跡です。 完全オフラインで動作し、ソースのaudit.dbファイルが引き続き記録システムとなります。OSCALエクスポートは、文書化されたv0.2のロードマップ項目です（v0.1では、将来のOSCAL Assessment-Resultsアダプターへの対応を容易にする形式のJSON、Markdown、CSVを出力します）。

主な機能

• 証跡の強さを正直に示すフレームワーク対応付け — 監査イベントをHIPAA §164.312／PCI-DSS v4.0／SOC 2 TSC／GDPRの管理策に対応付けます。監査証跡は運用上の有効性を強く裏付けますが、管理策の設計／構成を裏付けるのは部分的です。各管理策にはstrongまたはpartialのラベルが付きます。gap_analysisでは、注意事項と是正のヒントを添えて、管理策ごとにその旨を示します。
• ハッシュチェーンで封印された証跡バンドル — 順序付けられたレコードに対するSHA-256（hash = SHA-256(prev_hash ‖ canonical_json(record))、genesis prev = 64個のゼロ）を使用します。同じ（フレームワーク、期間、ソース）に対するchainHeadは再現可能です。verify_bundleは改ざんを検出し、verify_source_chainはソース証跡の行IDの欠落／削除を検出します。オプションのHMAC署名により、保存済みの署名キーでバンドルを封印できます。
• ネットワーク接続不要、読み取り専用 — 認証情報も、外部への呼び出しもなく、ソース証跡を変更しません。書き込まれるのはバンドルのみで、保存先は~/.compliance-aiops/bundles/です。
• 決定論的で、テストにより完全性を検証 — 完全性に関する主張自体がテストで検証されています。合成監査DBは実際のgovernance-harnessのAuditEngineを通じて構築され、再現可能なゴールデンchainHeadが検証され、改ざんテストで検出を確認します。稼働中のインフラは不要です。

このツールが判断すること、しないこと

監査証跡を読み取り、証跡バンドルを書き込み、すべての操作を記録します。バンドルの生成や署名が許可されるかどうかは判断しません。それはエージェントの判断、または実行アカウントのファイルシステム権限によります。ソースのaudit.dbファイルは、いずれの場合も厳密に読み取り専用で開かれ、書き込まれるのは~/.compliance-aiops/bundles/内のバンドルのみです。

そのため、読み取り専用の切り替えも、ポリシーファイルも、設定する承認ゲートもありません。このツールが保証するのは、何も記録されずに実行されることがないという点です。MCP経由でもCLI経由でも、すべての呼び出しが~/.compliance-aiops/audit.dbに監査行として記録されます。

各ツールはrisk_levelを宣言します。これはテストによって[READ]／[WRITE]のドキュメントタグと一致するように保たれ、説明用の区分として監査行に記録されます。これにより、レビュアーは各行の内容をひと目で確認できます。これはラベルであり、ゲートではありません。

ツール（16個のMCPツール）

読み取り／分析（13）

ツール	目的
list_audit_sources	検出された関連監査 DB（パス、ツール、読み取り可能か、行数）
query_audit_events	ツール／スキル／ステータス／リスク／承認済みか／セレクター／開始日時／終了日時で絞り込む、ツール横断イベントクエリ
activity_timeline	時間または日単位で区切ったイベント数
list_frameworks	対応フレームワークと管理策の数
coverage_summary	1 つのフレームワークにおける管理策ごとの対応状況（対応済み／弱い／未対応）
control_evidence	1 つの管理策の証拠行＋母集団＋再現可能なクエリ
gap_analysis	証拠がない／弱い管理策＋誠実な注意書き＋是正措置
approval_report	高リスクの書き込み操作＋承認者＋理由（CC8.1／PCI 7-8／HIPAA §312(a) の成果物）
exceptions_report	拒否／エラー／予算超過の操作 — 適用状況＋異常の証拠
verify_source_chain	1 つのソースのチェーンヘッド＋行 ID の欠落検出
verify_bundle	封印済みバンドルを検証：チェーン＋封印ヘッド＋任意の署名
list_bundles	~/.compliance-aiops/bundles/ 内のバンドル
oscal_assessment_results	封印済みバンドルを、制約事項を明記した NIST OSCAL 1.2.3 の評価結果ドキュメントとしてインラインで出力
bundle_schedule_hint	定期的な封印処理に使える、貼り付け可能な cron 行＋非対話型コマンド（書き込みなし）

書き込み／成果物（3 — 外部への変更なし）

ツール	リスク	目的
generate_evidence_bundle	低	1 回の呼び出しで、対応状況＋承認履歴＋例外＋封印済みレコードをまとめ、バンドル .json を生成
export_bundle	低	バンドルを markdown／csv／json／oscal に変換
sign_bundle	中	保存済みの署名キーを使用して封印に HMAC を付与

CLI で利用できるのは便利な機能の一部です。19 個のツールをすべて MCP 経由で利用できます。

フレームワークと管理策

フレームワーク	管理策の例（強度）
HIPAA（§164.312）	164.312(b) 監査制御（強い）、164.312(a)(1) アクセス制御（強い）、164.312(c)(1) 完全性（強い）
PCI-DSS v4.0	10.2 監査ログの内容（強い）、10.3 監査ログの保護（強い）、7-8 最小権限／認証（部分的）
SOC 2 TSC	CC6.1 論理アクセス（強い）、CC7.2 監視（強い）、CC8.1 変更管理（強い）
GDPR	第30条 処理記録（部分的）、第32条 処理のセキュリティ（強い）
ISO/IEC 27001:2022（附属書 A）	A.5.15 アクセス制御（強い）、A.5.16 ID 管理（強い）、A.5.18 アクセス権（部分的）、A.8.2 特権アクセス（部分的）、A.8.15 ログ記録（強い）、A.8.16 監視（強い）、A.8.32 変更管理（強い）
等保2.0 (DJCP L3)（GB/T 22239-2019 三级）	8.1.5.4 安全审计（強い）、8.1.4.2 访问控制（部分的）、8.1.5 安全管理中心/集中审计（強い）

インストール

uv tool install compliance-aiops      # or: pipx install compliance-aiops

クイックスタート

Claude Code プラグインとして

1 回のインストールで、エージェントにスキルと MCP サーバーの両方を提供します。

/plugin marketplace add AIops-tools/marketplace
/plugin install compliance-aiops@aiops-tools

MCP サーバーは uv で取得され、このプラグインが宣言するパッケージバージョンに固定されます。そのため、監査行を、それを書き込んだコードまで追跡できます。認証情報は引き続き compliance-aiops init で設定します — 以下を参照してください。

OpenClaw プラグインとして

同じバンドルが ClawHub で公開されており、1 回のインストールでスキルと MCP サーバーをまとめて導入できます。

openclaw plugins install clawhub:@zw008/compliance-aiops
openclaw skills info compliance-aiops          # expect: Visible to model: yes

その後、OpenClaw ゲートウェイを再起動してプラグインを読み込ませてください。MCP サーバーは uv で取得され、このリリースの厳密なバージョンに固定されるため、uvx が PATH 上にある必要があります。ない場合、スキルはインストールされますが、Visible to model: no と表示されます。認証情報は以下と同じ方法で設定します。

CLI またはスタンドアロンの MCP サーバーとして

compliance-aiops init                 # discover sibling ~/.*-aiops/audit.db, set org name, optional signing key
compliance-aiops doctor               # which sibling audit DBs are present/readable
compliance-aiops overview             # audit sources + per-framework covered/total
compliance-aiops report coverage soc2 # per-control SOC 2 coverage
compliance-aiops bundle generate soc2 # sealed evidence bundle → ~/.compliance-aiops/bundles/
compliance-aiops bundle verify <path> # re-verify the chain + seal (+ signature)

MCP サーバーとして実行します（stdio）：

export COMPLIANCE_AIOPS_MASTER_PASSWORD=...   # only needed to unlock a signing key
compliance-aiops mcp                          # or: compliance-aiops-mcp

そのパスワードの保存場所について：エクスポートした変数は、このシェルが起動するすべてのプロセスから読み取ることができ、シェルの履歴にも記録されます。共有ホストや長期間稼働するホストでは、対話型プロンプトを使用するか、そのパスワードが必要なコマンドの実行中だけシークレットマネージャーから注入することをお勧めします。

定期的な封印（スケジュール設定）

証拠バンドルは一定の周期（例：毎週）で封印すると最も有用です。各期間に改ざん検知可能なアンカーが作成されます。このツールにはデーモンは付属しません。代わりに、bundle schedule はすぐに貼り付けて使える cron の行と、非対話型で実行するための正確なコマンドを表示します。ファイルには何も書き込みません。

compliance-aiops bundle schedule soc2 --cron "0 2 * * 1" --period 7d --sign

cronLine が返されるので、たとえば crontab -e に貼り付けます。

0 2 * * 1 compliance-aiops bundle generate soc2 --period 7d --sign

• --period（bundle generate でも使用可能）は、相対期間を指定するための便利なオプションです。7d、24h、2w、last-7-days を指定すると、「現在」を終点とする開始日時と終了日時のペアに解決され、スケジュール実行のたびに直近の期間が封印されます。
• 保存済みの署名鍵を非対話型で解除できるよう、cron ジョブの環境変数として COMPLIANCE_AIOPS_MASTER_PASSWORD をエクスポートしてください。実際のパスワードを crontab ファイルに直接記述しないでください。保護された環境変数ファイルから参照してください。

整合性と正直な限界

• 改ざん検知が可能であり、改ざん防止ではありません。 ハッシュチェーンとオプションの署名により、監査人は改ざんを検知できますが、改ざんを防ぐことはできません。元の audit.db ファイルが引き続き正式な記録となります。独立したアンカーが必要な場合は、chainHead を別の場所に記録してください。
• 運用の有効性と設計上の有効性。 監査証跡は、管理策が実行されたこと（サンプル、承認、拒否）を強く示す一方、管理策が正しく設計・設定されていること（例：MFA の必須化、最小権限ロール）を示す証拠としては限定的です。各管理策には strong / partial のラベルが付与され、gap_analysis は過大な主張を避けながら留意点を明らかにします。

サポート対象の範囲と制限事項

• 認証ではなく証拠です。 監査人向けの証拠バンドルを生成しますが、証明書、意見書、認証を発行するものではありません。
• 対象範囲： 上記の 6 つのフレームワークと、~/.*-aiops/audit.db から検出されるガバナンス対象の AIops ツールが記録した audit_log の証跡です。
• 対象外： インフラストラクチャのスキャン、プラットフォームへの接続、GRC プラットフォームの置き換えは行いません。プラットフォームの運用には、他の AIops-tools を使用してください。
• OSCAL エクスポートは v0.2 です。 v0.1 では JSON、Markdown、CSV を出力します。
• v1.0 より前にインターフェースが変更される場合があります。
• 検証： 整合性に関する主張は、決定的なオフラインテストで検証されています。再現可能な実行方法については、docs/VERIFICATION.md を参照してください。

必要な機能がありませんか？

ほかのフレームワーク、管理策のマッピング、エクスポート形式（OSCAL、CSV の形式）、またはここに記載されていない検証機能をご希望ですか？issue または PR を作成してください。コントリビューションを歓迎します。