„Cum mă conectez?”

Întrebarea corectă — iată răspunsul, cu endpoint-uri reale. Trei fluxuri acoperă aproape orice integrare.

Documentația de integrare Cere acces la API

OID4VPOID4VCIDCQLOIDC ISO 18013-5 / -7SD-JWT VC

Referința autoritativă: documentația de integrare de mai sus. Specificația OpenAPI și endpoint-urile de mai jos se dau părților utilizatoare înregistrate — cere-ne acces.

Fluxul 1 · cel mai frecvent

Verifică un credential (OID4VP)

Serviciul tău cere atribute; utilizatorul aprobă în portofel; primești claim-uri verificate criptografic.

# 1. Create a presentation request — pick exactly the claims you need
GET /verifier/vp/request/?fields=family_name,given_name,age_over_18

# Response:
{
  "qr_uri":       "mdoc-openid4vp://…",   // show as QR (cross-device)
  "request_uri":  "…",                     // signed Request Object (JAR)
  "state":        "…",                     // your session handle
  "dcql_query":   { … }                    // what was asked, DCQL
}

# 2. The wallet fetches the signed request, the user consents.
# 3. Poll the session by `state` until it completes — you get the verdict
#    (issuer signature, device binding, revocation) and the claims as JSON.

Parametri utili: doctype= (cere un tip anume de credential), credential_format=sd_jwt_vc (SD-JWT VC în loc de mdoc), profile=final / haip (versiunea de protocol OID4VP: 1.0 Final / HAIP).

Fluxul 2 · zero cunoștințe de protocol

Puntea OpenID Connect (SIOP v2)

Vorbești deja OIDC? Atunci vorbești deja EUDI. Puntea transformă o prezentare din portofel într-un flux standard authorization-code.

# Exactly what your OIDC library does today:
GET /oidc/authorize?client_id=…&scope=openid+identity&redirect_uri=…&state=…

# … user approves in the wallet …

POST /oidc/token          // code → tokens, standard
GET  /oidc/userinfo       // verified claims, standard shape

# Scopes select the attribute set: `identity`, `age_over_18`, and more —
# see the integration docs for the full scope catalogue.

Documentația punții OIDC →

Fluxul 3 · emitenți

Emite credențiale (OID4VCI)

OID4VCI standard: orice portofel conform îți poate înrola credențialele — inclusiv al nostru, dar niciodată obligatoriu.

# Discovery — everything a wallet needs to enrol:
GET /api/vci/.well-known/openid-credential-issuer

# Issue: create a credential offer for your subject, render it as a QR —
# the wallet does the rest (token, proof of possession, credential).
# Pre-authorized code and authorization code grants both supported;
# formats: mso_mdoc, dc+sd-jwt, jwt_vc_json, BBS+.

Proximitate

Față în față, fără internet

ISO/IEC 18013-5 device retrieval: aplicația ForTrust Verifier citește credențiale prin BLE și NFC, cu ancore de încredere și liste de status ținute local — engagement prin QR sau atingere NFC. Pentru puncte de verificare cu sau fără operator, unde conectivitatea nu e garantată.

Testare de interoperabilitate

Testează cu noi înainte să lansezi

Partenerii primesc acces la laboratorul nostru de interoperabilitate: rulări scriptate de emitere/prezentare, alegerea versiunii de protocol (pre-Final, Final, HAIP) și evidență înregistrată pentru fiecare rulare. Vii cu walletul sau verificatorul tău — pleci cu un raport.

Cere acces la laborator →