Berichtsformate - JSON von Zertifikatscan und Security Scan
Das JSON, das das aethercert Toolkit exportiert: der versionierte Umschlag, die Schemas cert-scan/v1 und security-scan/v1 und die CSV-Spalten eines Zertifikatsinventars.
Der Zertifikatscanner und der
Security Scan exportieren JSON in einem versionierten
Umschlag - in der Desktop-App (JSON exportieren) und mit actk scan --json bzw.
actk security --json. Nutzen Sie die Dateien, um ein Inventar zu führen, Scans über die
Zeit zu vergleichen oder eigene Werkzeuge zu versorgen.
Der Umschlag
{
"schema": "aethercert.toolkit.cert-scan/v1",
"tool": { "name": "aethercert-toolkit", "version": "0.1.1" },
"generated_at": "2026-10-27T12:00:00Z",
"data": { "...": "..." }
}| Feld | Bedeutung |
|---|---|
schema | Form und Version der Nutzdaten. Werten Sie dieses Feld aus, statt Felder zu raten. |
tool | Programm und Version, die die Datei geschrieben haben. |
generated_at | Wann die Datei geschrieben wurde, RFC 3339, UTC. |
data | Die Nutzdaten. |
Schemas
| Schema | Geschrieben von | data enthält |
|---|---|---|
aethercert.toolkit.cert-scan/v1 | Zertifikatscanner, actk scan | targets, ports, eine summary (Prüfungen, TLS- und Nicht-TLS-Endpunkte, nicht auflösbare Hosts, Dauer, ob gestoppt) und einen Eintrag pro endpoints-Element |
aethercert.toolkit.security-scan/v1 | Security Scan, actk security | hostname, port, status, overall_grade, overall_score, tls_result, headers_result, error_message, duration_ms |
Jeder Endpunkt eines Zertifikatscans hat host, address, port, transport, status
(tls oder no_tls), sni, method (handshake, oder legacy_hello, wenn das Zertifikat
aus dem Handshake eines alten Servers gelesen wurde), protocol, cipher, error und ein
Objekt certificate: subject_cn, issuer_cn, sans, not_before, not_after,
days_until_expiry, key_type, key_size_bits, signature_algorithm,
fingerprint_sha256, self_signed, trusted_root, hostname_match, chain_length, dazu
subject, issuer, serial_hex, checked_name, trust_error und die gesendete chain
(jeder Eintrag mit seinem PEM).
security-scan/v1 ist feldkompatibel mit den Ergebnissen des öffentlichen
Security Scans von aethercert.com.
Befunde tragen einen stabilen code (dieselben Codes wie der öffentliche Scanner), die
englische message, eine severity (danger oder warning) und die eingesetzten Werte in
args.
Kompatibilitätsregeln
- Feldnamen sind
snake_case. - Schemas ändern sich nur additiv. Ein neues Feld kann in einer
v1-Datei auftauchen; ein umbenanntes oder entferntes Feld bedeutet eine neue Version (v2). - Zeitangaben sind RFC 3339. Fingerabdrücke sind SHA-256 in Großbuchstaben-Hex, durch Doppelpunkte getrennt.
Was ein Bericht nie enthält
Kein Bericht, Export oder Log enthält Schlüsselmaterial - nur öffentliche Zertifikate, Metadaten und Netzwerkadressen. Hostnamen, interne Adressen und Ports sind dennoch sensible Informationen über Ihr Netz: Speichern und teilen Sie die Dateien entsprechend.
CSV
CSV exportieren und actk scan --csv schreiben eine Zeile pro Endpunkt:
host,address,port,transport,status,protocol,cipher,subject_cn,sans,issuer_cn,not_before,
not_after,days_until_expiry,key_type,key_size_bits,signature_algorithm,self_signed,
trusted_chain,hostname_match,serial,fingerprint_sha256,erroractk-Kommandozeilenreferenz
Jeder actk-Befehl und jede Option: CSR per Kommandozeile erstellen, PFX bauen, Code signieren, den Windows-Zertifikatspeicher verwalten, Netze scannen und TLS bewerten.
Datenschutz und Sicherheit - wie das Toolkit mit privaten Schlüsseln umgeht
Das aethercert Toolkit läuft vollständig lokal: kein Konto, keine Telemetrie, kein Upload. Wo private Schlüssel entstehen und liegen, was ins Netz geht und was gespeichert wird.