Liigu põhisisu juurde

JSON-LD

JSON-LD on tavaline JSON ühe lisaväljaga, @context, mis ütleb, mida ülejäänud väljad tähendavad. Kontekst seob iga lühikese väljanime üleilmselt unikaalse identifikaatoriga, tavaliselt URL-iga, mille on avaldanud see, kes sõnastiku määratles, nii et süsteem, mis pole neid andmeid kunagi näinud, saab siiski aru, mida talle öeldakse.

Tavaline JSON ütleb, kuidas andmed kirja pannakse, mitte mida need tähendavad. Väli nimega name võib sisaldada inimest, ettevõtet või toodet, ja kaks süsteemi võivad mõlemad saata kehtivat JSON-i ning olla ikkagi eri meelt selle iga välja osas. See lünk suletakse tavaliselt kahe poole vahelise kirjaliku kokkuleppega, mis toimib ühe liidestuse puhul ja lakkab toimimast siis, kui ühes riigis väljastatud tõendit peab lugema teise riigi kontrollija, kellega keegi pole eelnevalt rääkinud.

JSON-LD sulgeb selle dokumendi sees. @context seob iga lühikese väljanime üleilmselt unikaalse identifikaatoriga, nii et väli jääb inimesele loetavaks ja muutub masina jaoks üheseks. Ükski väärtus ei muutu ja saaja, kes sõnastikku ei tunne, saab dokumenti ikka lugeda tavalise JSON-ina ja ülejäänut eirata. JSON-LD 1.0 sai W3C Recommendationiks 16. jaanuaril 2014 ja versioon 1.1 järgnes 16. juulil 2020.

W3C Verifiable Credentials Data Model 2.0 on sellele ehitatud. Iga tõend algab @contextiga, mille esimene väärtus on ühine tõendisõnastik, nii et väljastaja, subjekt, kehtivuskuupäevad ja olekuteave tähendavad kõikjal sama, ja iga edasine sõnastik annab väljad, mida üks kindel tõenditüüp vajab.

Seotud andmetega dokumendi allkirjastamine on valik kahe mehhanismi vahel. Ümbritsev tõestus nagu JWT allkirjastab baidid täpselt sellistena, nagu need on, nii et kõik, mis neid teel ümber järjestab või ümber vormindab, lõhub allkirja. Sisseehitatud Data Integrity tõestus allkirjastab selle asemel kanoonilise kuju, mille määratleb RDF Dataset Canonicalization, ja just see laseb allkirjal üle elada dokumendi uuesti väljakirjutamise mujal.

See ei ole ükski EUDI Walleti tõendivormingutest. Architecture and Reference Framework nimetab SD-JWT VC ja mdoc ning kumbki neist ei kasuta JSON-LD-d, nii et Euroopa rahakotti väljastav organisatsioon ei kohta kunagi @contexti. JSON-LD teenib oma koha seal, kus andmed peavad liikuma väljapoole neid määratlenud ökosüsteemi: W3C tõendite juurutused, tootepassid ja tarneahela andmed.

Sama vorming on ka see, kuidas veebisait ütleb otsingumootorile, millest leht räägib, kusjuures @context osutab schema.orgile, mitte tõendisõnastikule. Töötlusreeglid on mõlemal juhul samad, mis teeb struktuurandmetest kõige lihtsama koha näha, mida kontekst tegelikult annab.

Loe täielikku selgitust

See leht annab lühikese definitsiooni. Meie selgitus näitab, mida see praktikas tähendab: kes on kaasatud, kuidas see toimib ja mis teie organisatsiooni jaoks muutub.

JSON-LD selgitatuna

Kas JSON-LD on üks EUDI Walleti tõendivormingutest?

Ei. Architecture and Reference Framework nimetab SD-JWT VC ja mdoc ning kumbki neist ei ole JSON-LD vorming, nii et Euroopa reeglite järgi ehitatud rahakott või kontrollija ei vaja üldse JSON-LD protsessorit.

See on ulatuse otsus, mitte otsus vormingu väärtuse kohta. Mõlemal raamistiku nimetatud vormingul on kindel kuju, üks allkirjastamismehhanism ja mitte ühtegi dokumenti, mida kontrollija peaks enne kontrollimist alla laadima, ja just seda premeerivad telefon ja millisekundites mõõdetav vastusaeg. JSON-LD vastab teisele küsimusele, nimelt kuidas andmed säilitavad oma tähenduse väljaspool neid määratlenud ökosüsteemi, ja mõlemas maailmas tegutsevad organisatsioonid toetavad lõpuks tavaliselt mõlemat.

Mis vahe on JSON-LD-l ja tavalisel JSON-il?

Mitte midagi selles, kuidas dokument on kirjutatud: iga JSON-LD dokument on kehtiv JSON ja tarkvara, mis vajab sellest vaid üht välja, võib seda nii käsitleda. Vahe on @context, mis seob iga väljanime üleilmselt määratletud identifikaatoriga, nii et andmete tähendus liigub koos dokumendiga, selle asemel et asuda spetsifikatsioonis, milles kaks poolt pidid eelnevalt kokku leppima.

Lisamehhanism loeb alles siis, kui dokument laiendatakse täiskujule või kanoniseeritakse allkirjastamiseks, ja neid samme ei tee üht väidet lugev kontrollija kunagi. Tegelik hind on mujal: kontekst peab olema kättesaadav ja kontrollija, kes selle kontrollimise ajal alla laadib, on pannud võrgupäringu ja kaugserveri keset turvaotsust. Teostused kinnistavad aktsepteeritavad kontekstid ja tarnivad need koos tarkvaraga.

Tagasi sõnastiku juurde