監査ログ

組織内の状態を変更する操作を、追記専用で改ざんを検知できる履歴として記録。誰が、何を、いつ、どこから行ったかを確認できます。

監査ログでは、ロールの割り当て、エンジンの編集、APIキーの発行など、組織内で記録対象となる管理操作を、検索・絞り込みができるタイムラインで確認できます。記録対象の制限もご覧ください。ロールと権限と同様に、ご利用にはEnterpriseプランが必要です。

ログはデータベースレベルで追記専用になっています。アプリケーションからの接続では、監査ログの行を更新、削除、一括消去することはできません。一度書き込まれた記録は、そのまま残ります。

記録される情報 #

各イベントには、実行者、操作、対象、およびリクエスト受信時のHTTPコンテキストが記録されます。

フィールド備考
実行者操作を実行したユーザーまたはAPIキー
操作engine.createdやmember.role_changedなど、操作の種類を示す値
対象操作の対象となったエンティティ(エンジン、ロール、用語集の項目など)
メタデータ関連するエンティティのID。名前、メールアドレス、コンテンツの抜粋は一切含みません
リクエストコンテキストrequest_id、IPアドレス、ユーザーエージェント。HTTP経由の呼び出しを受信した際に記録されます
タイムスタンプUTC時刻と、欠落の検出に使う単調増加の連番

IDのみを記録する設計

メタデータ列に保存されるのは、人が読める値ではなくIDです。画面では読み取り時に現在の名前を結び付けて表示するため、エンジン名やユーザー名を変更しても履歴は書き換わりません。また、墨消しが必要なコンテンツを含まないため、監査ログの行がGDPRの消去権と抵触することも避けられます。

記録対象の操作 #

イベントは、ダッシュボードのフィルターに対応するカテゴリに分類されます。

カテゴリ現在記録できる操作
組織org.created, org.settings_updated, org.deleted
メンバーmember.invited, member.removed, member.role_changed
ロールrole.created, role.updated, role.deleted
エンジンengine.created, engine.updated, engine.deleted
APIキーapi_key.created, api_key.revoked
コンテンツglossary_item.*, instruction.*, brand_voice.*(単一項目の操作のみ)

ログへのアクセス #

監査ログは、設定の管理セクションに常に表示されます。利用条件を満たしていない場合は、タイムラインの代わりに「ご利用のプランでは監査ログを利用できません」と表示されます。ページでは、次の機能を利用できます。

  • 絞り込み可能な一覧 — 操作、実行者、期間で絞り込めます。期間には、過去7日間などのプリセット、または開始日と終了日による日付範囲を指定できます。未来の日付は選択できません。
  • 過去のイベントを読み込む — イベントは新しい順に表示されます。一覧の下部にある過去のイベントを読み込むをクリックすると、次のページを取得できます。
  • イベントの詳細 — 行をクリックすると、その場で展開され、すべてのメタデータ、リクエストID、IPアドレス、ユーザーエージェントを確認できます。
  • 表示内容の共有 — フィルターと開いているイベントがURLに反映されるため、どの表示状態でも共有できます。

閲覧できるユーザー #

ページにアクセスするには、次の2つの条件を満たす必要があります。

  1. 利用条件 — 組織で監査ログ機能が有効になっている必要があります(Enterpriseプラン)。
  2. 権限 — 閲覧者のロールにorg:view_audit_logsが含まれている必要があります。あらかじめ用意されているフルアクセスロールには、この権限が既定で含まれています。オーナーは常にこの権限を持ちます。

権限のないメンバーには、タイムラインの代わりに「アクセス権がありません」というページが表示されます。利用条件を満たしていない組織のメンバーには、有料プランへの案内が表示されます。

Enterpriseプランの有効期限が切れた場合

監査ログの利用には、ロールベースのアクセス制御と同じプラン階層が必要です。過去のイベントはデータベースに保持されますが、プランを再開するまでは、ページに「ご利用のプランでは監査ログを利用できません」と表示され、読み取り用エンドポイントは403を返します。

改ざんの検知 #

監査ログは単なる記録ではありません。記録後の改ざんを困難にする、実効性のある仕組みを備えています。

  • データベースレベルで追記専用。 テーブルを作成するマイグレーションでは、APIロールに対してREVOKE UPDATE, DELETE, TRUNCATEを実行します。今後どのようなコード経路が追加されても、バグ、新しいエンドポイント、さらにはSQLインジェクションによるものであっても、行の変更は実行前にPostgresによって拒否されます。
  • 単調増加の連番。 各行には、値が厳密に増加するseq列があります。監査担当者は連番を調べることで、削除を欠番として検出できます。

この仕組みは、SOC 2に準じた統制には十分です。ただし、本番データベースの認証情報を直接持つ攻撃者からは保護できません。所有者ロールの分離や、一度書き込むと変更できないWORMミラーなど、より強固な構成をご希望の場合はご相談ください。

保存期間 #

監査イベントは、既定では無期限に保存されます。Enterpriseでは、通常1年、3年、7年など、保存期間を個別に設定できます。コンプライアンス要件やセキュリティ質問票への対応で特定の保存ポリシーが必要な場合は、お問い合わせください。

対応していない範囲 #

初期バージョンでは、意図的に次の制限を設けています。

  • イベントの記録はベストエフォートで、同一トランザクション内では行われません。 トランザクション内での記録は、近い将来の開発計画に含まれています。監査イベントは、対象の操作と同じデータベーストランザクション内ではなく、操作の後に書き込まれます。まれに、操作が成功した後に監査イベントの挿入が失敗すると、対応するイベントが記録されないまま操作だけが実行されることがあります。
  • 一部の操作は、まだ記録に対応していません。 エンジンのメンバー変更、連携の接続・更新・切断、モデル設定の編集、課金サブスクリプションの変更、コンテンツの一括操作(CSVアップロード、createMany / updateMany / deleteMany)では、まだイベントが生成されません。操作の識別子は予約済みのため、記録に対応すると既存のフィルターカテゴリに表示されます。
  • 読み取り操作は監査対象外です。 監査ログ自体の閲覧、エンジンのリクエストログの閲覧、用語集のダウンロードでは、イベントは生成されません。状態を変更する操作のみが対象です。
  • エクスポートには、まだ対応していません。 監査データはダッシュボードで確認できます。CSVエクスポート、SIEM向けウェブフック、S3ミラーは開発計画に含まれています。必要な場合はお知らせください。
  • エンジン単位の表示はありません。 組織のすべての監査イベントが、1つのタイムラインに表示されます。対象を絞るには、操作や実行者で絞り込んでください。
  • リアルタイムの追尾表示はありません。 更新ボタンもWebSocketストリームもありません。新しいイベントを取得するには、ページを再読み込みしてください。

次のステップ #