ピアレビューと受け持ち (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は独立した権限であるため、以下のことが可能です。
- Review Findingsを付与するロール(例えば「Security Reviewer」)を作成します。
- 実際に依頼すべき少数の人にそのロールを付与します。
- より広範なロールから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 Usersとassigneesフィールドを選択します。
割り当ては、Work Assignment機能フラグによって制御されます。