Lantern за пять минут

Прочитать демо-библиотеку

Демо — статическая библиотека, которую отдаёт этот сайт: ничего устанавливать и входить никуда не нужно.

1. Прочитать handshake

   Каждая библиотека в одном документе сообщает, что она такое, какие возможности предлагает и какие у неё лимиты.

   curl -s https://lantern.boreale.dev/demo/lantern.json

2. Показать его приложения

   Страница приложений для одной платформы: у каждого есть размер, sha256 и путь к файлу.

   curl -s https://lantern.boreale.dev/demo/v1/apps/vita/pages/1.json

3. Скачать и проверить

   SHA-256 файла совпадает с заявленным приложением. Клиент отвергает то, что не совпадает.

   curl -s https://lantern.boreale.dev/demo/v1/blobs/sha256/fa75492f7b78cad7ca4044e8fb548ac67bfd7fbf05242ceecb29ebe492218a0d | sha256sum

Ещё для проб, включая библиотеки-ловушки для клиентов: Демонстрационная библиотека

Работа с вашим сервером

Сервер с аккаунтами сначала просит сопрячь устройство. В этих вызовах вымышленный адрес.

1. Найти

   В локальной сети клиент находит его UDP-датаграммой; по адресу он читает handshake по известному пути.

   curl -s https://shelf.example.org/.well-known/lantern

2. Сопряжение

   Сервер отвечает кодом, который вводят на другом устройстве, где владелец входит и подтверждает.

   curl -s -X POST https://shelf.example.org/api/lantern/v1/pairing \
     -H 'Content-Type: application/json' \
     -d '{"schema":1,"device":"My console","scopes":["library"]}'

3. Вызвать

   С полученным токеном (bearer); устройство, сопряжённое с ключом, дополнительно подписывает каждый запрос.

   curl -s https://shelf.example.org/api/lantern/v1/apps?page_size=5 \
     -H 'Authorization: Bearer et_…'

Весь путь

Пройдите по шагам: каждое нажатие подсвечивает один шаг и приглушает остальные.

Спецификация