Åpne diagrammet i full størrelse.
1. Bygg forespørselen
Nye integrasjoner bør bruke OpenID4VP 1.0 med DCQL. Sett minst:
- et stabilt
client_idmed riktig tillitsbinding response_mode=direct_post- offentlig
response_uri - fersk, tilfeldig
nonce - ugjennomsiktig
statesom identifiserer mottakerens transaksjon - en DCQL-spørring som bare ber om nødvendige bevis og felt
Symfoni kan lese Presentation Exchange for kompatibilitet med eldre OpenID4VP-utkast. Ikke velg dette for en ny 1.0-integrasjon.
2. Åpne Symfoni
Bruk enten en URL til request object:
https://www.symfoni.dev/app/credential/verify?request_uri=https%3A%2F%2Fverifier.example.com%2Fpar%2Fxyz eller et kompakt, signert request object:
https://www.symfoni.dev/app/credential/verify?authorization_request=eyJhbGciOi... request_uri kan hentes med GET eller POST. Velg metoden mottakeren annonserer og test utløp og gjenbruk.
3. Motta svaret
Ved suksess sender Symfoni form-post til response_uri med vp_token og state når det var med i forespørselen. Eldre Presentation Exchange-flyter har i tillegg presentation_submission.
Ved avslag eller protokollfeil sender Symfoni error, error_description og tilhørende state når callbacken er tilgjengelig.
4. Valider før bruk
Mottakeren må minst:
- finne aktiv transaksjon fra
state - kontrollere
nonce, målgruppe og request-binding - validere presentasjonens signatur og holder-binding
- godta riktig utsteder og sertifikatkjede
- kontrollere gyldighet og eventuell tilbakekalling
- kontrollere at format, bevis og felter oppfyller DCQL-spørringen
Logg et kontrollresultat med korrelasjonsnøkkel. Ikke logg rått vp_token uten et dokumentert behov og riktig beskyttelse.
Vanlige feil
- callbacken er ikke offentlig tilgjengelig eller godtar ikke form-post
stateer ukjent eller allerede brukt- forespørselen ber om felt som ikke finnes i beviset
- tillitskjeden eller request-signaturen kan ikke valideres
- mottakeren antar at et teknisk gyldig bevis automatisk er tilstrekkelig for vedtaket
Mottak gjennom Symfonis server-API
For integrasjoner opprettet i /app/mottak håndterer Symfoni verifikasjonen.
Kundens backend bruker /api/integrations/v1/sessions med egen API-nøkkel.
Dette er en annen leveringsmåte enn mottakerens egen OpenID4VP-callback ovenfor.
Endret oppbevaringskontrakt: Verifiserte felt kan hentes i 15 minutter fra
faktisk verifiedAt. Responsens resultExpiresAt angir fristen. Etter fristen
beholdes receipt.status=verified, men receipt.result fjernes og
receipt.resultExpired=true. Et resultat som ikke ble vurdert mot den aktuelle
integrasjonens policy innen fristen, gir expired, ikke en ny bekreftelse av
verifikasjon.
Symfoni rydder feltverdier og råpresentasjoner automatisk i aktive lagre, også uten polling. Minimale status- og idempotensposter beholdes i 24 timer etter avslutning; deretter gir oppslag HTTP 404. Ny deling krever en ny Idempotency-Key. Mottakeren må selv begrunne og begrense eventuell egen lagring. Sikkerhetskopier har separate oppbevaringsfrister; resultatfristen er ikke et løfte om fysisk sletting fra alle sikkerhetskopier etter 15 minutter.
Eksporter oppdaterte integrasjonsinstruksjoner fra mottaksoppsettet før aktivering. Denne endringen gjelder mottak/verifikasjon. Brregs EBWOID-/EUCC- utstedelses-API og walletens lagrede bevis endres ikke.