Anslut som förlitande part
Roll: Denna guide riktar sig till förlitande parter (Relying Parties) som vill ansluta sina tjänster till det svenska plånbokssystemet. En förlitande part är den organisation eller tjänst som tar emot och verifierar digitala intyg från användarens plånbok.
Obs: Denna anslutningsguide avser Diggs plånboksapp som använder sig av Testplattform för digital identitetsplånbok för test och utveckling.
Krav
- OpenID4VP-stöd: Er tjänst följer OpenID4VP (se vad vår app stödjer under Stöd för OpenID4VP).
- Åtkomstcertifikat och registreringscertifikat från Digg: Verifieraren behöver ett åtkomstcertifikat för att signera förfrågningar och ett registreringscertifikat att skicka med i dem.
- Nätverksåtkomst: Åtkomst till Testplattform för digital identitetsplånbok (publik på internet) från app och telefon.
- Betrodd HTTPS-domän: Trafik mellan telefonen och er verifierare måste gå via en av android/ios betrodd
HTTPS-domän.
- Plånboksappen kräver strikt HTTPS (
https://) för alla presentationsadresser (request_uriochDirectPost). Okrypteradhttp://avvisas av säkerhetsskäl av appen.
- Plånboksappen kräver strikt HTTPS (
- Tillit till LoTE: Verifieraren behöver lita på testplattformens tillitslista (List of Trusted Entities, se även Tillitsramverk & Tillitslistor).
- Vitlistning I dagsläget har diggs plånbok ingen vitlista för betrodda tjänster utan litar på alla.
Hämta och konfigurera certifikat
Digg tillhandahåller publikt certifikatmaterial för anslutning till testplattformen. De CA:er som utfärdar materialet är betrodda via testplattformens LoTE.
-
Hämta och konfigurera åtkomstcertifikatet: Ladda ned .p12-filen. Den innehåller åtkomstcertifikat, privat nyckel och certifikatkedja. Lösenordet är
abcd1234. Använd nyckeln för att signera OpenID4VP-förfrågningar.Sätt förfrågans
client_idtillx509_hash:<certifikathash>. Beräkna hashen från lövcertifikatet i förfrågansx5c-header med SHA-256 över DER-formatet, kodat som base64url utan utfyllnad (=). Se kommandon i exemplets steg 2. Värdet behöver bara beräknas om när åtkomstcertifikatet byts ut. - Hämta och konfigurera registreringscertifikatet: Ladda ned
registreringscertifikatet som signerad JWT.
Lägg JWT-strängen oförändrad i
datai ett objekt i förfrågansverifier_info-array, medformatsatt tillregistration_cert. Se Verifier Info i OpenID4VP. - Konfigurera den publika HTTPS-adressen: Ange verifierarens publika adress så att plånboksappen kan hämta förfrågningar och skicka presentationer dit. Adressen behöver ett betrott HTTPS-certifikat. Åtkomstcertifikatet används för signering och ersätter inte HTTPS-certifikatet.
Det publika materialet är tillfälligt. Framöver behöver ni beställa åtkomst- och registreringscertifikat för er egen organisation även för testplattformen.
Testa med plånboksappen
- Installera testappen och hämta PID:
- Följ Guiden för att prova plånboksappen för att installera appen på din telefon.
- Öppna appen, välj Hämta personuppgifter, logga in mot utfärdaren med en testanvändare och spara ditt test-PID.
- Starta presentation i er tjänst:
- Gå till er tjänst i en webbläsare och starta ett presentationsflöde.
- Skanna QR-koden eller öppna OpenID4VP-länken i telefonen för att öppna Diggs plånboksapp.
- Granska de begärda uppgifterna i appen och tryck Godkänn / Skicka.
- Verifierarens callback tar emot presentationen och uppgifterna verifieras.
Support och fördjupning
Kontakt
För tekniska frågor och hjälp med anslutningsprocessen och testmiljön, kontakta: digitalwallet@digg.se
Dokumentation och specifikationer
För en djupare förståelse av plånbokssystemet:
- Exempel på en lokal uppsättning: Anslut som förlitande part med exempel
- Huvudprojekt: diggsweden/wallet-ecosystem
- Tekniska standarder: Standarder & Profiler (OpenID4VP, OpenID4VCI, SD-JWT VC).
- EUDIW-dokumentation: eudi-doc-architecture-and-reference-framework