Ż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.
Ittestjat skont l-istandards
Xi jfisser dan? L-emittent ta’ CodeB huwa s-servizz li jpoġġi l-karti fil-wallet tiegħek – l-identità diġitali tiegħek, karti ta’ sħubija u ta’ dħul. Il-verifikatur huwa s-servizz li jiċċekkja dawk il-karti meta tidħol bihom. Biex emittenti, wallets u servizzi madwar l-Ewropa jifhmu lil xulxin, kollha jridu jsegwu l-istess regoli – bħal plakka u sokit: jekk naħa waħda tinbena b’mod differenti, xejn ma jaqbel.
Dan eżatt huwa dak li jiċċekkja l-laboratorju uffiċjali tat-test. Jilgħab ir-rwol ta’ wallet u jħaddem aktar minn 250 test kontra s-servizz veru tagħna – jekk kull pass isegwix ir-regoli, u jekk talbiet iffalsifikati, imbagħbsa jew ripetuti jiġux rifjutati. F’Novembru 2026 l-emittent tagħna għadda mill-erba’ pjanijiet tat-test għall-ħruġ tal-karti, u l-verifikatur tagħna miż-żewġ pjanijiet għall-verifika tagħhom, mingħajr ebda test fallut.
Aħna kburin b’dan. Juri kemm jiswew aktar minn 20 sena ta’ żvilupp fil-PDF, fil-karti intelliġenti u fl-identità diġitali – u li dejjem nibnu strettament skont l-istandards: meta r-regoli jiġu segwiti mill-ewwel linja, it-testijiet jikkonfermawh.
Għalik dan ifisser: il-karti tiegħek jitkellmu l-istess lingwa bħal kull wallet u servizz li jsegwi r-regoli Ewropej, minflok ma jkunu marbuta ma’ app waħda, u l-protezzjoni tagħhom hija ttestjata, mhux biss imwiegħda. Liema karti jaċċetta wallet jew servizz għadu jiġi deċiż miċ-ċertifikati u mil-listi ta’ fiduċja.
Teknikament: OpenID4VCI 1.0 u OpenID4VP 1.0 bil-profil HAIP 1.0 – l-istandards li fuqhom huma mibnija l-wallets EUDI. Il-pjanijiet tat-test huma l-istess suites indipendenti tat-test li jintużaw għaċ-ċertifikazzjoni uffiċjali ta’ dawn il-protokolli. Dawn huma testijiet tas-servers tagħna fuq phone.codeb.io, mhux ċertifikazzjoni ta’ CodeB Wallet innifisha. Kull riżultat jista’ jinqara biss permezz tal-link tiegħu.
| Pjan tat-test | Format | Riżultat |
|---|---|---|
| Emittent: OpenID4VCI 1.0 + HAIP 1.0, mibdi mill-wallet | SD-JWT VC | Għadda · 63 testijiet, l-ebda falliment · ara r-riżultati |
| Emittent: OpenID4VCI 1.0 + HAIP 1.0, mibdi mill-wallet | mdoc | Għadda · 63 testijiet, l-ebda falliment · ara r-riżultati |
| Emittent: OpenID4VCI 1.0 + HAIP 1.0, mibdi mill-emittent (offerta ta’ credential) | SD-JWT VC | Għadda · 63 testijiet, l-ebda falliment · ara r-riżultati |
| Emittent: OpenID4VCI 1.0 + HAIP 1.0, mibdi mill-emittent (offerta ta’ credential) | mdoc | Għadda · 63 testijiet, l-ebda falliment · ara r-riżultati |
| Verifikatur: OpenID4VP 1.0 + HAIP 1.0, direct_post.jwt | SD-JWT VC | Għadda · 14 testijiet, l-ebda falliment · ara r-riżultati |
| Verifikatur: OpenID4VP 1.0 + HAIP 1.0, direct_post.jwt | mdoc | Għadda · 7 testijiet, l-ebda falliment · ara r-riżultati |
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.