alerts.py: per-key alert rules and English security statuses (section 19)
This commit is contained in:
1 parent
0fdb8b48a5
commit
3024a6bb43
1 file changed
+16
-14
@@ -4,9 +4,9 @@ The rules follow the follow-up requirements for the annual health check. The
|
|||||||
application only reports these alerts; it never performs the follow-up actions
|
application only reports these alerts; it never performs the follow-up actions
|
||||||
itself.
|
itself.
|
||||||
|
|
||||||
The stored status values are intentionally Norwegian (``PROBLEM``,
|
One saved check covers one key. A key that was not available produces a single
|
||||||
``IKKJE_VURDERT``, ``SÅRBAR``, ``KOMPROMITTERT``) because they are data values
|
critical alert, because the remaining checks for that key could not be
|
||||||
from the requirement specification. Only the surrounding copy is English.
|
performed.
|
||||||
"""
|
"""
|
||||||
|
|
||||||
CRITICAL = "critical"
|
CRITICAL = "critical"
|
||||||
@@ -41,15 +41,17 @@ def _alert(code, severity, source, message):
|
|||||||
def _key_alerts(key_check):
|
def _key_alerts(key_check):
|
||||||
"""Return the alerts for one key check."""
|
"""Return the alerts for one key check."""
|
||||||
source = f"Key {key_check.get('key_number')}: {key_check.get('name')}"
|
source = f"Key {key_check.get('key_number')}: {key_check.get('name')}"
|
||||||
alerts = []
|
|
||||||
|
|
||||||
if key_check.get("available") == 0:
|
if key_check.get("available") == 0:
|
||||||
alerts.append(_alert(
|
# The remaining checks for this key could not be performed.
|
||||||
|
return [_alert(
|
||||||
"key_unavailable",
|
"key_unavailable",
|
||||||
CRITICAL,
|
CRITICAL,
|
||||||
source,
|
source,
|
||||||
"This key was not available. Immediate follow-up is required.",
|
"This key was not available. Replace the key before continuing; "
|
||||||
))
|
"the remaining checks for this key cannot be recorded.",
|
||||||
|
)]
|
||||||
|
|
||||||
|
alerts = []
|
||||||
if key_check.get("hardware_works") == 0:
|
if key_check.get("hardware_works") == 0:
|
||||||
alerts.append(_alert(
|
alerts.append(_alert(
|
||||||
"hardware_failure",
|
"hardware_failure",
|
||||||
@@ -57,14 +59,14 @@ def _key_alerts(key_check):
|
|||||||
source,
|
source,
|
||||||
"The hardware does not work. Test the seed backup on another compatible device.",
|
"The hardware does not work. Test the seed backup on another compatible device.",
|
||||||
))
|
))
|
||||||
if key_check.get("seed_backup_status") == "PROBLEM":
|
if key_check.get("seed_backup_verified") == "PROBLEM":
|
||||||
alerts.append(_alert(
|
alerts.append(_alert(
|
||||||
"seed_backup_problem",
|
"seed_backup_problem",
|
||||||
CRITICAL,
|
CRITICAL,
|
||||||
source,
|
source,
|
||||||
"The seed backup is missing or damaged. Activate PROTOCOL 3: key loss.",
|
"The seed backup is missing or damaged. Activate PROTOCOL 3: key loss.",
|
||||||
))
|
))
|
||||||
if key_check.get("address_verified") == 0 or key_check.get("address_path_verified") == 0:
|
if key_check.get("address_path_verified") == "PROBLEM":
|
||||||
alerts.append(_alert(
|
alerts.append(_alert(
|
||||||
"address_verification_failed",
|
"address_verification_failed",
|
||||||
CRITICAL,
|
CRITICAL,
|
||||||
@@ -113,19 +115,19 @@ def _security_alerts(security_check):
|
|||||||
provider = security_check.get("provider")
|
provider = security_check.get("provider")
|
||||||
status = security_check.get("status")
|
status = security_check.get("status")
|
||||||
|
|
||||||
if status == "SÅRBAR":
|
if status == "VULNERABLE":
|
||||||
return [_alert(
|
return [_alert(
|
||||||
"security_vulnerable",
|
"security_vulnerable",
|
||||||
CRITICAL,
|
CRITICAL,
|
||||||
provider,
|
provider,
|
||||||
"Security status SÅRBAR: the firmware or security problem must be followed up.",
|
"Security status VULNERABLE: the firmware or security problem must be followed up.",
|
||||||
)]
|
)]
|
||||||
if status == "KOMPROMITTERT":
|
if status == "COMPROMISED":
|
||||||
return [_alert(
|
return [_alert(
|
||||||
"security_compromised",
|
"security_compromised",
|
||||||
CRITICAL,
|
CRITICAL,
|
||||||
provider,
|
provider,
|
||||||
"Security status KOMPROMITTERT: follow the key loss procedure.",
|
"Security status COMPROMISED: follow the key loss procedure.",
|
||||||
)]
|
)]
|
||||||
return []
|
return []
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user