JSON-LD
JSON-LD ir parasts JSON ar vienu papildu lauku, @context, kas pasaka, ko nozīmē pārējie lauki. Konteksts katru īso lauka nosaukumu sasaista ar globāli unikālu identifikatoru, parasti URL, ko publicējis tas, kurš vārdnīcu definēja, tāpēc sistēma, kas šos datus nekad nav redzējusi, tomēr var saprast, kas tai tiek pateikts.
Parasts JSON pasaka, kā dati tiek pierakstīti, nevis ko tie nozīmē. Lauks ar nosaukumu name var saturēt personu, uzņēmumu vai produktu, un divas sistēmas abas var sūtīt derīgu JSON un tomēr nesaprasties ne par vienu tā lauku. Šo plaisu parasti aizver rakstiska vienošanās starp abām pusēm, kas darbojas vienai integrācijai un pārstāj darboties, tiklīdz vienā valstī izsniegts pilnvarojums jāizlasa pārbaudītājam citā valstī, ar kuru neviens nav iepriekš runājis.
JSON-LD to aizver paša dokumenta iekšienē. @context katru īso lauka nosaukumu sasaista ar globāli unikālu identifikatoru, tāpēc lauks paliek cilvēkam salasāms un kļūst mašīnai nepārprotams. Neviena no vērtībām nemainās, un saņēmējs, kas vārdnīcu neatpazīst, joprojām var dokumentu lasīt kā parastu JSON un pārējo neņemt vērā. JSON-LD 1.0 kļuva par W3C Recommendation 2014. gada 16. janvārī, un versija 1.1 sekoja 2020. gada 16. jūlijā.
Uz tā ir būvēts W3C Verifiable Credentials Data Model 2.0. Katrs pilnvarojums sākas ar @context, kura pirmā vērtība ir kopīgā pilnvarojumu vārdnīca, tāpēc izsniedzējs, subjekts, derīguma datumi un statusa informācija visur nozīmē to pašu, bet katra turpmākā vārdnīca dod laukus, kas vajadzīgi vienam konkrētam pilnvarojuma veidam.
Saistīto datu dokumenta parakstīšana ir izvēle starp diviem mehānismiem. Aptverošs pierādījums, piemēram, JWT, paraksta baitus tieši tādus, kādi tie ir, tāpēc viss, kas tos ceļā pārkārto vai pārformatē, salauž parakstu. Iegults Data Integrity pierādījums tā vietā paraksta kanonisku formu, ko definē RDF Dataset Canonicalization, un tieši tas ļauj parakstam izdzīvot, ja dokumentu citur uzraksta no jauna.
Tas nav neviens no EUDI Wallet pilnvarojumu formātiem. Architecture and Reference Framework nosauc SD-JWT VC un mdoc, un neviens no tiem neizmanto JSON-LD, tāpēc organizācija, kas izsniedz uz Eiropas maciņu, nekad nesastaps @context. JSON-LD nopelna savu vietu tur, kur datiem jāceļo ārpus ekosistēmas, kas tos definēja: W3C pilnvarojumu ieviesumi, produktu pases un piegādes ķēdes dati.
Tas pats formāts ir arī veids, kā tīmekļa vietne pasaka meklētājprogrammai, par ko ir lapa, un tad @context norāda uz schema.org, nevis uz pilnvarojumu vārdnīcu. Apstrādes noteikumi abos gadījumos ir vienādi, tāpēc strukturētie dati ir visvieglākā vieta, kur redzēt, ko konteksts patiesībā dod.
Lasīt pilno skaidrojumu
Šī lapa sniedz īso definīciju. Mūsu skaidrojums parāda, ko tas nozīmē praksē: kas ir iesaistīti, kā tas darbojas un kas mainās jūsu organizācijai.
JSON-LD skaidrojumsSaistītie termini
Vai JSON-LD ir viens no EUDI Wallet pilnvarojumu formātiem?
Nē. Architecture and Reference Framework nosauc SD-JWT VC un mdoc, un neviens no tiem nav JSON-LD formāts, tāpēc maciņam vai pārbaudītājam, kas būvēts Eiropas noteikumiem, JSON-LD procesors nav vajadzīgs nemaz.
Tas ir lēmums par tvērumu, nevis spriedums par formātu. Abiem ietvara nosauktajiem formātiem ir noteikta forma, viens paraksta mehānisms un neviens dokuments, kas pārbaudītājam būtu jāielādē, pirms tas var ko pārbaudīt, un tieši to atalgo tālrunis un milisekundēs mērāms atbildes laiks. JSON-LD atbild uz citu jautājumu, proti, kā dati saglabā savu nozīmi ārpus ekosistēmas, kas tos definēja, un organizācijas, kas strādā abās pasaulēs, galu galā parasti atbalsta abus.
Kāda ir atšķirība starp JSON-LD un parastu JSON?
Nekāda tajā, kā dokuments ir uzrakstīts: katrs JSON-LD dokuments ir derīgs JSON, un programmatūra, kurai no tā vajadzīgs tikai viens lauks, var ar to tā arī rīkoties. Atšķirība ir @context, kas katru lauka nosaukumu sasaista ar globāli definētu identifikatoru, tāpēc datu nozīme ceļo kopā ar dokumentu, nevis mīt specifikācijā, par kuru abām pusēm bija jāvienojas iepriekš.
Papildu mehānismam ir nozīme tikai tad, kad dokumentu izvērš pilnā formā vai kanonizē parakstīšanai, un šos soļus pārbaudītājs, kas lasa vienu apgalvojumu, nekad neveic. Īstā cena ir citur: kontekstam jābūt pieejamam, un pārbaudītājs, kas to ielādē pārbaudes laikā, ir ievietojis tīkla izsaukumu un attālinātu serveri drošības lēmuma vidū. Ieviesumi nostiprina pieņemamos kontekstus un piegādā tos kopā ar programmatūru.