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

Digital Credentials API обяснено

Digital Credentials API е споразумението, което позволява на уебсайт да поиска удостоверение направо от Вашия портфейл, през браузъра и операционната система на устройството, което вече държите. На телефона, който съдържа портфейла, не се появява QR код и не се налага да преминавате към друго приложение и обратно. Докосвате веднъж, телефонът показва кой пита, а Вие решавате. На лаптоп браузърът показва свой QR код, за да достигне до телефона.

Заобиколният път, който премахва

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

Най-зле е на телефон, където QR кодът стои на същия екран като камерата, предназначена да го сканира. Digital Credentials API затваря тази празнина, като прави заявката нещо, което браузърът и операционната система могат да пренасят сами, защото вече знаят кои портфейли има на устройството.

Същото устройство

Посетителят е на телефона, който съдържа портфейла. Тук Digital Credentials API напълно премахва QR кода и превключването между приложения.

Между две устройства

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

Как изглежда на практика

От гледна точка на посетителя това е едно докосване на страницата, на която вече е бил. Отдолу браузърът предава заявката на операционната система, операционната система намира портфейлите, които могат да отговорят, а портфейлът показва заявката за одобрение, преди да бъде споделено каквото и да е.

1. Уебсайт

Моли браузъра за удостоверение, вместо да рисува QR код или да отваря приложение

2. Браузър и операционна система

Определя кои портфейли на устройството съдържат нещо подходящо и предлага само тях

3. Притежател

Вижда кой пита и за какво, избира портфейл и одобрява или отказва

4. Отново уебсайтът

Получава одобрения отговор на същата страница, която посетителят не е напускал

Едно докосване, една страница. Нищо не се изпраща към уебсайта, докато притежателят не го одобри.

Защо участието на браузъра има значение

QR кодът е лист хартия или картинка на екран и не може да каже кой го е поставил. Това е цялата основа на QR фишинга: нападателят подменя кода, портфейлът се отваря, а заявката изглежда напълно нормална, защото нищо в потока не знае откъде действително идва.

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

Как се вписва в OpenID4VP и EUDI Wallet

Лесно е това да се чете като поредния стандарт, между който трябва да се избира. Не е така. OpenID4VP остава езикът, на който доверяващата се страна казва от какво се нуждае и чете получения отговор, а Digital Credentials API е просто по-добър път за този разговор, най-вече когато всичко се случва на едно устройство.

Същото важи и за самото удостоверение. Атестация на EUDI Wallet или mdoc пристига точно във формата, в който би пристигнала при сканиран код, така че проверките, които верификаторът вече извършва, не се променят. Екипът печели възможност да пропусне заобиколния път, без да преработва нищо зад него.

Поддръжката идва браузър по браузър и платформа по платформа, а не навсякъде наведнъж, затова доверяващите се страни я въвеждат заедно със сканирания път, а не вместо него. Практичният подход е да се ползва API интерфейсът там, където устройството го предлага, да се преминава към код там, където не го предлага, и резервният вариант да се оставя да избледнява с нарастване на покритието.

Какво означава това за Вас

Доверяваща се страна

По-малко хора изоставят потока, защото стъпките, на които преди отпадаха, ги няма, а браузърът казва на портфейла кой сте всъщност, което изключва пътя за фишинг.

Притежател на портфейл

Едно докосване на страницата, на която вече сте, честно име на този, който пита, и никакъв начин сайтът да научи кои портфейли носите, освен ако не кажете да.

Доставчик на портфейл

Портфейлът Ви се предлага от операционната система винаги, когато съдържа нещо подходящо, така че да бъде намерен вече не зависи от това дали доверяваща се страна е избрала да сочи към него.

Техническо потапяне

Тази страница обяснява какво прави технологията и кого засяга. Нашата документация за разработчици обхваща самата реализация: съобщенията, полетата и работните примери, от които се нуждае екипът по интеграция.

Прочетете техническата документация

Свързани термини

Често задавани въпроси

Означава ли това краят на QR кодовете?

Не, то стеснява за какво служат те и променя кой ги изобразява. Прехвърлянето на заявка от лаптоп към телефон все още изисква нещо, което да свърже двете, и API интерфейсът покрива и този случай, като браузърът показва кода, вместо всеки уебсайт да изгражда свой. Напълно изчезва кодът на телефон, който вече съдържа портфейла, където той никога не е бил нещо повече от заобиколно решение.

Вижда ли уебсайтът кои портфейли са инсталирани на устройството?

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

Замества ли това OpenID4VP?

Не, двете работят заедно. OpenID4VP е езикът, на който са написани заявката и отговорът, и той тук не се променя. Digital Credentials API е пътят за доставяне на устройството, който заема мястото на QR кода или на персонализираната връзка. Доверяваща се страна, която вече работи с OpenID4VP, запазва съществуващата си логика за заявки и верификация.

Какво всъщност трябва да изгради една доверяваща се страна?

По-малко, отколкото очакват повечето екипи, защото променя се предната част. Заявката, която създава бекендът, и проверките на отговора остават същите. Добавя се извикването към браузъра и, докато поддръжката още се разпространява, резервен вариант с QR код за посетители, чийто браузър или устройство още не могат да ползват API интерфейса.

Източници

  1. W3C Digital Credentials API
  2. OpenID for Verifiable Presentations (OpenID4VP)

Тази страница е информационна и не представлява правен съвет. Digital Credentials API все още се развива, затова за авторитетната формулировка направо се обърнете към спецификацията на W3C.

Свържете се с нас за интеграция с EUDI Wallet