Glossar

Fund

Eine Erkennung: Eine Regel hat an einer bestimmten Stelle in Jira Text getroffen. Ein Fund hat einen Schweregrad, einen Prüfstatus, einen geschlüsselten Fingerabdruck und eine Fundstelle - und keine Kopie des getroffenen Textes. Er trägt seine Prüfhistorie über Scans hinweg weiter.

Vorkommen

Eine Sichtung eines Fundes in einem Scan-Lauf. Ein Fund, der über fünf Scans hinweg fortbesteht, hat einen Fund-Datensatz und fünf Vorkommen - genau das macht "zuerst gesehen" und "noch vorhanden" aussagekräftig.

Fingerabdruck

Ein geschlüsselter HMAC des Trefferwerts, mit dem derselbe Fund über Scans hinweg wiedererkannt wird, ohne den Wert zu speichern. Er sorgt dafür, dass Prüfentscheidungen und Unterdrückungen haften. Abgeleitet aus FINDING_FINGERPRINT_HMAC_SECRET - ein Wechsel dieses Secrets ändert die Identität jedes Fundes. Siehe Sicherheit.

Prüfstatus

Eine Entscheidung je Fund: OPEN, FALSE_POSITIVE, ACCEPTED_RISK oder FIXED. Ein einmaliges Urteil über diesen Fund.

Unterdrückung

Eine in die Zukunft gerichtete Regel, die eine Klasse bekannter unkritischer Treffer aus der aktiven Fundliste ausblendet - global oder begrenzt auf eine Regel, ein Projekt oder ein Feld. Stärker und breiter als ein einzelner False Positive. Aufgehobene Unterdrückungen bleiben sichtbar, damit ausgeblendete Funde erklärbar bleiben. Siehe Unterdrückungen.

Regel

Ein Erkennungsmuster: ein Regex plus Schweregrad, Kategorie, Geltungsbereich und Kontext-Schlüsselwörter. Eine Regelversion kann zusätzlich Validatoren tragen - Entropie, Länge, Prüfsumme und Schlüsselwort-Nähe. Entweder eingebaut oder eigen.

Regelversion

Regeln sind unveränderlich und versioniert. Eine Regel zu bearbeiten - oder auch nur ein- bzw. auszuschalten - hängt eine neue Version an, statt die alte zu ändern; Funde halten die exakte Version fest, die sie erzeugt hat, und auf jede frühere Version lässt sich zurückrollen.

Scan-Konfiguration

Eine gespeicherte Definition, was gescannt wird und wie stark: Projekte, Felder, Kommentare, Anhänge, Textmodus, Engine-Tuning und ein optionaler Zeitplan.

Konfigurationsversion und Konfigurationsgruppe

Scan-Konfigurationen sind unveränderliche Snapshots. Änderungen zu speichern erzeugt eine neue Version; alle Versionen derselben Konfiguration teilen sich eine Konfigurationsgruppe, an der Zeitplan und Scan-Historie hängen. Ein Scan-Lauf hält die exakte verwendete Version fest, sodass ein alter Lauf immer erklärbar bleibt.

Textmodus

Ob ein Scan gerenderten Text liest (wie Jira ihn darstellt), rohe Feldwerte (wie gespeichert, inklusive Markup) oder beides. Beides ist der Standard und findet Secrets, die im Markup versteckt sind und beim Rendern verschluckt würden.

Der verwendete Modus wird an jedem Fund festgehalten: die Textvariante im Quell-Locator eines Funds benennt, in welcher der beiden Repräsentationen der Treffer gefunden wurde. Ein Feld, das Jira nicht rendert, liefert keine gerenderte Variante - ein RENDERED-Scan überspringt es dann, statt auf den Rohwert zurückzufallen.

Scan-Lauf

Eine Ausführung einer Scan-Konfiguration. Hat einen Status (QUEUED, RUNNING, PAUSED, COMPLETED, FAILED, CANCELLED), Zählwerte und eine Fortschrittsphase.

Erkennungszustand

Ob ein Fund noch in Jira vorhanden ist, getrennt von Ihrer Prüfentscheidung geführt: ACTIVE, NOT_FOUND_IN_LATEST_FULL_SCAN (er war da, der jüngste vollständige Scan sieht ihn nicht mehr) oder SOURCE_UNAVAILABLE. Ein Fund, der still verschwindet, ist nicht dasselbe wie einer, den jemand behoben und als behoben markiert hat.

Eingeschränkter Fund

Ein Fund, für den der angemeldete Benutzer nicht berechtigt ist. Die Zeile existiert, damit die Zahlen ehrlich bleiben, aber ihre Details sind verborgen und sie lässt sich nicht für Sammelaktionen auswählen.

Mustererkennung

Eine optionale lokale Analyse, die wiederkehrende strukturierte Werte findet, die keine bestehende Regel abdeckt, und sie als Regelkandidaten vorschlägt. Standardmässig deaktiviert und aus der Navigation ausgeblendet. Siehe Mustererkennung.

Lizenziertes Merkmal

Eine Fähigkeit, die über die signierte Lizenzdatei freigeschaltet wird: SCAN zum Scannen überhaupt, SCAN_ATTACHMENTS zum Lesen von Anhangsinhalten. Siehe Lizenz.