Wann Richtlinien verwendet werden sollten
Verwenden Sie Ausstellungsrichtlinien, wenn Sie Folgendes benötigen:- Die Prägung auf Aussteller in bestimmten Gerichtsbarkeiten beschränken (z. B. nur USA oder USA und EU)
- Eine Mindestvertrauensstufe vorschreiben, bevor ein Aussteller Attestierungen erstellen kann
- Unterschiedliche Regeln für die Prägung vs. Verifizierung durchsetzen
- Kontrollieren, wer Proof-Bundles exportieren oder Datenportabilitätsanfragen stellen kann
- Eine Richtlinie anhand von Beispieleingaben testen, bevor sie in der Produktion bereitgestellt wird
- Überprüfen, welche Richtlinie zum Zeitpunkt der Erstellung einer Attestierung in Kraft war
Wie Richtlinien funktionieren
Jede Richtlinie enthält eine oder mehrere Regeln. Eine Regel hat:- Bedingungen – Feldprüfungen, die anhand des Anforderungskontexts ausgewertet werden (z. B.
jurisdiction eq US) - Effekt –
ALLOWoderDENY, wenn die Bedingungen übereinstimmen - Standardeffekt – wird angewendet, wenn keine Regel übereinstimmt
default_effect.
Bedingungsoperatoren
Bedingungen unterstützen die Punktnotation für verschachtelte Felder (z. B.
key.age_days, key.status).
Verfügbare Felder
Jedes Feld in der Bewertungseingabe kann referenziert werden, einschließlich verschachtelter Felder mit Punktnotation. Die folgenden Felder sind standardmäßig verfügbar:Richtlinien-Lebenszyklus
Jede Richtlinie hat einen Status, der steuert, ob sie durchgesetzt wird:
Wenn Sie eine Richtlinie erstellen, wählen Sie den anfänglichen Status. Nur
ACTIVE Richtlinien werden zum Zeitpunkt der Anforderung ausgewertet.
Lebenszyklusübergänge
Richtlinien folgen typischerweise diesem Verlauf:- Als
DRAFTerstellen – Schreiben und verfeinern Sie Ihre Regeln, ohne den Live-Verkehr zu beeinflussen. - Simulieren – Testen Sie den Richtlinienentwurf anhand von Beispiel-Eingaben mit dem Richtliniensimulator.
- Aktivieren – setzen Sie den Status auf
ACTIVE, damit die Richtlinie bei übereinstimmenden Anfragen durchgesetzt wird. - Deaktivieren – setzen Sie den Status auf
DISABLED, um die Durchsetzung vorübergehend zu stoppen, ohne die Richtliniendefinition zu verlieren. - Löschen – entfernen Sie die Richtlinie vollständig, wenn sie nicht mehr benötigt wird.
DRAFT, ACTIVE und DISABLED wechseln, indem Sie die Richtlinie aktualisieren. Jede Statusänderung erhöht die Richtlinienversion, die zusammen mit jeder Bewertungsentscheidung zur Überprüfbarkeit aufgezeichnet wird.
Die Umstellung einer Richtlinie auf
ACTIVE wird sofort wirksam. Stellen Sie sicher, dass Sie die Regeln vor der Aktivierung mit dem Simulator getestet haben.Richtlinienkategorien
Richtlinien sind auf eine bestimmte Aktion beschränkt:
Sie können mehrere aktive Richtlinien haben. Jede Richtlinie gilt nur für ihre Kategorie.
Exportkontrollrichtlinien
BUNDLE_EXPORT-Richtlinien steuern, wer Proof-Bundles exportieren und Datenportabilitätsanfragen einreichen kann. Verwenden Sie sie, um Exporte nach Gerichtsbarkeit, Vertrauensstufe oder jedem anderen Feld in der Auswertungseingabe einzuschränken.
category auf BUNDLE_EXPORT:
Richtlinienbindungen
Richtlinienbindungen verknüpfen eine Richtlinie mit einem bestimmten Ziel, damit die Engine weiß, wann sie angewendet werden soll. Jede Bindung enthält:
Wenn mehrere Bindungen einer Anfrage entsprechen, werden sie in absteigender Prioritätsreihenfolge ausgewertet. Das erste
DENY Ergebnis stoppt die Auswertung sofort.
Eine Bindung über die API erstellen
target_type auf TENANT_DEFAULT und lassen Sie target_id weg:
Eine Richtlinie erstellen
Über die Konsole
- Gehen Sie in der Konsolen-Seitenleiste zu Richtlinien
- Klicken Sie auf Richtlinie erstellen
- Geben Sie einen Namen ein, wählen Sie eine Kategorie (
MINT,VERIFYoderBUNDLE_EXPORT) und wählen Sie einen Status - Schreiben Sie Ihre Regeln im JSON-Format oder verwenden Sie eine Vorlage
- Klicken Sie auf Richtlinie bereitstellen – wenn der Status
ACTIVEist, wird sie sofort wirksam
Aus einer Vorlage
Die Konsole enthält vier gebrauchsfertige Vorlagen, die Sie mit einem Klick hinzufügen können:
Um eine Vorlage zu verwenden, öffnen Sie den Tab Vorlagen auf der Richtlinienseite und klicken Sie auf Vorlage verwenden. Die Richtlinie wird sofort erstellt und aktiviert. Sie können sie anschließend bearbeiten, um die Regeln anzupassen.
Über die API
Setzen Siestatus auf DRAFT, wenn Sie die Richtlinie speichern möchten, ohne sie sofort durchzusetzen.
Response
Richtlinien auflisten
Simulieren einer Richtlinie
Bevor Sie sich in der Produktion auf eine Richtlinie verlassen, verwenden Sie den Simulator, um zu testen, wie sie eine bestimmte Eingabe bewertet. Öffnen Sie in der Konsole die Registerkarte Simulator auf der Richtlinienseite, wählen Sie eine Richtlinie aus und geben Sie eine Testeingabe ein. Sie können den Auswertungsendpunkt auch direkt aufrufen:Response
Wenn Sie sich zuvor auf
evaluation_ms in der Auswertungsantwort zur Leistungsüberwachung verlassen haben, wurde dieses Feld aus der API-Antwort entfernt. Es wird weiterhin im Entscheidungsprüfprotokoll aufgezeichnet – fragen Sie resource_type=policy_decision im Audit-Log ab, um es abzurufen.default_effect wider:
Audit-Trail für Entscheidungen
Jede Richtlinienbewertung wird automatisch aufgezeichnet. Jede Entscheidung erfasst die Richtlinienversion, die übereinstimmenden Regeln und einen SHA-256-Hash der Eingabe zur Manipulationssicherheit. Verwenden Sie Entscheidungsdatensätze, um nachzuvollziehen, warum eine bestimmte Anfrage zugelassen oder abgelehnt wurde. Die Auswertungsantwort enthält einedecision_id, die Sie in Audit-Abfragen referenzieren können:
evaluation_ms und input_hash:
Eine Richtlinie löschen
Entfernen Sie eine Richtlinie aus der Konsole, indem Sie auf das Löschsymbol auf der Richtlinienkarte klicken oder über die API:Beispiel: Richtlinie mit mehreren Regeln
Kombinieren Sie mehrere Regeln, um komplexe Anforderungen auszudrücken. Regeln werden der Reihe nach ausgewertet – die erste Übereinstimmung gewinnt.Verwandt
Policy Engine SDK
Richtlinien programmgesteuert mit dem SDK für benutzerdefinierte Integrationen auswerten.
Szenarien.
Policy API-Referenz
Richtlinien über die REST-API erstellen, auflisten, auswerten und löschen.
Compliance-Exporte
Auditdaten in SOC 2-, GDPR- und HIPAA-Formaten für Compliance exportieren.
Berichterstattung.
Governance
Verwenden Sie Governance-Workflows für die Genehmigung und Statusänderungen des Ausstellers.

