Kontekst

ADR-0006 rəqəmsal sənəd (credential)Sənədi verən qurum tərəfindən imzalanan və şəxsin rəqəmsal cüzdanında saxlanan rəqəmsal sənəd; şəxs yalnız soruşulan sahələri göstərir. formatı kimi SD-JWT VC (Selective Disclosure JWT Verifiable Credential)Seçici paylaşım (selective disclosure) imkanı olan JSON əsaslı rəqəmsal sənəd formatı, EUDI Wallet-da və Tamga-da onlayn təqdimat üçün istifadə olunur — burada rəqəmsal cüzdan istifadə olunur. seçimini etdi; bütün rəqəmsal sənədlərimiz (tələbə, diplom, şəxsiyyət, bilet) bu formatdadır. ADR-0011 Tamga müvəqqəti şəxsiyyət attestationŞəxs və ya əşya haqqında imzalanmış və rəqəmsal cüzdanda daşınan bəyanat, məsələn tələbə sənədi və ya diplom. (urn:tamga:id:IdentityAttestation:1) tipini müəyyən etdi — yenə SD-JWT VC. SPEC-CRED-0001 §1 mdocCBOR-da kodlaşdırılmış ISO/IEC 18013-5 mobil sənəd formatı; üzbəüz təqdimetmə və mobil sürücülük vəsiqəsi üçün istifadə olunur. formatını əvvəldən ikinci dərəcəli format ("2-ci faza") kimi planlaşdırmışdı; bu ADR onu şəxsiyyət sənədi üçün önə çəkir (bağlanmış qərarı dəyişmir, planlaşdırılanı aktivləşdirir).

İki xarici reallıq bizi ikinci formata yönəldir:

1. Brauzer Digital Credentials API-si. Chrome 141 OpenID4VP + həm SD-JWT VC, həm də mdoc qəbul edir; Safari 26 / iOS 26 yalnız mdoc qəbul edir. "Tamga ilə daxil ol" (D11) brauzer API-sinə keçdikdə iPhone Safari istifadəçiləri üçün mdoc mütləqdir.
2. eIDAS 2.0 / ARF. ARF (Architecture and Reference Framework)Rolları, arxitekturanı, etibar modelini və qaydaları təsvir edən sənədlər toplusu. Tamga ARF Aİ ARF-nin strukturunu izləyir. fərdi şəxsiyyət məlumatları (PID (Person Identification Data)Dövlətin ən yüksək təminat səviyyəsində verdiyi əsas şəxsiyyət məlumatları. Tamga bu rolu öz üzərinə götürmür; onun şəxsiyyət sənədi PID deyil.) üçün mdoc-u (ISO 18013-5) məcburi, SD-JWT VC-ni isə opsional sayır. Yaxın məsafədən təqdimat (turniket, qapı — ADR-0012 Faza 1 Bluetooth) da ISO 18013-5 mdoc daşıyır. Tamga PID vermir, lakin şəxsiyyət attestasiyası PID-in müvəqqəti ekvivalentidir; Aİ presedenti ilə uyğunlaşmaq üçün mdoc lazımdır.

Layihə rəhbərliyinin istiqaməti (2026-09-26): turniket və bilet axınları EUDI ilə eyni olsun; mdoc formatı qurulur. mdoc formatın özüdür (CBOR + COSE); Bluetooth nəqli ayrıdır və Apple Developer hesabı + native modul tələb edir (Faza 1). Bu ADR yalnız formatı əhatə edir; nəqli ADR-0012 Faza 1-dədir.

Qərar

1. Şəxsiyyət attestasiyası ikili formatda verilir: SD-JWT VC (əsas, dəyişməz) + ISO 18013-5 mdoc (paralel, opt-in). Eyni sahələr, eyni iat/exp, eyni sənəd sahibi (holder)Rəqəmsal sənədi öz rəqəmsal cüzdanında saxlayan və onu kimə göstərəcəyinə qərar verən şəxs. açarı (SD-JWT cnf.jwk = mdoc deviceKey), ayrı sənədi verən qurum (issuer)Rəqəmsal sənədləri imzalayan və verən qurum: universitet, peşə təşkilatı, dövlət qurumu və ya şirkət. imzaları (SD-JWT: JOSE/ES256; mdoc: COSE_Sign1/ES256). Hər iki rəqəmsal sənəd vahid vermə axınında yaradılır; rəqəmsal cüzdan hər ikisini saxlayır.
2. docType = urn:tamga:id:IdentityAttestation:1 (vct ilə eyni URN); namespace = tamga.id.1. Sahə adları SD-JWT claim adları ilə tam eynidir (given_name, family_name, document_number_hash, age_over_18, …). Dəyişdi (2026-10-09, ADR-0045): iki format eyni məlumatı daşıyır; ad və kodlaşdırma hər formatda Aİ PID cədvəlinə əsaslanır (İcra Reqlamenti (Aİ) 2026/1731) — SD-JWT birthdate / nationalities ↔ mdoc birth_date (full-date) / nationality (massiv); digər adlar eynidir.
3. Yoxlama formatı DCQL (Digital Credentials Query Language)Yoxlayan tərəfin OpenID4VP-də hansı rəqəmsal sənədlərə və hansı sahələrə ehtiyac duyduğunu bildirmək üçün istifadə etdiyi sorğu dili. ilə seçilir: yoxlayan tərəf (verifier)Təqdim edilən rəqəmsal sənədi yoxlayan tərəf: imza, etibar siyahısındakı sənədi verən qurum, status və siyasət. Yoxlayan tərəf olaraq da adlandırılır. sorğusunda format: dc+sd-jwt və ya mso_mdoc göstərir; kanal (QR / dərin keçid / DC API) eyni qalır. Yoxlayan tərəf mdoc-da: issuerAuth COSE imzasını x5chain→etibar siyahısı (trust list)Bir ölkənin kök sertifikatlarının, sənədi verən qurumlarının və qeydiyyatlı yoxlayan tərəflərinin imzalanmış siyahısı. Bu gün Tamga-da etibar bu siyahılara əsaslanır; ortaq jurnal (ledger) sonra gələcək. (SPEC-TRUST-0001) ilə, sahə digest-lərini MSO ilə, cihaz imzasını isə SessionTranscript üzərində yoxlayır.
4. CBOR determinizmi: RFC 8949 §4.2.1 (bytewise). ISO 18013-5-in RFC 7049 §3.9 (əvvəlcə uzunluq) istinadını pilot tam-interop bəndi kimi qeyd edirik; bütün ekosistem vahid kitabxanadan (@tamga-network/mdoc) istifadə etdiyi üçün digest uyğunluğu təmin olunur.
5. SessionTranscript: OpenID4VP (OpenID for Verifiable Presentations)Yoxlayan tərəfin rəqəmsal cüzdandan rəqəmsal sənəd tələb etmək və təqdimetməni almaq üçün istifadə etdiyi protokol. 1.0 Final Əlavə B.2.6-dakı handover-lər: yönləndirməli axında OpenID4VPHandover (B.2.6.1 — client_id, nonceBir dəfə istifadə olunan təsadüfi dəyər; yoxlayan tərəf onu göndərir, rəqəmsal cüzdan isə imzalayır, beləliklə köhnə təqdimetmə təkrarlana bilməz., cavabın şifrələndiyi açarın JWK barmaq izi, response_uri), brauzer Digital Credentials API-sində OpenID4VPDCAPIHandover (B.2.6.2 — origin, nonce, JWK barmaq izi). Yaxın məsafədə (Bluetooth) ISO 18013-5 sessiyasının SessionTranscript-i istifadə olunur. İcra qeydi (2026-10-09): ilkin mətn demo üçün deterministik xülasə, pilot üçün isə ISO 18013-7 Əlavə B nəzərdə tuturdu; icra birbaşa OpenID4VP 1.0 Final formatına keçdi, bu məsələdə kənarlaşma qalmadı.
6. Əhatə dairəsi: yalnız şəxsiyyət attestasiyası. Tələbə/diplom/bilet SD-JWT VC olaraq qalır (mdoc-a ehtiyac yoxdur; brauzer girişi və PID presedenti yalnız şəxsiyyət üçün keçərlidir). Ehtiyac yaranarsa, eyni mexanizm genişləndirilir.

Əsaslandırma / alternativlər

• Yalnız SD-JWT VC (hazırkı vəziyyət): Safari brauzer girişi mümkün deyil, ARF PID presedenti ilə uyğun deyil. Rədd edildi.
• mdoc-a tam keçid (SD-JWT VC-dən imtina): mövcud sənədi verən qurum / yoxlayan tərəf / rəqəmsal cüzdan xəttini və OpenID4VP profilimizi (SPEC-PROTO-0002) pozur; SD-JWT VC veb/məsafədən istifadə üçün daha sadədir. Rədd edildi.
• İkili format (seçilən): Aİ-nin şəxsiyyət üçün etdiyi də budur. Qiyməti: ikinci vermə + yoxlama kodu və testləri; qazancı: Safari DC API + ARF uyğunluğu + Faza 1 Bluetooth hazırlığı. @tamga-network/mdoc müstəqildir, saf @noble; əlavə icra mühiti asılılığı yoxdur.

Dəyişməzlər

#	İnvariant
MD1	mdoc yalnız SD-JWT VC-nin ikinci təmsil formasıdır; SD-JWT VC əsas olaraq qalır (ADR-0006 dəyişmir). Bir tipin mdoc-u varsa, onun sahələri (məlumat; ad və kodlaşdırma formata görə Aİ PID cədvəlindən — ADR-0045), iat/exp və sənəd sahibinin açarı SD-JWT ilə tam eynidir.
MD2	mdoc deviceKey = SD-JWT cnf.jwk (eyni sənəd sahibi açarı, eyni cihaz bağlaması). Ayrı açar yaradılmır.
MD3	mdoc issuerAuth (COSE_Sign1) yalnız ES256; sənədi verən qurumun sertifikatı x5chain-də daşınır və SPEC-TRUST-0001 etibar siyahısı ilə (issuer_id) uyğunlaşdırılır — SD-JWT ilə eyni etibar lövbəri.
MD4	Yoxlama üç qiymətli nəticəni (SPEC-API-0001) qoruyur; digest uyğunsuzluğu/müddət/ləğv REJECTED, infrastrukturun əlçatmazlığı INDETERMINATE. Nəticə obyektində xam CBOR və açıqlanmayan sahə olmur.
MD5	mdoc fərdi məlumatların dəyərini yalnız IssuerSignedItem daxilində daşıyır; MSO, lövbər jurnalı və loglar yalnız digest/açar/tarix ehtiva edir (DP1/AP3 qorunur).

Nəticələr

• Yeni paket @tamga-network/mdoc (CBOR + COSE_Sign1 + MSO vermə/açıqlama/yoxlama + cihaz autentifikasiyası (identity proofing)Rəqəmsal sənəd verilmədən əvvəl şəxsin iddia etdiyi kimi olduğunu yoxlamaq, məsələn şəxsiyyət vəsiqəsi və canlılıq yoxlaması ilə.; 15 test).
• İcra (D12 faza 2): apps/id ikinci formatın verilməsi; @tamga-network/wallet-core mdoc saxlama + təqdimat; @tamga-network/verifier + apps/verify mdoc yoxlama yolu; DCQL mso_mdoc; SPEC-CRED-0001 / SPEC-PROTO-0002 versiya yeniləməsi; FW-ARF sətri. Səhnə 15 (şəxsiyyət → mdoc → selective disclosureRəqəmsal sənəddən yalnız yoxlayan tərəfin soruşduğu sahələrin göstərilməsi, başqa heç nəyin göstərilməməsi. → yoxlama).
• DECISIONS: D-CRED-5 + INVARIANTS MD1–MD5.

Status

Accepted — 2026-09-26. DECISIONS: D-CRED-5. Layihə 2026-09-26 (Proposed, paket + 15 test); həmin gün qəbul və D12 faza 2 icrası. ADR-0006-nı dəyişmir, genişləndirir.

2026-10-09: K2 və MD1-dəki ad qaydası ADR-0045 ilə dəyişdi (Aİ PID kodlaşdırması, D-ID-11).