Hva som kommer i tillegg til OpenID4VP
En vanlig presentasjon deler bevis. En forsegling må i tillegg beskrive dokumentene, vise dem til brukeren, kontrollere hashene, gjennomføre eSeal-operasjonen og levere resultatet til riktig mottaker.
transaction_data bærer denne konteksten. Hvert element er base64url-enkodet JSON og må knyttes til et bevis gjennom credential_ids.
OpenID4VP 1.0 standardiserer den generelle bindingen. Kjernen definerer type og credential_ids, og SD-JWT VC-profilen beskriver transaction_data_hashes. Typeverdien qes_authorization og feltene documentDigests, transaction_id og dispatch er del av Symfonis integrasjonsprofil. De skal ikke presenteres som universelle OpenID4VP-felt eller som bevis på et kvalifisert nivå.
Bindingene som må holde
credential_idsviser til forespurte virksomhetsbevis.nonceer unik for forespørselen og hindrer gjenbruk.- Hver
documentDigesthar en stabilid, PDF-kilde og SHA-256-hash. transaction_idknytter leveransen til mottakerens sak.dispatch.urlog engangstoken bestemmer hvor resultatet kan leveres.- Leveringsorigin må være knyttet til forespørselen eller godkjent på forhånd.
transaction_data_hashesi SD-JWT VC-ens Key Binding JWT må stemme med de kodede verdiene mottakeren sendte.
Leveringskontrakten
Symfoni sender en multipart/form-data-leveranse per transaction_data-element. Ved nettverksfeil kan samme leveranse sendes flere ganger med samme Idempotency-Key. Mottakeren må lagre nøkkelen og resultatet atomisk, returnere samme kvittering ved gjenlevering og ikke utføre saken på nytt. Tokenet må kunne bekrefte en slik gjenlevering også etter første vellykkede mottak. Manifestet navngir alle dokumentdelene. Mottakeren må behandle leveransen atomisk: Ikke marker saken som fullført dersom én dokumentdel mangler.
Mottakeren må også validere presentasjonen og kontrollere transaction_data_hashes før leveransen og beviset behandles som samme autoriserte transaksjon.
Redirects følges ikke. Responskroppen fra et mislykket mottak eksponeres heller ikke videre, fordi den kan inneholde sensitiv informasjon.
Varig status og gjenoppretting
Walleten journalfører hvert dokument før QTSP-kallet. Mottatte signaturer lagres med en gang, også når et senere dokument i samme forespørsel feiler. Et avbrutt QTSP-kall har status unknown og gjentas aldri automatisk. Operatøren må avklare resultatet hos QTSP med ExternalRef (requestId:transactionId:documentId) før en ny signering vurderes. En slik referanse gir korrelasjon; den er ingen garanti for at QTSP tilbyr idempotens.
Bare levering av allerede lagrede signaturer gjentas automatisk. Presentasjonen gjentas ikke automatisk når den første dokumentleveransen feiler. Mottakeren må fortsatt kreve en gyldig presentasjon før saken fullføres. Status kan leses av en innlogget bruker i eierwalleten via GET /app/credential/verify/signing-status?requestId=....
Forhåndsvisning og signering bruker samme transport med kontroll av DNS også ved socket-tilkobling. Grensene er ti dokumenter og 30 MiB totalt per forespørsel, og 15 MiB per dokument. Dokumenter lastes sekvensielt.
Serverkonfigurasjon
SIGNANT_ESEAL_WALLET_CERTIFICATES er et JSON-objekt med wallet-ID som nøkkel, for eksempel {"wallet-id":{"certificateName":"VIRKSOMHET A","certificateSubject":"Org 123456789"}}. Bare serverens konfigurasjon kan gi en wallet tilgang til et sertifikat. Driftsansvarlig må kontrollere sertifikatets virksomhet og fullmakten ved konfigurering. Produksjon avviser wallets uten binding.
Den gamle globale sertifikatkonfigurasjonen kan bare brukes med SIGNANT_ESEAL_ALLOW_GLOBAL_SANDBOX_CERTIFICATE=true i eksplisitt development/test-miljø. QTSP-endepunkt, distributor-ID og tilgangskode konfigureres fortsatt med de eksisterende SIGNANT_ESEAL_*-variablene.
Den krypterte signeringsjournalen ligger i SYMFONI_SIGNING_DB_PATH, som normalt er app-databasens filsti med .signing som suffiks. Den må ligge på varig disk og inngå i SQLite-konsistent sikkerhetskopiering. Journalen krever WALLET_ACTION_ENCRYPTION_KEY (32 tilfeldige byte, base64url) og bruker WALLET_ACTION_ENCRYPTION_KEY_VERSION (standard 1). Sikkerhetskopier nøkkelen separat. Bytte av nøkkel eller versjon uten migrering gjør tidligere journaldata utilgjengelige.
Sikkerhetsspørsmål
Test minst gjenbrukt nonce, feil dokumenthash, ukjent dokumentorigin, manglende Bearer-token, duplisert dokument-id og avvist leveranse. Kontroller også at brukeren ser virksomhet, dokumentnavn og handling før godkjenning.
Se den konkrete Symfoni-guiden for eksempelpayload.