diff --git a/rfcs/text/0042-risk-score-extensions.md b/rfcs/text/0042-risk-score-extensions.md index 329dd3804..4446807c4 100644 --- a/rfcs/text/0042-risk-score-extensions.md +++ b/rfcs/text/0042-risk-score-extensions.md @@ -9,9 +9,6 @@ As you work on your RFC, use the "Stage N" comments to guide you in what you sho Feel free to remove these comments as you go along. --> - This RFC seeks to extend the [existing risk fields](https://www.elastic.co/guide/en/ecs/current/ecs-risk.html) [(RFC 0031)](https://github.com/elastic/ecs/pull/2048) to support new/extended Risk Score investigation workflows. The workflows that this RFC intends to enable include all those described in 0031, along with the following: 1. Risk Score Explainability @@ -24,9 +21,6 @@ This RFC seeks to extend the [existing risk fields](https://www.elastic.co/guide * These categories' definitions may be _extended_ in the future to include new data sources * Due to the above category traits, we need to come up with a naming convention for these categorical score fields that allows them to be extended without invalidating the existing field names. - @@ -44,15 +75,11 @@ Stage 2: Add or update all remaining field definitions. The list should now be e ## Usage - +We intend to leverage these new fields as part of the new implementation of the Risk Engine within Kibana. In fact, we have already written [the code that uses these fields](https://github.com/elastic/kibana/pull/161503/files#diff-75c9ad5c7d4b56459148fd9c08cb6cb229e932ea00f3e39725134ba429ad2915R66-R85), albeit not in the exact form described here. Beyond the existing ECS `risk` fields, the new implementation mainly seeks to improve explainability of individual risk scores. ## Source data - +The new Risk Engine will initially use Detection Engine Alerts as inputs to its scoring mechanism. However, we intend also to allow ingestion from the other Risk Categories described here, provided that they conform to the appropriate schema. Said schema is outside of the scope of this RFC, but based on the current implementation all we will need are a `score` field and a `category` field in order to ingest any arbitrary document. @@ -91,19 +125,8 @@ Stage 3: Document resolutions for all existing concerns. Any new concerns should The following are the people that consulted on the contents of this RFC. * @rylnd | author -* @SourinPaul | SME / EA product manager - - +* @SourinPaul | sponsor +* @ebeahan | reviewer ## References @@ -117,6 +140,7 @@ e.g.: * Stage 0: https://github.com/elastic/ecs/pull/2232 +* Stage 1: https://github.com/elastic/ecs/pull/2236