5分でわかるLantern

デモライブラリを読む

デモはこのサイトが配信する静的ライブラリです。インストールもサインインも不要です。

1. ハンドシェイクを読む

   各ライブラリは、自身が何か、どの機能を提供し、どんな制限があるかを1つの文書で示します。

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

2. アプリを一覧する

   1つのプラットフォームのアプリ1ページ。各アプリにサイズ、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データグラムで発見し、アドレスがあれば既知のパスでハンドシェイクを読みます。

   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. 呼び出す

   受け取ったトークンをベアラーとして使います。鍵でペアリングした端末は各リクエストにも署名します。

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

全体の流れ

1ステップずつ進めます。押すたびに1つのステップが点灯し、他は暗くなります。

仕様