Преминете към основното съдържание

JSON-LD

JSON-LD е обикновен JSON с едно допълнително поле, @context, което обяснява какво означават останалите полета. Контекстът свързва всяко кратко име на поле с глобално уникален идентификатор, обикновено URL адрес, публикуван от този, който е дефинирал речника, така че система, която никога не е виждала данните, пак да може да разбере какво ѝ се съобщава.

Обикновеният JSON показва как са записани данните, а не какво означават. Поле с име name може да съдържа човек, дружество или продукт и две системи могат да генерират валиден JSON, като същевременно не са съгласни за значението на нито едно поле. Тази празнина обикновено се запълва с писмено споразумение между двете страни, което върши работа при една интеграция, но престава да работи, когато удостоверение, издадено в една държава, трябва да бъде прочетено от верификатор в друга, с който никой не е говорил предварително.

JSON-LD запълва празнината в самия документ. @context свързва всяко кратко име на поле с глобално уникален идентификатор, така че полето остава четимо за човека и става недвусмислено за машината. Никоя от стойностите не се променя, а получател, който не разпознава речника, пак може да прочете документа като обикновен JSON и да пренебрегне останалото. JSON-LD 1.0 става препоръка на W3C на 16 януари 2014 г., а версия 1.1 следва на 16 юли 2020 г.

Моделът на данните W3C Verifiable Credentials Data Model 2.0 е изграден върху него. Всяко удостоверение започва с @context, чиято първа стойност е общият речник на удостоверенията, така че издателят, субектът, датите на валидност и информацията за статуса да означават едно и също навсякъде, а всеки допълнителен речник предоставя полетата, необходими за конкретния тип удостоверение.

Подписването на документ със свързани данни е избор между два механизма. Обгръщащо доказателство като JWT подписва байтовете точно такива, каквито са, така че всичко, което ги пренарежда или преформатира по пътя, разваля подписа. Вграденото доказателство Data Integrity подписва каноничен вид, определен от RDF Dataset Canonicalization, и именно това позволява на подписа да оцелее, когато документът бъде записан наново на друго място.

Той не е един от форматите на удостоверенията в EUDI Wallet. Архитектурата и референтната рамка (ARF) назовава SD-JWT VC и mdoc, а нито един от тях не използва JSON-LD, така че организация, която издава удостоверения към европейския портфейл, никога няма да срещне @context. JSON-LD намира мястото си там, където данните трябва да пътуват отвъд екосистемата, която ги е дефинирала: внедрявания на проверими удостоверения по W3C, паспорти на продукти и данни за веригата на доставки.

Същият формат се използва и от уебсайтовете, за да кажат на търсачката за какво се отнася една страница, като @context сочи към schema.org, а не към речник на удостоверения. Правилата за обработка са идентични и в двата случая, което прави структурираните данни най-лесното място, където да се види какво всъщност дава един контекст.

Прочетете пълното обяснение

Тази страница дава кратката дефиниция. Нашето обяснение показва какво означава тя на практика: кои са участниците, как работи и какво се променя за Вашата организация.

JSON-LD обяснено

JSON-LD един от форматите на удостоверенията в EUDI Wallet ли е?

Не. Архитектурата и референтната рамка (ARF) назовава SD-JWT VC и mdoc, а нито един от тях не е формат на JSON-LD, така че портфейл или верификатор, изграден по европейските правила, изобщо не се нуждае от JSON-LD процесор.

Това е решение за обхвата, а не присъда за формата. И двата формата, назовани в рамката, имат фиксирана структура, един механизъм за подписване и никакъв документ, който верификаторът да трябва да изтегли, преди да може да провери каквото и да било, а точно това са нещата, които телефонът и времето за отговор, измервано в милисекунди, възнаграждават. JSON-LD отговаря на друг въпрос, а именно как данните запазват значението си извън екосистемата, която ги е дефинирала, и организациите, които работят и в двата свята, обикновено завършват с поддръжка и на двата.

Каква е разликата между JSON-LD и обикновения JSON?

Никаква в начина, по който е записан документът: всеки JSON-LD документ е валиден JSON и софтуер, който се нуждае само от едно поле от него, може да го третира като такъв. Разликата е в @context, който свързва всяко име на поле с глобално дефиниран идентификатор, така че значението на данните пътува заедно с документа, вместо да живее в спецификация, за която двете страни е трябвало да се договорят предварително.

Допълнителната машинария има значение само когато документът се разгъва до пълния си вид или се канонизира за подписване, стъпки, които верификатор, четящ едно-единствено твърдение, никога не изпълнява. Истинската цена е другаде: контекстът трябва да е достъпен, а верификатор, който го изтегля по време на верификацията, поставя мрежово извикване и отдалечен сървър вътре в решение, свързано със сигурността. Внедряванията фиксират контекстите, които приемат, и ги доставят заедно със софтуера.

Назад към речника