Files
rengine/reports/sections/certificates/section.py
T
Yogesh OjhaandClaude Opus 5 724ebd42bb feat(reports): a section declares its role, its order and what it asks at generate time
Choosing what a report contains required editing a template. That is the wrong
place for a decision made per report, and the scan launch flow already
established the alternative: a saved configuration seeds the run, the run may
depart from it, and the saved configuration is never touched.

Three declarations put sections on the same footing as stages. SectionRole
separates the content a reader asked for from the furniture around it, so a
picker can offer twenty-one choices and include the cover, the contents and the
reference matter without being asked. Section.order fixes the reading order,
which until now was however the directories happened to sort — the executive
summary came after attack paths because "a" precedes "e". Section.launch_fields
names the settings worth surfacing when the report is generated rather than
only in the builder, mirroring Stage.launch_fields; the findings section
declares its severities, its detail depth, its roll-up and its asset cap.

The estimate had to become honest for any of this to be worth showing. It
counted every finding in the scan whatever the section filtered to, so dropping
three severities moved nothing. It now counts through the same severity filter
the section applies and prices each tier separately, from the real per-severity
issue counts rather than an assumed split: 28 pages against 26 rendered for a
full template, 10 against 9 for critical and high alone.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AW5pitnosX8LEFEYxH8gFS
2026-09-06 17:14:01 +05:30

83 lines
2.9 KiB
Python

from __future__ import annotations
from reports.base import RenderContext, Section
from reports.config import SectionConfig, flag, limit
from shared.definitions.reports import SectionGroup
from shared.definitions.surface import SurfaceDimension
class CertificatesConfig(SectionConfig):
expiring_days: int = limit(
30, title="Treat as expiring within (days)", minimum=1, maximum=365
)
problems_only: bool = flag(True, title="Only certificates that need attention")
max_rows: int = limit(50, title="Rows shown", minimum=5, maximum=1000)
show_issuers: bool = flag(True, title="Show the issuer breakdown")
class CertificatesSection(Section):
name = "certificates"
title = "Certificates"
description = (
"Expired, expiring and self-signed certificates on assets that answered."
)
group = SectionGroup.SURFACE.value
order = 50
requires = frozenset({SurfaceDimension.WEB_ASSETS.value})
config_model = CertificatesConfig
def build(self, ctx: RenderContext, cfg: CertificatesConfig) -> dict | None:
certificates = ctx.data.certificates
if not certificates:
return None
expired = [c for c in certificates if c.expired]
expiring = [
c
for c in certificates
if not c.expired
and c.days_left is not None
and 0 <= c.days_left <= cfg.expiring_days
]
self_signed = [c for c in certificates if c.self_signed]
problems = sorted(
{c.host: c for c in expired + expiring + self_signed}.values(),
key=lambda c: c.days_left if c.days_left is not None else 9999,
)
rows = (
problems
if cfg.problems_only
else sorted(
certificates,
key=lambda c: c.days_left if c.days_left is not None else 9999,
)
)
if cfg.problems_only and not rows:
return {
"rows": [],
"clean": True,
"total": len(certificates),
"expired": 0,
"expiring": 0,
"self_signed": 0,
"issuers": [],
"hidden": 0,
"window": cfg.expiring_days,
}
issuers: dict[str, int] = {}
for certificate in certificates:
key = certificate.issuer or "Unknown"
issuers[key] = issuers.get(key, 0) + 1
return {
"rows": rows[: cfg.max_rows],
"clean": False,
"total": len(certificates),
"expired": len(expired),
"expiring": len(expiring),
"self_signed": len(self_signed),
"hidden": max(0, len(rows) - cfg.max_rows),
"window": cfg.expiring_days,
"issuers": sorted(issuers.items(), key=lambda item: -item[1])[:8]
if cfg.show_issuers
else [],
}