通知 & 🔔 アラートについて

DefectDojoは、さまざまな方法で最新情報を提供します。通知は、今後予定されているエンゲージメント、ユーザーメンション、SLAの期限切れ、その他ソフトウェア内のイベントに対して送信されます。

この記事では、システム全体レベルおよび個人レベルの両方における通知の概要を説明します。

通知の種類#

DefectDojoは、通知を2つの異なる方法で処理します::

• システム全体通知(System-Wide Notifications)はすべてのユーザーに送信されます。
• 個人通知(Personal Notifications)は個々のユーザーによって設定され、システム全体通知に加えて受信されます。

いずれの場合も、ロールベースアクセス制御 のルールが適用されるため、ユーザーはアクセス権のない製品や製品タイプ(またはそれらに関連するオブジェクト)についてのアクティビティ通知を受け取りません。

通知の配信方法#

DefectDojoの通知には4つの配信方法があります。

• DefectDojoは、DefectDojoインターフェース内に一覧として保存される 🔔 アラート を共有できます
• DefectDojoは、メール アドレスに通知を送信できます
• DefectDojoは、共有チャンネルまたは個人チャンネルのいずれかで Slack に通知を送信できます
• DefectDojoは、共有チャンネルで Microsoft Teams にも通知を送信できます

通知は複数の送信先に同時に送信できます。

SlackおよびTeamsの通知を受信するには、有効なインテグレーションが必要です。このインテグレーションの設定方法の詳細については、ガイド を参照してください。

アプリ内アラート#

DefectDojoのアラートシステムは、すべての製品またはシステムのアクティビティについて最新情報を提供します。

アラート一覧#

アラート一覧は、DefectDojoの右上に常に表示されており、コンパクトな通知の一覧が含まれています。各アラートをクリックすると、DefectDojo内の該当ページに直接移動します。

右上にある 🔔▼ アイコン をクリックすると、アラート一覧を開くことができます。

すべての通知を詳細とともに確認するには、See All Alerts > ボタンをクリックすると、アラートページ が開きます。

アラート一覧から Clear All Alerts > をクリックすることもできます。

アラートページ#

アラートページには、DefectDojo内のすべてのアラートが詳細情報とともに保存されています。このページでは、DefectDojo内の各アラートの説明を確認でき、不要になったものはアラートキューから削除できます。

アラートページから1つ以上のアラートを削除するには、その横にある空のチェックボックスにチェックを入れ、ページの右下にある Remove selected ボタンをクリックします。

アラートに関する注意事項#

• アラートを読んだり、アラートページを開いたりしても、ベルアイコンの横にあるカウントからアラートが削除されることはありません。これは、過去のアラートにリマインダーや個人のアクティビティログとして簡単にアクセスできるようにするためです。
• アラートメニューの Clear All Alerts > 機能を使用すると、アラートページ も完全にクリアされるため、この機能は注意して使用してください。
• アラートを削除しても、自分のアラート一覧のみに影響し、他のユーザーのアラートには影響しません。
• アラートを削除しても、DefectDojoからインポート履歴やアクティビティログが削除されることはありません。

レビューリクエスト通知を絞り込む(Pro)#

すべての対象レビュアーからレビューが要求されると、そのアセットに対して対象となる全員に通知が送信されます。これは、あなたの管理対象の一部だけを担当しているレビュアーにとっては、大量のメールになります。

DefectDojo Pro のUIでは、自分自身のレビューリクエスト通知を絞り込むことができます。通知設定ページの Review Requests の下で:

• Review Request Scope — All(デフォルト)は、閲覧可能なすべての事項について通知します。Selected は、選択したアセットおよびアセットタイプに絞り込みます。
• Review Request Assets / Review Request Asset Types — 通知を受けたい管理対象の範囲です。選択したアセットのいずれか、または選択したアセットタイプのいずれかに該当するリクエストが対象になります。

明確にしておくべき点が2つあります。

• Selected を選択して何も選ばなかった場合、それは「すべて」ではなく なし を意味します。
• 絞り込みは通知を抑制するものであり、リクエスト自体を抑制するものではありません。あなたは引き続きレビュアーとしてリクエストされた状態であり、そのリクエストは My Work キューの Awaiting My Review に表示され続けます — 単に通知が届かなくなるだけです。これは意図的な設計です。キューが正式な記録であり、通知はあくまでリマインダーです。

この絞り込みは、以下で説明するシステムレベルのオーバーライドよりも優先されます。そのため、自分自身を対象外に設定したレビュアーは、review_requested が個人設定より優先されるよう構成されている場合でも通知を受け取りません。

この絞り込みは、notifications エンドポイントを介してAPI経由で設定することもできます。これは、多数のレビュアーを一度に設定する場合の実用的な方法です。

作業割り当て通知(Pro)#

検出事項があなたに割り当てられると、Work Assigned 通知が件数を知らせ、My Work キューへのリンクを提供します。

これは検出事項ごとではなく、人ごとに集計されます。100件の検出事項を割り当てても、送信されるメッセージは100件ではなく1件です。レビューリクエストと同様に、割り当ては通知が届くかどうかに関わらず、キューに表示されます。

オープンソース版に関する考慮事項#

特定のオーバーライド#

システム通知設定(scope: system)は、スーパー管理者への通知送信を規定します。ユーザー通知設定(scope: personal)は、特定のユーザーへの通知送信を規定します。

ただし、ユーザーが(ノイズを減らすために)通知を無効にすることを選択しても、システム設定によってこの動作がオーバーライドされる特定のユースケースがあります。これらのオーバーライドは、デフォルトでは user_mentioned と review_requested にのみ適用されます。

この設定の範囲はカスタマイズ可能です(環境変数 DD_NOTIFICATIONS_SYSTEM_LEVEL_TRUMP を参照してください)。

この動作の詳細については、関連するプルリクエスト #9699 を参照してください。

Webhook(実験的機能)#

DefectDojoは、他の通知と同じイベントに従うWebhookもサポートしています(同じ状況で通知を受け取ることができます)。設定の詳細については、関連ページ をご覧ください。