サーバーを書く
ハンドシェイクとライブラリを提供し、セーブのバックアップやチート、ペアリングは必要なときに足して、機能として宣言します。サーバーは週末で書けます。
GET /.well-known/lantern
GET /api/lantern/v1/apps?sort=added1.0 までは本文が変わることがあります。とくにクライアントやサーバーを書く方からのご意見を歓迎します。
長く使えるように
堅牢さの理由
Lantern はゼロから始めます。以前のどのプロトコルとも互換性を持たないので、すべての選択が安全と長く使えることのためにあります。
- パスとすべての文書、2 か所でバージョン管理。変更がクライアントを黙って壊すことはありません。
- デバイスごとのトークンをサーバー側で承認し、1 つずつ取り消せます。ゲーム機でパスワードを入力することも、保存することもありません。
- どこでも HTTPS。独自の証明書を持つ自宅のサーバーは、両方の画面で鍵のフィンガープリントを照合したうえで、ペアリング時に固定（ピン留め）されます。
- 検証されたコンテンツ。すべてのファイルに SHA-256 があり、ゲーム機はインストールの前にそれを確認します。
- 宣言された機能。サーバーは何を、誰に、どのスキーマで提供するかを伝えます。
- サーバーを外から確認する適合性テストと、それに合格する参照サーバー。
新しいこと
加えるもの
これまでクライアントが推測するしかなかったことを、文章にしました。
- すべてのファイルに SHA-256。インストールの前に確認します。
- パスにバージョン、すべての文書に schema。世代の違うクライアントとサーバーでも話が通じ続けます。
- 推測ではなく、宣言された機能の一覧。
- ライブラリが変わっても、飛ばしも重複もしないカーソル式のページ。
- ゲーム機にパスワードを残さず、取り消せるトークンでペアリング。
- 本当のステータスコードを持つエラーを、ひとつの形式で。
- 隠しごとなし。ハードウェア識別子も、独自の暗号化も、サーバーが決めるクライアントの変更もありません。
実装する
サーバーとクライアントの作者へ
仕様は短くまとまっています。少ないルート、決まった形、素直な HTTP と JSON。
クライアントを書く
ローカルネットワークでサーバーを見つけ、機能を読み、ライブラリをページごとにたどり、ダウンロードごとに SHA-256 を確認します。クライアントは C++ で数百行に収まります。
User-Agent: ExampleClient/0.1
Range: bytes=0-1048575スキーマと例
すべての文書の JSON スキーマ、それぞれの例、ルートの OpenAPI 記述。自分の実装と照らし合わせられます。
リポジトリには、サーバーに対して実行する適合性テスト（conformance/）と、それに合格する小さな参照サーバー（server/）があります。テストに合格した実装だけが Lantern 対応を名乗るべきです。
最初のクライアントは、Nintendo Switch 用の homebrew パッケージマネージャー PlayShelf です。 PlayShelf
自分のゲームのために
Lantern は、あなたのサーバーにあるものをゲーム機との間で運ぶだけです。何かを探すことも配ることもしません。ゲームを手に入れる手段ではなく、サーバーはあなたが持っているゲームのためのものです。
ライセンス
自由に実装できます
- CC BY 4.0仕様の本文。出典を示せば、共有も改変もできます。
- MITそれ以外のすべて（スキーマ、OpenAPI 記述、例、適合性テスト、参照サーバー）。どんなライセンスのサーバーやクライアントでも、プロトコルを実装し、スキーマをそのまま使えます。
質問、意見、提案はリポジトリの Issues へどうぞ。
このサイト
プライバシー
このサイトは Cookie を使わず、ブラウザに保存するのはヘッダーで選んだ言語だけです。ほかのサイトからは何も読み込みません。フォント、画像、スクリプトはすべてこのサイトから配信されます。
アクセスは、欧州連合（フランクフルト）の Umami Cloud で、Cookie を使わずに計測しています。表示されたページごとに、そのページ、参照元のページ、ブラウザ、OS、デバイスの種類、画面サイズ、言語、国を記録します。IP アドレスは国の判定と訪問の区別に使われ、記録とともに保存されることはありません。集計は 6 か月間保存され、何が読まれているかを知るためだけに使われ、販売や共有は一切しません。Umami のポリシー：umami.is/privacy。
このサイトの発行者、ホスティング、データについての問い合わせ方法： プライバシーと法的情報