Definiert Akteure, Inhaltszustände, Regeln, Prüfpfade, Nachrichten, Einsprüche und Randfälle für sichere Darstellung. Diese Referenz legt die Übernahmegrenze, das Fehlverhalten und beobachtbare Beweise fest, während umgebungsspezifische Grenzen konfigurierbar bleiben.
Paketstatus: Referenzkontext bereit für menschliche Überprüfung. Der Vertrag und die Testszenarien sind vollständig, es wird jedoch nicht behauptet, dass eine übernehmende Implementierung diese bestanden hat.
Entscheidung
Für sichere Darstellung wird ein versionierter Inhaltsdatensatz und eine Moderationszustandsmaschine übernommen. Das für den Benutzer sichtbare Versprechen, Ausschlüsse, Autorität und Fehlerreaktion werden explizit gemacht, während gemessene Schwellenwerte als Übernahmeentscheidungen offenbleiben. Dieses Paket ist ein Referenzvertrag: Das übernehmende Team muss numerische Grenzen, Anbieter, Rechtsordnungen und operative Verantwortliche anhand von Beweisen in der eigenen Umgebung wählen.
Umfang
- Die Akteure, Eingaben, Ausgaben, Zustände, Richtlinien- oder Schemaversionen und extern sichtbaren Ergebnisse der sicheren Darstellung, die durch diesen Anforderungsblock beschrieben werden.
- Primäre und alternative Schnittstellen, Hintergrundarbeiten, Caches, Integrationen, Supportpfade und Beweise, die dieselbe Grenze ausüben können.
- Übernahmespezifische Konfiguration, Rollout, Wiederherstellung und Verifikationsverantwortlichkeiten, die benötigt werden, um die Referenz sicher anzuwenden.
Außerhalb dieses Blocks
- Die Wahl eines universellen Anbieters, Frameworks, einer Rechtsordnung, eines numerischen Schwellenwerts, einer Aufbewahrungsfrist oder eines Service-Level-Objectives für jeden Übernehmer.
- Die Behauptung, dass verpackte Szenarien gegen eine nachgelagerte Implementierung ausgeführt wurden oder dass diese Referenz rechtliche, Sicherheits- oder Barrierefreiheitszertifizierungen gewährt.
Vertrag
- Originaleingaben getrennt von normalisierten oder gerenderten Ausgaben speichern und den verwendeten Transformer- und Richtlinienversion identifizieren.
- Für den tatsächlichen Ausgabekontext säubern; Parsing, Markdown-Konvertierung und MIME-Bezeichnungen machen aktive Inhalte nicht vertrauenswürdig.
- Erstellen, Bearbeiten, Veröffentlichen, Moderieren, Einspruch erheben und Löschen unabhängig autorisieren und die materielle Entscheidungsnachverfolgung aufbewahren.
- Ausstehende, erlaubte, eingeschränkte, abgelehnte, angefochtene und entfernte Zustände explizit darstellen, anstatt Sichtbarkeitsflags zu überladen.
- Angeben, welcher Akteur unter jedem materiellen Zustand welches Ergebnis erhält, einschließlich nicht verfügbar, nicht autorisiert, leer und teilweise Bedingungen.
- Konfigurierbare Grenzen und Richtlinien als Wahlmöglichkeiten mit Eigentümern kennzeichnen; Beispielwerte nicht als universelle Anforderungen präsentieren.
- Unvertrauenswürdige Inhalte in eine eingeschränkte Darstellung parsen, unterstützte Konstrukte auf eine Positivliste setzen, für den finalen Ausgabekontext säubern und aktive Formate in einer isolierten Origin oder einem Worker rendern.
- Skripte, unsichere URLs, Ereignishandler, externe Abrufe, ausführbares SVG und Ressourcenmissbrauch blockieren und Parser sowie Richtlinie versionieren für reproduzierbare Nachverarbeitung.
Implementierungsleitfaden
- Den Vertrag mit Produkt, Implementierung, Betrieb, Sicherheit und betroffenen Nutzern überprüfen, bevor er über die Überprüfung hinaus freigegeben wird.
- Sichere Darstellungs-Eingaben, -Ausgaben, -Akteure, -Zustände, Invarianten, Nebeneffekte und Beweise modellieren, bevor Framework- oder Anbieterdetails ausgewählt werden.
- Die anwendbare Version des sicheren Darstellungsvertrags oder der Richtlinie mit materiellem Zustand speichern, damit Migrationen, Wiedergabe und Supportentscheidungen zuordenbar bleiben.
- Den Pfad hinter kontrolliertem Rollout einführen, erwartete und beobachtete Ergebnisse vergleichen und eine getestete Wiederherstellungsroute bis zum Abschluss der Übernahmebeweise beibehalten.
Fehlerbehandlung und Schutzmaßnahmen
- Unsichere oder nicht klassifizierbare Inhalte bleiben standardmäßig nicht verfügbar und durchlaufen einen begrenzten Prüf- oder Ablehnungspfad.
- Ungültiger oder widersprüchlicher sicherer Darstellungszustand wird abgelehnt oder isoliert; die Implementierung schätzt niemals einen Wert, der Autorität erweitert oder eine Wirkung dupliziert.
- Wiederholungen sind begrenzt und verwenden dauerhafte Identität; nach Erschöpfung erreicht die Arbeit einen inspizierbaren Endzustand mit verantwortlichem Eigentümer.
Verifikation und Betrieb
- Jede Zusage und jeden Ausschluss mindestens einem beobachtbaren Szenario zuordnen und bestätigen, dass keine zwei Zustände widersprüchliche Ergebnisse erfordern.
- Erfolg, Ablehnung, Validierungsfehler, Abhängigkeitsfehler, Erschöpfung von Wiederholungen und Wiederherstellung der sicheren Darstellung nach Vertragsversion ohne sensible Nutzlastdimensionen überwachen.
- Nach Änderungen an Richtlinie, Schema, Abhängigkeiten, Migration oder Grenze positive und negative Paartests erneut ausführen und die resultierenden Beweise bewahren.
Übernahmeannahmen
- Namen und Werte im Beispiel sind ein konkretes Fixture, keine universellen Standardwerte; Übernehmer ersetzen sie durch dokumentierte Beweise und Eigentümerschaft.
- Das übernehmende System kann authentifizierte Identität, dauerhafte Betriebs- oder Versionsaufzeichnungen, begrenzte Telemetrie und einen kontrollierten Änderungsweg bereitstellen.
Die ausführbar aussehenden Beispiele in diesem Paket sind Fixtures und Akzeptanzverträge. Führen Sie den Sammlungsvalidator aus, um Struktur und Metadaten zu prüfen, übersetzen und führen Sie dann die Szenarien im Ziel-Repository aus, bevor Sie Implementierungsbeweise aufzeichnen.