01
Ключ агента
Создайте пару ключей агента (Ed25519 или P-256). Отпечаток открытого ключа по RFC 7638 провайдер впишет в утверждение (cnf.jkt). Каждый запрос к магазину подписывайте этим ключом — HTTP Message Signatures, RFC 9421, так же, как Web Bot Auth.
02
Запрос с утверждением
POST /api/checkout HTTP/1.1
Host: shop.example
KYH-Assertion: eyJhbGciOiJFUzI1NiIsImtpZCI6ImJhbmstMjAyNiJ9.eyJpc3Mi…
Signature-Input: sig1=("@method" "@authority" "@path" "kyh-assertion");created=1793961000;keyid="agent-key-1"
Signature: sig1=:MEUCIQ…:
Content-Type: application/json03
Ответы магазина
200
Утверждение принято, заказ идёт дальше.
401 + KYH-Required
Нужен уровень выше. Попросите человека подтвердить у провайдера и повторите запрос.
403 kyh_revoked
Доверие агенту отозвано. Остановитесь и сообщите человеку.
400 kyh_invalid
Утверждение испорчено, просрочено или выдано другому магазину.
04
Связь с паспортом
В поле agt утверждения провайдер указывает ссылку на паспорт ИИ-агента или KYA-профиль. Так магазин видит сразу и агента (KYA), и человека за ним (KYH).