Żviluppaturi · OpenID Connect · OpenID4VP · ARF 3.0
Dħul bil-Kartiera tal-UE għas-sit tiegħek – gwida għall-iżviluppaturi
L-applikazzjoni tiegħek iżżomm id-dħul normali tagħha b’OpenID Connect. Is-CodeB EUDI Gateway fuq phone.codeb.io jitkellem OpenID4VP, SD-JWT VC u ISO mdoc mal-kartiera, jiċċekkja l-preżentazzjoni u jagħtik id_token iffirmat. Iżżid parametru wieħed u verifika waħda.
- Kwalunkwe librerija OpenID Connect
- Parametru wieħed, verifika waħda
- Eżempji ttestjati għal seba’ pjattaformi
Kif jaħdem
- L-app tiegħek tibgħat lil CodeB b’client_id, PKCE (S256), state, nonce u
acr_values=urn:codeb:acr:eudi-wallet. - CodeB tiftaħ id-dħul bil-kartiera: fuq mowbajl il-kartiera tinfetaħ direttament; fuq kompjuter il-persuna tiskennja kodiċi QR bil-mowbajl li fih il-kartiera.
- Il-kartiera tippreżenta, CodeB tiċċekkja permezz ta’ OpenID4VP: il-firma u l-katina ta’ fiduċja tal-emittent, ir-rabta mal-apparat u l-istatus ta’ revoka.
- CodeB tirritorna kodiċi ta’ awtorizzazzjoni lir-redirect URI tiegħek.
- Is-server tiegħek jibdel il-kodiċi, jivvalida l-id_token u jiċċekkja l-claim
acr. Il-persuna tkun daħlet.
Iż-żewġ regoli
1. Itlob il-kartiera: żid acr_values=urn:codeb:acr:eudi-wallet mat-talba ta’ awtorizzazzjoni.
2. Iċċekkja qabel tagħti aċċess: il-claim acr tal-id_token ivvalidat irid ikun urn:codeb:acr:eudi-wallet jew urn:codeb:acr:eudi-wallet-linked. Dħul bil-password għandu valur ieħor u għandu jiġi rifjutat.
X’għandek bżonn
Klijent irreġistrat: CodeB tirreġistra r-redirect URIs tiegħek u tibagħtlek client ID u secret (info@aloaha.com). Ismek, l-iskop u l-politika tal-privatezza tiegħek imorru fiċ-ċertifikat ta’ reġistrazzjoni li turi l-kartiera.
Id-dokument tad-discovery: https://phone.aloaha.com/.well-known/openid-configuration għall-integrazzjoni vera tiegħek – l-endpoints tal-awtorizzazzjoni, tat-token, UserInfo u JWKS, l-iscopes, il-claims u l-valuri acr appoġġjati. Għat-testijiet u d-demos: phone.codeb.io.
Komponent fuq is-server li jżomm is-client secret (authorization code flow b’PKCE).
Eżempji ttestjati u referenzi
Apps ta’ eżempju sħaħ għal ASP.NET Core 8, Visual Basic .NET, Node.js, Python, PHP, Java u Go, kull waħda ttestjata ma’ fornitur li jirrifletti l-endpoints ta’ CodeB: gwida tal-integrazzjoni. Bidu iqsar: quickstart għall-iżviluppaturi. Visual Basic .NET: eżempju.
Referenza tal-API: API tal-kartiera tal-UE u d-deskrizzjoni OpenAPI.
Għad m’għandekx backend? Il-widget tad-dħul ipoġġi buttuna “Idħol bil-Kartiera tal-UE” fuq paġna b’tag tal-iskript wieħed.
Aktar minn dħul
L-età biss: staqsi “aktar minn 18” u xejn aktar – verifika tal-età.
Karta eID nazzjonali: l-istess integrazzjoni b’acr_values=urn:codeb:acr:eidcard – dħul biċ-ċavetta ta’ awtentikazzjoni tal-karta, moqrija bl-NFC minn CodeB Wallet.
Ittestja kull kartiera: it-test tal-interoperabbiltà juri liema rekwiżiti tissodisfa kartiera. Ipprova l-proċessi fil-playground.
Imfassal biex isegwi l-ARF 3.0, OpenID4VP 1.0 u HAIP 1.0; mhux iċċertifikat.
Mistoqsijiet mill-iżviluppaturi
Għandna nimplimentaw OpenID4VP, SD-JWT VC jew ISO mdoc aħna stess?
Le. Il-gateway jitkellem il-protokolli tal-kartiera u jiċċekkja l-firem, il-ktajjen ta’ fiduċja, ir-rabta mal-apparat u r-revoka. L-applikazzjoni tiegħek tara dħul standard b’OpenID Connect.
Liema librerija OpenID Connect nistgħu nużaw?
Kwalunkwe librerija li tappoġġja l-authorization code flow b’PKCE u taqra d-dokument tad-discovery. Hemm eżempji ttestjati għal ASP.NET Core, Visual Basic .NET, Node.js, Python, PHP, Java u Go.
Kif nafu li l-persuna verament użat il-kartiera?
Mill-claim acr tal-id_token ivvalidat: urn:codeb:acr:eudi-wallet jew urn:codeb:acr:eudi-wallet-linked. Irrifjuta kull valur ieħor għall-paġni li jeħtieġu l-kartiera.
Liema dejta personali nirċievu?
Biss dak li titlob, dak li l-klijent tiegħek jista’ jirċievi u dak li l-persuna tapprova fil-kartiera – pereżempju l-isem jew id-data tat-twelid.