監査機能の改善がリリースされました

What's New

監査ログは常に、誰がアクションを実行し、何に対して実行されたかを記録してきました。このリリースは、その記録をページを離れることなく読みやすく、検索可能にすることを目的としています。

特定のモデレーターに何が起きたかを知りたかった場合、まずその ID を探す必要があり、もしそのモデレーターがすでに削除されていると、ID を照合できる情報が残っていませんでした。イベントは「何かが削除された」「誰が」「いつ」などを示していましたが、名前が欠落していることがありました。

現在、イベント発生時に名前が ID と共に記録されるようになったため、削除後も残り、検索できるようになりました。

The Affected Column

テーブルに新しい Affected 列が追加され、イベントが対象とした人物またはオブジェクトの名前が表示されます。人物の場合は jsmith (jsmith@example.com) のように表示されます。ウィジェットのカスタマイズやモデレーショングループの場合は、付けた名前が表示されます。メディアファイルの場合は、アップロードしたファイル名が表示されます。

テーブルの上部には Who or what was changed という検索ボックスがあり、名前、メールアドレス、または ID を入力すると、その人物またはオブジェクトに影響したイベントを検索できます。どの情報を持っているかを事前に把握する必要はなく、内部 ID を先に調べる必要もありません。

このリリース以前に記録されたイベントには名前が付いていませんが、常にあった ID は残っているため、同じ検索ボックスで ID による検索が可能です。

Date Range

フィルタ行に Date Range ドロップダウンが追加され、Last 30 Days、Last 90 Days、Last Year、All Time、そして Custom range が選択できます。Custom range を選ぶと From と To の日付ピッカーが表示されます。

日付範囲は検索を絞り込む最も簡単な方法であり、他のフィルタと組み合わせることで、目的の情報を最速で見つけることができます。

Managed Accounts

アカウントが他のテナントを管理している場合、Include sub-tenants チェックボックスがあります。これをオンにすると、アカウントと管理下のすべてのテナントを一括で検索し、Tenant 列で各イベントがどのアカウントから来たかが表示されます。

これまで各テナントのログは個別にしか閲覧できなかったため、"今週誰かが私たちのプロパティに触れたか" を確認するには、テナントを順に切り替える必要がありました。

Updates Now Record What Changed

チームメンバーの編集は、結果として設定された権限のセットを記録していました。これにより現在の権限は分かりますが、以前の権限は分からず、"誰がこのユーザーの請求アクセスを削除したか、いつか" といった質問に答えられませんでした。

更新イベントには、実際に変更されたフィールドのみを含む changes マップが追加され、各フィールドの以前の値と新しい値が記録されます。変更のないフィールドは省略されるため、権限の変更は多数のブール値の壁ではなく、1 行で表現されます。

Descriptions, and the Device Behind a Change

破壊的なイベントには、例えば「アカウントからユーザーを削除しました」のようなシンプルな文で何が起きたかが記載されるようになりました。ページビューには説明があり、削除にはなかったため、以前は逆の状態でした。

何かを変更するイベントは、変更を行ったブラウザも記録します。セッションはハッシュとして記録されるため、ログに再生可能な情報を保存せずに、同一人物のアクションを相関させることができます。

Other Improvements

• ページネーションとフィルタの組み合わせに関するいくつかの修正。
• ログインイベントで Who 列が空白になっていました。ユーザー名はレコードに常に含まれていましたが、ページがそれを読み取っていませんでした。
• アクション列がログインイベントを N/A と表示していました。これは、アクション名のリストに Login が含まれていなかったためです。
• 監査ログページで SSO ユーザーの名前が表示されず、代わりに "Missing User" と表示されていました。現在は正しく解決されます。
• 長い履歴を持つアカウントでページの表示が大幅に高速化されました。

For the API

/api/v1/audit-logs エンドポイントに一致するフィルタが追加されました：サブストリング検索用の username、ip、crudType、resourceName、targetId、target、そして includeManagedTenants。レスポンスには targetId、targetLabel、ua が含まれるようになりました。

このエンドポイントをすでに使用している場合、注目すべき2つの変更があります。before は単独で機能するようになり、以前は after と併せて渡さない限り無視されていました。また、limit はデフォルト5k、上限10kに制限されました。以前は上限がありませんでした。

Documentation

AuditLogs API ガイド では新しいクエリパラメータを説明し、AuditLog 構造リファレンス では新しいフィールドをカバーしています。

まだ監査ログを使用したことがない場合、the original release post では、ログの所在、閲覧可能なユーザー、エントリの保持期間について説明しています。これらはすべて変更されていません。

In Conclusion

FastComments を継続的に改善できることを嬉しく思います。ログ内で何かを探して見つからない場合は、下にご意見をお寄せください。

よろしくお願いします！