ピアレビューと受け持ち (Pro)

ピアレビューを使うと、検出事項をクローズする前に誰かに確認してもらうよう依頼できます。DefectDojo Pro UI では、レビューを受け持つこともでき、複数の人が対象となっている場合でも、誰が引き受けたかを全員が確認できます。

Requesting a review

検出事項を開き、検出事項メニューからRequest Reviewを選択します。または、リスト内で複数の検出事項を選択し、一括編集ツールを使用します。

名前を指定したユーザーやグループにレビューを依頼することも、Allow Eligible Reviewersにチェックを入れて、そのアセットで対象となる全員に依頼することもできます。

レビューを依頼すると、検出事項はUnder Reviewに設定され、レビュアーに通知が送られます。

Claiming a review

複数の人にレビューが依頼されている場合、そのうちの誰か1人がそれを引き受けることができます。

  • 検出事項で、検出事項メニューのClaim Review、またはレビューバナー内のボタンを使用します。
  • 検出事項自体に、検出事項リストのClaimed By列として、またその人のMy Workキューに、誰がそのレビューを保持しているかが表示されます。

レビューが受け持たれると、以下のようになります。

  • 保持している本人、依頼した本人、またはスーパーユーザーのみがClear Reviewできます。他の対象レビュアーには、代わりに誰が保持しているかが表示されます。
  • 保持者はRelease Reviewを使ってそれを差し戻すことができ、レビューを終了させずにプールへ戻します。

2人が同時に受け持とうとした場合、一方が成功し、もう一方には誰が獲得したかが伝えられます — レビューは常に1人だけが保持できます。

受け持ちは、本来であれば手動で後始末が必要になるいくつかの状況において、自動的に処理されます。

  • レビューをクリアすると、受け持ちはcompletedとマークされます。
  • 保持者をレビュアーリストから削除する、または検出事項をクローズもしくは再オープンすると、受け持ちはreleasesされます。
  • バックグラウンドジョブが、保持者が依頼済みレビュアーでなくなった受け持ちを解放します。

completedとreleasedは別々に記録されるため、放棄されたレビューと完了したレビューを区別できます。

受け持ちは、デフォルトで有効になっているReview Claiming機能フラグによって制御されます。

Controlling who can be asked to review

「All eligible reviewers」とは、そのアセットに対してReview Findings権限を持つ全員を指し、検出事項を編集できる全員ではありません。

これは、広い可視性を確保しつつレビュアーのプールを小さく保ちたい場合に重要です。Review Findingsは独立した権限であるため、以下のことが可能です。

  1. Review Findingsを付与するロール(例えば「Security Reviewer」)を作成します。
  2. 実際に依頼すべき少数の人にそのロールを付与します。
  3. より広範なロールからReview Findingsを削除し、検出事項へのアクセス権はそのままにしておきます。

ロールの作成方法については、Custom RBAC Rolesを参照してください。

アップグレード時、すでに検出事項を編集できたすべてのロールにはReview Findingsも付与されるため、意図的に変更しない限り、「All eligible reviewers」は以前と同じ意味を持ち続けます。

Assigning a Finding to a person

レビューは誰かに確認を依頼するものです。割り当ては誰かを責任者にするものであり、検出事項をレビュー中にするものではありません。

Assigneesは、検出事項編集フォームでOwnersと並んで表示されます。Ownersはグループ、つまりこの検出事項が属するキューのチームであり、Assigneesは個人です。

  • 検出事項編集フォームから割り当てるか、一括編集ツールから複数の検出事項に一度に割り当てます。
  • 一括編集ツールでは、担当者はすでに割り当てられている人にaddedされます。Replace existing assigneesにチェックを入れると、選択内容が完全なリストとなり、選択されなかった人はすべて削除されます(誰も選択しなければ全員が削除されます)。
  • 検出事項リストにはAssignees列と担当者フィルターがあり、レポートにもAssignees列を含めることができます。
  • 各人の割り当ては、その人のMy Workキューに表示されます。

検出事項を割り当てられるのは、すでにその検出事項を閲覧できる人だけです。割り当てによってアクセス権が付与されるわけではありません。

Rules Engineを使用すると、担当者を自動的に設定できます。Set Usersassigneesフィールドを選択します。

割り当ては、Work Assignment機能フラグによって制御されます。