Changelog

Alle noemenswaardige wijzigingen in de Audact Platform API zijn in dit bestand gedocumenteerd.

[Unreleased]

⚠️ Brekend — C2PA-manifesten zijn nu echt ondertekend (generator 2.0.0)

• Verwijderd C2PAManifest.signature (de HMAC hex). Het manifest is nu een echte C2PA 2.x content credential: een .c2pa JUMBF-manifestopslag waarvan de claim is ondertekend met ES256 (COSE, ECDSA P-256) met een X.509-certificaatketen, hard gebonden (c2pa.hash.data) aan de gespreksopname, of — wanneer er geen opname is — aan de ondertekende Article 50 JSON-export van het gesprek. signature_algorithm is "ES256". Alles dat .signature las, moet de manifestopslag en het activum downloaden en verifiëren met c2patool <asset> --external-manifest <file>.c2pa.

• Nieuwe velden op de POST /v1/calls/{call_id}/c2pa-samenvatting: manifest_id; asset (kind recording|evidence_export, media_type, sha256, url); manifest_store (media_type application/c2pa, sha256, url); signing_credential (subject, issuer, serial, not_before, not_after, fingerprint_sha256, trust self_signed|ca_issued). De url-velden zijn relatieve API-paden die hetzelfde Bearer-token vereisen — het zijn geen presigned URL's. assertions krijgt c2pa.hash.data na com.audact.compliance en c2pa.actions.

• Nieuwe eindpunten:

  • GET /v1/calls/{call_id}/c2pa — geeft de manifesten van een gesprek weer, nieuwste eerst (listC2PAManifests). Items zijn een subset van de POST-samenvatting (geen claim/assertions; alleen vingerafdruk/vertrouwen van de ondertekener).
  • GET /v1/calls/{call_id}/c2pa/{manifest_id}/manifest.c2pa — de opgeslagen manifestopslag, gestreamd als 200 application/c2pa (getC2PAManifestStore).
  • GET /v1/calls/{call_id}/c2pa/{manifest_id}/asset — het gebonden activum (getC2PAAsset): evidence_export-activa worden gestreamd als 200; recording-activa antwoorden met 302 naar een presigned S3 URL die 15 minuten geldig is (ophalen zonder Authorization-header). Een opname die na uitgifte is verwijderd, geeft 410 c2pa_artefact_gone.
  • GET /v1/c2pa/trust-anchor — publiek; de zelfondertekende root bovenaan de huidige ondertekeningsketen (Audact's root zolang zelfondertekend, de root van de CA na het importeren van een CA-keten) (getC2PATrustAnchor).

• POST /v1/calls/{call_id}/c2pa geeft bij elke aanroep een nieuwe credential uit en voegt een C2PA_MANIFEST_ISSUED-gebeurtenis toe aan de (alleen-toevoegen) bewijsketen van het gesprek. Stuur een Idempotency-Key-header zodat herhalingen de oorspronkelijke respons teruggeven.

• Fouten: 503 c2pa_signing_unavailable (geen ondertekeningscredential — er is geen fallback), 503 c2pa_storage_unavailable, 404 voor een onbekend of een gesprek/manifest van een andere tenant (identiek), 410 c2pa_artefact_gone, 400 voor een onjuist gevormde lijstcursor.

• Bijlage, niet ingebed: de .c2pa-opslag wordt naast het activum in S3 opgeslagen en apart gedownload. Uitgifte staat niet op het Validator-pad.

• Verificatie: download activum + .c2pa, vervolgens c2patool <asset> --external-manifest <file>.c2pa, optioneel gevolgd door trust --trust_anchors <pem> met de PEM van GET /v1/c2pa/trust-anchor. Verificatie vereist geen API-toegang na het downloaden.

• Geldigheid gekoppeld aan het ondertekeningscertificaat: RFC 3161-tijdstempels zijn nog niet opgenomen, zodat een manifest alleen wordt geverifieerd zolang het ondertekeningscertificaat geldig is. Er is in deze release geen intrekkingsmechanisme (geen CRL/OCSP).