監査ログ (Pro)

監査ログは、DefectDojo内で実行されたアクションの時系列記録を提供します。どのユーザーがいつどのアクションを実行したかを記録することで、説明責任とコンプライアンスを確保します。

監査ログは以下の場面で役立ちます。

• セキュリティ調査: 誰が機密性の高い操作を実行したかを特定します。
• コンプライアンス: SOC 2、ISO 27001、または社内ガバナンス要件などの標準に対応する監査可能な履歴を提示します。
• トラブルシューティング: 設定やオブジェクトが変更された時期を特定します。
• 説明責任: プラットフォーム全体における管理者およびユーザーの活動を追跡します。

つまり、監査ログは重要なイベントを一元的に記録することで、管理者が個々のオブジェクトの履歴を超えてインスタンスの活動履歴を把握できるようにします。

Accessing Audit Logs#

監査ログには、サイドバーの「Configurations」サブメニューからアクセスできます。

Permissions#

監査ログへのアクセスは、ユーザーのグローバルロールによって決まります。

API Importer、Reader、Writerのグローバルロールは監査ログへのアクセスを許可されませんが、MaintainerとOwnerのロールは許可されます。スーパーユーザーは、グローバルロールに関係なく監査ログにアクセスできます。

権限とグローバルロールの詳細については、こちらを参照してください。

Audit Logs Contents#

監査ログは、以下を含む(ただしこれらに限定されない)さまざまなアクションを追跡します。

• オブジェクトとのやり取り(オブジェクトの作成、更新、削除など)。
• 検出事項の優先度およびリスクスコアの更新。
• ユーザープロフィールの作成および編集。
• EPSSパーセンタイルの更新。

監査ログに記録される変更およびアクションの全リストは、こちらで確認できます。

Audit Logs Table#

監査ログには、トレーサビリティを向上させるためのさまざまなデータを含む複数の列があります。

• Timestamp: 変更が発生した時刻。
• User: アクションを実行したユーザー。
• Action: 実行されたアクション(作成、更新、削除など)。
• Model: 変更された対象(Asset、User、Finding、Location、Firewall、URLなど)。
• Object ID: 変更されたオブジェクトのDefectDojo固有のID。
• Object Name: 影響を受けたオブジェクトの名前。
• Changes: そのアクションによって変更された特定のフィールド。変更前と変更後の値を含みます。
• Data: アクションが実行された時点でのレコードの正確なスナップショット。変更されたフィールドだけでなく、すべてのフィールドを含みます。
• Context: 変更がどのように発生したか、誰が行ったか、アプリのどこから発生したか、および(自動化されたジョブの場合)どのジョブが変更を実行したかを示すラベルなど、変更に関する周辺情報。
• URL: 特定の操作を実行するために使用されたURL。これらのパスは、DefectDojoのVue UIまたはREST APIを参照する場合があります。バックエンド処理の場合、URLフィールドは入力されません。
• IP Address: 変更を行ったデバイスのネットワークアドレス。バックエンド処理の場合は入力されません。

Audit Logs Timeline#

デフォルトでは、監査ログには過去31日間のエントリが表示されます。それより古いエントリも引き続き利用可能で、Timestampフィルターを調整することで表示できます。

Filtering Audit Logs#

監査ログテーブルには、表示される結果を絞り込むためのフィルターが用意されています。たとえば、Assetsに関連するアクションのみを表示したい場合は、テーブル内でAssetsをフィルタリングできます。

監査ログ内の列は、列の内容に応じて、アルファベット順、昇順/降順、または時系列順に並べ替えることもできます。列は、任意の並び順にするために左右にドラッグすることもできます。

Object History#

オブジェクト履歴は、個々のDefectDojoオブジェクト(Organization、Asset、Engagement、Test、Findings、Endpoints、Risk Acceptancesなど)に加えられた変更の時系列記録を提供します。各エントリには、タイムスタンプ、ユーザー、実行されたアクション、および関連する変更などの詳細が含まれます。

インスタンス全体のイベントを記録する監査ログとは異なり、オブジェクト履歴は単一のオブジェクトの活動のみに限定されるため、無関係なシステムイベントをフィルタリングすることなく、オブジェクトの履歴を把握しやすくなります。

オブジェクト履歴は以下の場合に役立ちます。

• オブジェクトの経時的な変化を確認する。
• 変更がいつ行われたかを特定する。
• どのユーザーが変更を行ったかを特定する。
• 予期しない変更のトラブルシューティングを行う。

Accessing Object History#

オブジェクト履歴には、各オブジェクトのビューの右上にある歯車メニューからアクセスできます。当該オブジェクトへのアクセス権を持つユーザーのみが、そのオブジェクトのオブジェクト履歴を表示できます。

Audit Logs and Object History#

監査ログとオブジェクト履歴の機能は重複していますが、それぞれ異なる範囲で動作します。オブジェクト履歴は個々のオブジェクトに加えられた変更に焦点を当てるのに対し、監査ログはDefectDojoインスタンス全体にわたる重要なイベントをシステム全体で記録し、活動をより広い視点から俯瞰できるようにします。

Endpoints#

Object History Endpoint (Pro Only)#

DefectDojo Proのユーザーは、これらのオブジェクトについて同様のデータを表示するための/history APIパスにアクセスできます。例: /api/v2/findings/{id}/history/。

Audit Log Endpoint (Pro Only)#

DefectDojo Proのユーザーは、インスタンス全体に対して専用の/audit_logエンドポイントにもアクセスできます。このログには、スーパーユーザー権限を持つユーザーまたはAPIトークンのみがアクセスできます。

このAPIは31日分の監査ログを返します。

• デフォルトまたは空のパラメータを送信すると、直近31日分の監査ログが返されます。

• パラメータwindow_monthは、MM-YYYY形式で月と年を指定し、その月の監査ログを提供します。

• window_startパラメータを設定すると、月全体を返す代わりに、これらのログをより短い期間に限定できます。

詳細については、インスタンス内にあるAPIドキュメントを参照してください: your-instance.cloud.defectdojo.com/api/v2/oa3/swagger-ui/