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

# Richtlinie bewerten

> Simulieren Sie eine Richtlinienbewertung anhand einer Beispiel-Eingabe, um Regeln zu testen, bevor Sie sie durchsetzen.

Bewertet alle aktiven Richtlinien, die der angegebenen Aktion und dem Ziel entsprechen, anhand der bereitgestellten Eingabe. Verwenden Sie diesen Endpunkt, um zu testen, wie sich Ihre Richtlinien verhalten, bevor Sie sie in der Produktion aktivieren.

Die Antwort enthält, welche Regeln übereinstimmten, ob die Anfrage zugelassen würde, und eine `decision_id` für Audit-Trail-Abfragen.

> [!NOTE]
>
> Das Feld `reasons` wird nur zurückgegeben, wenn die Anfrage abgelehnt wird. Erlaubte Antworten geben ein leeres Array zurück. Wenn Sie sich zuvor für die Leistungsüberwachung auf `evaluation_ms` verlassen haben, wurde dieses Feld entfernt – fragen Sie stattdessen `resource_type=policy_decision` im Entscheidungs-Audit-Trail]\(/de/security/audit#policy-decision-audit-trail) ab.

> [!NOTE]
>
> Jede Bewertung wird im Audit-Protokoll mit einem SHA-256-Hash der Eingabe zur Manipulationssicherheit aufgezeichnet. Verwenden Sie die `decision_id`, um die Entscheidung in [Audit-Abfragen](https://docs.truthlocks.com/de/security/audit.md) nachzuschlagen.

### Antworten

### Antwortfelder

| Feld | Typ | Beschreibung |
| :- | :- | :- |
| `allowed` | boolean | Ob die Anfrage unter den aktuell aktiven Richtlinien zulässig wäre. |
| `matched_rules` | string\[] | IDs der Regeln, die mit der Eingabe übereinstimmten. Leer, wenn keine Regel übereinstimmte und der Standardeffekt angewendet wurde. |
| `reasons` | string\[] | Erklärung, warum die Anfrage abgelehnt wurde. 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. |


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/policies/evaluate
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks ist eine universelle Verifizierungsinfrastruktur für Dokumente,
    Anmeldeinformationen und digitale Assets.

    Diese Spezifikation definiert die kanonische API für die Interaktion mit
    Truthlocks-Diensten.


    ## Basis-URLs

    - **Produktion**: `https://api.truthlocks.com`

    - **Sandbox**: `https://sandbox-api.truthlocks.com`


    ## Authentifizierung

    - **API-Schlüssel**: Verwenden Sie den Header `X-API-Key` für
    Machine-to-Machine-Operationen

    - **Bearer Tokens**: Verwenden Sie `Authorization: Bearer <jwt>` für
    benutzerinitiierte Operationen


    ## Mandantenidentität

    In der Produktion wird die Mandantenidentität aus dem authentifizierten
    Kontext (API-Schlüssel oder JWT) abgeleitet.

    Der Header `X-Tenant-ID` wird in der Produktion ignoriert, um Spoofing zu
    verhindern.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: Produktions-API
  - url: https://sandbox-api.truthlocks.com
    description: Sandbox-Umgebung
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: API-Schlüssel- und Token-Verwaltung
  - name: Issuers
    description: Ausstellerregistrierung und Vertrauensmanagement
  - name: Keys
    description: Kryptographische Schlüsselverwaltung für Aussteller
  - name: Attestations
    description: Bestätigungslebenszyklus (prägen, widerrufen, ersetzen)
  - name: Verification
    description: Bestätigungsverifizierung und Proof-Bundles
  - name: Governance
    description: Aussteller-Governance-Workflows (nur Admin)
  - name: Identity
    description: Organisations-, Benutzer- und Rollenverwaltung
  - name: Audit
    description: Audit-Ereignisabfragen
  - name: Tenant Console
    description: Mandantenprofil- und Lebenszyklus-Endpunkte
  - name: Health
    description: Endpunkte für Dienststatus und Bereitschaft
  - name: Risk
    description: Erfassung von Risikosignalen und Betrugserkennung
  - name: Risk Enforcement
    description: >-
      Risikodurchsetzungsmaßnahmen – Blockieren, Herausfordern, Quarantäne und
      Konfiguration
  - name: Billing
    description: Verwaltung von Abrechnung, Abonnements und Add-ons
  - name: Machine Identity
    description: >-
      Machine Agent Identity Protocol (MAIP) – Agentenregistrierung, Sitzungen,
      Vertrauen, Zeugen, Compliance, Orchestrierung und Beobachtbarkeit
externalDocs:
  description: Transparenz-API nur lesend (separate Dienstspezifikation)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/policies/evaluate:
    post:
      tags:
        - Policies
      summary: Richtlinien bewerten
      description: >-
        Bewertet alle aktiven Richtlinien anhand einer bestimmten Aktion und
        eines Kontexts.
      operationId: policies.evaluate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                action:
                  type: string
                input:
                  additionalProperties: {}
                  type: object
                target_id:
                  format: uuid
                  nullable: true
                  type: string
                target_type:
                  type: string
              type: object
      responses:
        '200':
          description: Evaluationsergebnis
          content:
            application/json:
              schema:
                type: object
                properties:
                  decision:
                    type: string
                    enum:
                      - ALLOW
                      - DENY
                  matched_policy:
                    nullable: true
                    type: string
                  matched_rule:
                    nullable: true
                    type: string
                  reason:
                    type: string
        '401':
          description: Authentifizierung erforderlich
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Maschinenlesbarer Fehlercode
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Menschenlesbare Fehlermeldung
        http_status:
          type: integer
          description: HTTP-Statuscode
        retry_after_ms:
          type: integer
          description: >-
            Millisekunden, die vor einem erneuten Versuch gewartet werden sollen
            (für Ratenbegrenzungen)
        details:
          type: object
          description: Zusätzlicher Fehlerkontext
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT für benutzerinitiierte Operationen

````

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