diff --git a/sightings/README.md b/sightings/README.md index 30013e0..649fd85 100644 --- a/sightings/README.md +++ b/sightings/README.md @@ -6,13 +6,13 @@ Basically, sighting is a system allowing people to react on attributes on an eve Now sightings have been improved to also provide a method to signal false positives, but also to give an expiration date for some attributes. -### Explanations +### Explanation As said before, Sighting is a way for a user to say that they have seen or notice an attribute and confirm its validity. An attribute can been spotted several times by the same user, that is why a single user can use sighting several times on a single attribute. Sometimes, some attributes can be considered as false positives, even if the false positive list do not detect them (for instance, if the IDS flag is set to false) so they can also be notified. As well as concerning sighting, the same user can signal a single attribute as a false positive several times. -It also happens that some attributes are only valid a certain time (for instance, in case of a phishing campagn that is assumed to be up for only one week). In this case, people can also assign an expiration date to an attribute, but this time, there can be only one valid expiration date per *organisation*. +It also happens that some attributes are only valid a certain time (for instance, in case of a phishing campagne that is assumed to be up for only one week). In this case, people can also assign an expiration date to an attribute, but this time, there can be only one valid expiration date per *organisation*. ### Using sightings on an event (GUI) @@ -26,5 +26,38 @@ These three values show respectively: - The number of different expiration dates that have been affected on this attribute, in orange Concerning the three icons: -- The first one (Thumb up) allow to add a sighting on an attribute. -- The second one (Thumb down) WIPWIPWIPWIPWIPWIPWIPWIPWIP +- The first one (Thumb up) allows to add a sighting on an attribute. +- The second one (Thumb down) allows to mark the attribute as a false positive. +- The third one (Tool) opens a popup for advanced sightings, showing sightings details and allowing different actions. + +#### Advanced sightings + +- The first tab, "Graph", represents a line graph showing the evolution of sightings and false positives over time. + +![sighting graph](./figures/sightinggraph.png) + +- The second tab gives a quick view of all the sightings applied to the attribute. + +![sighting all](./figures/sightingall.png) + +- The third tab gives a quick view of the sightings applied to the attribute by your own organisation only. + +![sighting my org](./figures/sightingmyorg.png) + +- The last tab can be used to add either a sighting, mark the attribute as a false positive, or define an expiration date. You can precise both the date and time of day, as well as note a particular source where the sighting comes from. + +![sighting add](./figures/sightingadd.png) + +#### At Event level + +The total number of sightings is also visible as part of the metadata in front of the Sightings label, as well as a sparkline graph that summarize the evolution of sightings. + +![sighting event](./figures/sightingevent.png) + +Clicking on the tool will show sighting details for the whole event. + +![sighting event popup](./figures/sightingeventpopup.png) + +### Using sightings on an event (API) + +WiP diff --git a/sightings/figures/sightingadd.png b/sightings/figures/sightingadd.png new file mode 100644 index 0000000..5cdf995 Binary files /dev/null and b/sightings/figures/sightingadd.png differ diff --git a/sightings/figures/sightingall.png b/sightings/figures/sightingall.png new file mode 100644 index 0000000..48249dc Binary files /dev/null and b/sightings/figures/sightingall.png differ diff --git a/sightings/figures/sightingevent.png b/sightings/figures/sightingevent.png new file mode 100644 index 0000000..569c5dd Binary files /dev/null and b/sightings/figures/sightingevent.png differ diff --git a/sightings/figures/sightingeventpopup.png b/sightings/figures/sightingeventpopup.png new file mode 100644 index 0000000..ed17ebd Binary files /dev/null and b/sightings/figures/sightingeventpopup.png differ diff --git a/sightings/figures/sightinggraph.png b/sightings/figures/sightinggraph.png new file mode 100644 index 0000000..71f7147 Binary files /dev/null and b/sightings/figures/sightinggraph.png differ diff --git a/sightings/figures/sightingmyorg.png b/sightings/figures/sightingmyorg.png new file mode 100644 index 0000000..57239d6 Binary files /dev/null and b/sightings/figures/sightingmyorg.png differ