> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ausstellungsrichtlinien

> Definieren Sie regelbasierte Richtlinien, die steuern, wer in Ihrem Mandanten Bestätigungen prägen, verifizieren und exportieren kann.

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`.

```json theme={null}
{
  "rules": [
    {
      "id": "us_only",
      "description": "US jurisdiction required",
      "conditions": [
        { "field": "jurisdiction", "op": "eq", "value": "US" }
      ],
      "effect": "ALLOW"
    }
  ],
  "default_effect": "DENY"
}
```

### Bedingungsoperatoren

| Operator | Beschreibung | Beispiel |
| - | - | - |
| `eq` | Gleich | `{ "field": "jurisdiction", "op": "eq", "value": "US" }` |
| `neq` | Ungleich | `{ "field": "trust_tier", "op": "neq", "value": "individual" }` |
| `in` | Entspricht einem beliebigen Wert in einer Liste | `{ "field": "trust_tier", "op": "in", "value": ["verified_org", "enterprise"] }` |
| `nin` | Stimmt mit keinem Wert in einer Liste überein | `{ "field": "jurisdiction", "op": "nin", "value": ["CN", "RU"] }` |
| `gt` | Größer als (numerisch) | `{ "field": "key.age_days", "op": "gt", "value": 90 }` |
| `lt` | Kleiner als (numerisch) | `{ "field": "key.age_days", "op": "lt", "value": 365 }` |
| `exists` | Feld ist vorhanden | `{ "field": "jurisdiction", "op": "exists", "value": true }` |

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:

| Feld | Beschreibung |
| - | - |
| `jurisdiction` | Die registrierte Gerichtsbarkeit des Ausstellers (ISO-Ländercode) |
| `trust_tier` | Die Vertrauensstufe des Ausstellers (`individual`, `verified_org`, `regulated_issuer`, `enterprise`) |
| `status` | Der aktuelle Status des Ausstellers (`ACTIVE`, `suspended`, `revoked`, `SUNSET`, `pending`) |
| `risk_rating` | Die Risikobewertung des Ausstellers (`low`, `medium`, `high`, `CRITICAL`) |
| `assurance_level` | Das Zusicherungssniveau des Ausstellers (`standard`, `high`, `regulated`) |
| `key.age_days` | Alter des Signaturschlüssels in Tagen |
| `key.status` | Status des Signaturschlüssels (`ACTIVE`, `REVOKED`, `EXPIRED`) |
| `key.kid` | Kennung des Signaturschlüssels |

## Richtlinien-Lebenszyklus

Jede Richtlinie hat einen Status, der steuert, ob sie durchgesetzt wird:

| Status | Verhalten |
| - | - |
| `DRAFT` | Gespeichert, aber nicht erzwungen – verwenden Sie dies, während Sie Regeln iterieren |
| `ACTIVE` | Bei jeder passenden Anfrage durchgesetzt |
| `DISABLED` | Vorübergehend deaktiviert, ohne die Richtlinie zu löschen |

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](#simulating-a-policy).
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.

> [!NOTE]
>
> 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:

| Kategorie | Gilt für |
| - | - |
| `MINT` | Anfragen zur Prägung von Attestierungen |
| `VERIFY` | Verifizierungsanfragen |
| `BUNDLE_EXPORT` | Proof-Bundle-Export- und Datenportabilitätsanfragen |

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.

```json theme={null}
{
  "rules": [
    {
      "id": "block_non_enterprise",
      "description": "Only enterprise-tier issuers can export bundles",
      "conditions": [
        { "field": "trust_tier", "op": "nin", "value": ["enterprise", "regulated_issuer"] }
      ],
      "effect": "DENY"
    },
    {
      "id": "allow_low_risk",
      "description": "Allow exports for low-risk issuers",
      "conditions": [
        { "field": "risk_rating", "op": "eq", "value": "low" }
      ],
      "effect": "ALLOW"
    }
  ],
  "default_effect": "DENY"
}
```

Um diese Richtlinie über die API zu erstellen, setzen Sie `category` auf `BUNDLE_EXPORT`:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Enterprise Export Only",
    "category": "BUNDLE_EXPORT",
    "status": "ACTIVE",
    "description": "Restrict proof-bundle exports to enterprise issuers with low risk",
    "language": "json_rules",
    "rules": {
      "rules": [
        {
          "id": "block_non_enterprise",
          "description": "Only enterprise-tier issuers can export bundles",
          "conditions": [
            { "field": "trust_tier", "op": "nin", "value": ["enterprise", "regulated_issuer"] }
          ],
          "effect": "DENY"
        }
      ],
      "default_effect": "ALLOW"
    }
  }'
```

### Richtlinienbindungen

Richtlinienbindungen verknüpfen eine Richtlinie mit einem bestimmten Ziel, damit die Engine weiß, wann sie angewendet werden soll. Jede Bindung enthält:

| Feld | Typ | Beschreibung |
| - | - | - |
| `policy_id` | string | Die ID der zu bindenden Richtlinie |
| `target_type` | string | `ISSUER`, `VERIFICATION_PROFILE` oder `TENANT_DEFAULT` |
| `target_id` | string | UUID des Ziels. Für `TENANT_DEFAULT` weglassen, um die Richtlinie auf alle Entitäten anzuwenden. |
| `action` | string | `MINT`, `VERIFY` oder `BUNDLE_EXPORT` |
| `priority` | integer | Bindungen mit höherer Priorität werden zuerst ausgewertet |

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

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies/bindings \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "policy_id": "pol_abc123",
    "target_type": "ISSUER",
    "target_id": "iss_def456",
    "action": "MINT",
    "priority": 100
  }'
```

Um eine Richtlinie als mandantenweiten Standard anzuwenden, setzen Sie `target_type` auf `TENANT_DEFAULT` und lassen Sie `target_id` weg:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies/bindings \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "policy_id": "pol_abc123",
    "target_type": "TENANT_DEFAULT",
    "action": "MINT",
    "priority": 10
  }'
```

> [!TIP]
>
> 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:

| Vorlage | Kategorie | Beschreibung |
| - | - | - |
| US-Gerichtsbarkeit zulassen | MINT | Nur Prägungen von US-amerikanischen Emittenten zulassen |
| Nur verifizierte Organisation | MINT | Erfordert `verified_org` Vertrauensstufe oder höher |
| Alle zulassen (Permissiv) | MINT | Alle Mints zulassen – mit Vorsicht verwenden |
| Verifizieren – nur USA & EU | VERIFY | Akzeptiert nur Verifizierungen aus US- oder EU-Gerichtsbarkeiten |

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.

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "US Issuers Only",
    "category": "MINT",
    "status": "ACTIVE",
    "description": "Restrict minting to US-based issuers",
    "language": "json_rules",
    "rules": {
      "rules": [
        {
          "id": "us_only",
          "description": "US jurisdiction required",
          "conditions": [
            { "field": "jurisdiction", "op": "eq", "value": "US" }
          ],
          "effect": "ALLOW"
        }
      ],
      "default_effect": "DENY"
    }
  }'
```

```json Response theme={null}
{
  "id": "pol_abc123",
  "name": "US Issuers Only",
  "category": "MINT",
  "status": "ACTIVE",
  "description": "Restrict minting to US-based issuers",
  "rules": { "..." },
  "version": 1,
  "created_at": "2026-03-31T10:00:00Z"
}
```

## Richtlinien auflisten

```bash theme={null}
curl https://api.truthlocks.com/v1/policies \
  -H "X-API-Key: tl_live_..."
```

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:

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies/evaluate \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "action": "MINT",
    "target_type": "ISSUER",
    "input": {
      "jurisdiction": "US",
      "trust_tier": "ENTERPRISE"
    }
  }'
```

```json Response theme={null}
{
  "allowed": true,
  "matched_rules": ["us_only"],
  "reasons": [],
  "decision_id": "dec_7f3a1b"
}
```

Die Antwort enthält vier Felder:

| Feld | Typ | Beschreibung |
| - | - | - |
| `allowed` | boolean | Ob die Anfrage alle aktiven Richtlinien bestanden hat |
| `matched_rules` | string\[] | IDs der Regeln, die mit der Eingabe übereinstimmten. Leer, wenn keine Regel übereinstimmte und der Standardeffekt angewendet wurde. |
| `reasons` | string\[] | Menschenlesbare Erklärung, wenn eine Anfrage abgelehnt wird. Immer ein leeres Array, wenn `allowed` `true` ist. |
| `decision_id` | string | Eindeutiger Bezeichner für diese Auswertung – verwenden Sie ihn, um den vollständigen Entscheidungsdatensatz im [Audit-Trail](https://docs.truthlocks.com/de/security/audit.md#policy-decision-audit-trail) nachzuschlagen. |

> [!NOTE]
>
> 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](#decision-audit-trail) aufgezeichnet – fragen Sie `resource_type=policy_decision` im [Audit-Log](https://docs.truthlocks.com/de/security/audit.md#policy-decision-audit-trail) ab, um es abzurufen.

Wenn keine Regel übereinstimmt, spiegelt die Antwort den `default_effect` wider:

```json theme={null}
{
  "allowed": false,
  "matched_rules": [],
  "reasons": ["Default policy effect: DENY"],
  "decision_id": "dec_9c2d4e"
}
```

## 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:

```bash theme={null}
curl "https://api.truthlocks.com/v1/audit/events?resource_type=policy_decision&resource_id=dec_7f3a1b" \
  -H "X-API-Key: tl_live_..."
```

Der Audit-Datensatz enthält Felder, die nicht Teil der Evaluate-API-Antwort sind, wie z. B. `evaluation_ms` und `input_hash`:

| Entscheidungsfeld | Beschreibung |
| - | - |
| `decision_id` | Eindeutige Kennung für diese Bewertung |
| `policy_id` | Die Richtlinie, die bewertet wurde |
| `policy_version` | Version der Richtlinie zum Zeitpunkt der Bewertung |
| `allowed` | Ob die Anfrage zugelassen wurde |
| `matched_rules` | Regel-IDs, die mit der Eingabe übereinstimmen |
| `evaluation_ms` | Zeitaufwand für die Bewertung in Millisekunden (nur Audit-Trail) |
| `input_hash` | SHA-256-Hash der Bewertungseingabe |

## 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:

```bash theme={null}
curl -X DELETE https://api.truthlocks.com/v1/policies/{id} \
  -H "X-API-Key: tl_live_..."
```

> [!WARNING]
>
> 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.

```json theme={null}
{
  "rules": [
    {
      "id": "block_individual",
      "description": "Block individual-tier issuers",
      "conditions": [
        { "field": "trust_tier", "op": "eq", "value": "individual" }
      ],
      "effect": "DENY"
    },
    {
      "id": "allow_us_eu",
      "description": "Allow US or EU jurisdictions",
      "conditions": [
        { "field": "jurisdiction", "op": "in", "value": ["US", "EU"] }
      ],
      "effect": "ALLOW"
    }
  ],
  "default_effect": "DENY"
}
```

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

> [card] [Policy Engine SDK](https://docs.truthlocks.com/policy.md)
>
> Richtlinien programmgesteuert mit dem SDK für benutzerdefinierte Integrationen auswerten.
> Szenarien.

> [card] [Policy API-Referenz](https://docs.truthlocks.com/api-reference/policies/create.md)
>
> Richtlinien über die REST-API erstellen, auflisten, auswerten und löschen.

> [card] [Compliance-Exporte](https://docs.truthlocks.com/guides/compliance-exports.md)
>
> Auditdaten in SOC 2-, GDPR- und HIPAA-Formaten für Compliance exportieren.
> Berichterstattung.

> [card] [Governance](https://docs.truthlocks.com/api-reference/governance/list-requests.md)
>
> Verwenden Sie Governance-Workflows für die Genehmigung und Statusänderungen des Ausstellers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.