Zum Hauptinhalt springen
Ausstellungsrichtlinien ermöglichen es Ihnen, Compliance-, Jurisdiktions- und Vertrauensanforderungen für die Prägung, Verifizierung und den Export von Proof-Bundles durchzusetzen. Wenn eine Richtlinie aktiv ist, wird jede passende Anfrage vor der Bearbeitung anhand Ihrer Regeln bewertet. Anfragen, die nicht übereinstimmen, werden mit einem klaren Grund abgelehnt.

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
Wenn Sie keine Richtlinien erstellen, sind standardmäßig alle Präge-, Verifizierungs- und Exportanfragen erlaubt.

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 – ALLOW oder DENY, wenn die Bedingungen übereinstimmen
  • Standardeffekt – wird angewendet, wenn keine Regel übereinstimmt
Regeln werden der Reihe nach ausgewertet. Die erste übereinstimmende Regel bestimmt das Ergebnis. Wenn keine Regel übereinstimmt, gilt der 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:
  1. Als DRAFT erstellen – Schreiben und verfeinern Sie Ihre Regeln, ohne den Live-Verkehr zu beeinflussen.
  2. Simulieren – Testen Sie den Richtlinienentwurf anhand von Beispiel-Eingaben mit dem Richtliniensimulator.
  3. Aktivieren – setzen Sie den Status auf ACTIVE, damit die Richtlinie bei übereinstimmenden Anfragen durchgesetzt wird.
  4. Deaktivieren – setzen Sie den Status auf DISABLED, um die Durchsetzung vorübergehend zu stoppen, ohne die Richtliniendefinition zu verlieren.
  5. Löschen – entfernen Sie die Richtlinie vollständig, wenn sie nicht mehr benötigt wird.
Sie können jederzeit zwischen 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.
Um diese Richtlinie über die API zu erstellen, setzen Sie 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

Um eine Richtlinie als mandantenweiten Standard anzuwenden, setzen Sie target_type auf TENANT_DEFAULT und lassen Sie target_id weg:
Verwenden Sie höhere Prioritätswerte für spezifischere Bindungen. Weisen Sie beispielsweise einer Bindung auf Aussteller-Ebene die Priorität 100 und der Mandanten-Standardeinstellung 10 zu, damit die ausstellerspezifische Richtlinie zuerst ausgewertet wird.

Eine Richtlinie erstellen

Über die Konsole

  1. Gehen Sie in der Konsolen-Seitenleiste zu Richtlinien
  2. Klicken Sie auf Richtlinie erstellen
  3. Geben Sie einen Namen ein, wählen Sie eine Kategorie (MINT, VERIFY oder BUNDLE_EXPORT) und wählen Sie einen Status
  4. Schreiben Sie Ihre Regeln im JSON-Format oder verwenden Sie eine Vorlage
  5. Klicken Sie auf Richtlinie bereitstellen – wenn der Status ACTIVE ist, 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 Sie status auf DRAFT, wenn Sie die Richtlinie speichern möchten, ohne sie sofort durchzusetzen.
Response

Richtlinien auflisten

Gibt ein Array aller Richtlinien für den aktuellen Mandanten zurück.

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
Die Antwort enthält vier Felder:
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.
Wenn keine Regel übereinstimmt, spiegelt die Antwort den 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 eine decision_id, die Sie in Audit-Abfragen referenzieren können:
Der Audit-Datensatz enthält Felder, die nicht Teil der Evaluate-API-Antwort sind, wie z. B. 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:
Das Löschen einer Richtlinie wird sofort wirksam. Alle ausstehenden Mint- oder Verify-Anfragen, die der Richtlinie unterlagen, werden nicht mehr gegen sie bewertet.

Beispiel: Richtlinie mit mehreren Regeln

Kombinieren Sie mehrere Regeln, um komplexe Anforderungen auszudrücken. Regeln werden der Reihe nach ausgewertet – die erste Übereinstimmung gewinnt.
Diese Richtlinie lehnt Aussteller der Einzelstufe unabhängig von der Gerichtsbarkeit ab, erlaubt US- und EU-Ausstellern in jeder anderen Vertrauensstufe und lehnt alle anderen ab.

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.