Verifizierbare Dokumente per API ausstellen.

Wie es in der Praxis funktioniert

1. Dokument erzeugen (wie heute)
   z. B. PDF aus SAP/ERP, DMS oder einem Portal. Wichtig: Die Datei muss „final“ sein.
2. Hash berechnen
   Der Aussteller berechnet serverseitig den SHA-256 Fingerprint der finalen Datei.
3. Verifikationsdatensatz per API anlegen
   Authena erzeugt eine Verifikations-ID + Link/QR-URL für das Dokument (ohne Upload).
4. Link/QR ins Dokument einbetten
   Der Empfänger kann das Dokument weiterleiten. Dritte prüfen per Link (Provenienz) und optional per Datei-Upload (Integrität).

Typische Use Cases

API (Developer)

Für Piloten starten wir pragmatisch mit API Keys (Bearer Token). Später sind OAuth/mTLS möglich.

1) Verifikationsdatensatz anlegen

Der Aussteller berechnet den Hash der finalen Datei und sendet Metadaten. Response enthält Verifikationslink.

POST /api/manifest
  Authorization: Bearer <API_KEY>
  Content-Type: application/json
  
  {
    "manifest": {
      "ver": 1,
      "alg": "ed25519",
      "creator_handle": "bank_xyz",
      "creator_id": "uuid-of-issuer",
      "file": {
        "name": "kontoauszug.pdf",
        "size": 123456,
        "mime": "application/pdf",
        "sha256_b64": "<BASE64_SHA256>"
      },
      "created_at": "2026-02-15T12:34:56.000Z"
    },
    "payload_b64": "<BASE64_CANONICAL_JSON>",
    "signature_b64": "<BASE64_SIGNATURE>",
    "creator_public_key_b64": "<BASE64_PUBLIC_KEY>"
  }

{
    "ok": true,
    "id": "e3b8...-uuid",
    "verify_url": "https://authena-media.com/verify/e3b8...-uuid"
  }

2) Provenienz prüfen (ohne Upload)

GET /api/verify-provenance?id=<uuid>
  
  => zeigt Aussteller, Zeitstempel und erwarteten Hash

3) Integrität prüfen (mit Upload)

In der Verifier-UI wird der Hash im Browser berechnet. An die API geht nur der Hash (nicht die Datei).

POST /api/verify-integrity
  Content-Type: application/json
  
  {
    "id": "<uuid>",
    "file_sha256_b64": "<BASE64_SHA256>"
  }
  
  => { ok, provOK, intOK }