staple_expired

HTTP 401 · Ludion-Error: staple_expired

何が起きたか

このリクエストには Ludion-Staple が付いていました。Ludion の Registry があなたのエージェントのために署名する、短命の状態証明です（Depth、Ballast、失効しているかどうか）。その Staple は期限を過ぎていました。Staple の寿命は最長1時間です（仕様 §10.5）。

サイトがこれを求める理由

サイトが頼りにするのは、今のあなたの状態であって、かつての状態ではありません。Staple が短命だから、失効はすべての Gate に届きます。しかも Registry は、あなたがどのサイトを訪れるかを知りません。状態はあなた自身が運び、すぐに期限が切れるからです。

直し方

新しい Staple を取り直します。SDK は寿命の半分で自動的に取り直します。CLI では次のとおりです。
ターミナルウィンドウ
```
npx ludion staple
```
長く動くプロセスから署名するなら、起動時だけでなく、タイマーで Staple を更新してください。
時計を確かめてください。時計が進んでいると、Staple が早く期限切れに見えます。

3分で検証済みになる

Ludion は Web Bot Auth を置き換えません。Web Bot Auth（RFC 9421）でリクエストに署名し、鍵ディレクトリを公開しているエージェントは、Ludion の Gate ではすでに VERIFIED（Depth 0）です。まだ署名していなければ、無料の Ludion CLI で次の手順を踏んでください。

3分は、この道の目標です。チェック DIV-1 として書いてあります。クリーンなコンテナで、init から VERIFIED まで180秒以内。

エージェントの身分（Diver）を作ります。Root 鍵はパスフレーズで封をされ、リクエストには署名しません。署名するのは短命の Session 鍵です。
Terminal window
```
npx ludion init --name "My Agent" --contact mailto:you@example.com
```
書き出された公開ファイルを、Signature-Agent のオリジンに HTTPS で置きます。.well-known/http-message-signatures-directory（鍵。application/http-message-signatures-directory+json で返す）と card（名乗り）です。自分のドメインで構いません。登録の受付が始まれば dvr-….agents.ludion.ai にも置けます。
リクエストごとに署名します。次のコマンドは Signature-Agent、Signature-Input、Signature を付けた curl をそのまま出力します。署名の寿命は 60 秒なので（仕様 §10.4）、毎回作り直してください。
Terminal window
```
npx ludion sign GET https://shop.example/checkout --curl
```
自己診断します。doctor は公開した鍵ディレクトリと Card を取りに行き、Gate が見るものを確かめます。リダイレクトなしの 200、Content-Type、ディレクトリに今の鍵があること、です。
Terminal window
```
npx ludion doctor
```

これで Gate はあなたのリクエストを VERIFIED と判定します。サイトがそれ以上に求めるもの（Depth、Ballast、Mandate）はその上に積むもので、それぞれ Gate のエラーに説明のページがあります。