すべてのページ
このページの内容

セキュリティ:エージェントトークン、ブラウザーセッション、リレーのキー 0.9.27 で追加

リレーに責任を持つ人は 1 人だけ、あなたです。0.9.27 からは、リレーと通信するそれ以外のものはすべて、届く範囲の狭い専用の認証情報を持ちます。エージェントは専用のトークンを受け取り、各ブラウザーはリレートークンの代わりにセッションを持ち、ペアリングしたリレーはキーでサインインします。このページでは、それぞれが何をしてよいか、Settings → Security(設定 → セキュリティ)に何が表示されるか、そしてまだ残っている課題を説明します。リレーがそもそも何を公開するかについては、セキュリティの概要を参照してください。

誰が何を持つか #

認証情報 持つ人・もの 開けるもの
リレートークン あなたが、パスワードマネージャーに保管します。リレーはそのハッシュだけを保存します すべて。ブラウザーをサインインさせるときと、リレーをペアリングするときに使います
ブラウザーセッション サインインした各ブラウザーが Cookie に持ち、証明キーをページのストレージに持ちます Web UI であなたができること
エージェントトークン 各セッション(OAR_AGENT_TOKEN)と oar コマンド エージェントに必要なルート。あなた専用のルートは含みません
リレーのキー ペアリングしたリレーが、方向ごとに 1 つ リレー同士が呼び出し合うルートだけ
サインインリンク あなたが渡した相手が、1 回だけ、10 分間 新しいブラウザーセッション 1 つ

エージェントにできること、あなただけのもの #

各セッションの環境には OAR_AGENT_TOKEN が入ります。これはそのセッションの会話に結び付いたトークンです。セッションのワーカー、その CLI とツール、そして OAR 自身のエージェントツールは、このトークンでリレーを呼び出します。エージェントがリレートークンを見つけられる場所はもうありません。環境、コマンドライン、config.json、ログ、トランスクリプトのどこにもありません。

エージェントトークンでできること:

  • セッション、設定、使用状況を読む。
  • セッションにプロンプトを送る、停止する、アーカイブする、コンパクト化する、再起動する。自分のターンを実行する。
  • 自分の質問カードとプランカードを出す。
  • relay_tool、リレーイベント、予約を使う。
  • ファイル、ドライブ、git、アップロード、そして自分の会話のプレビューを使う。
  • セッションを既存のグループに入れる、グループから出す。
  • 理由を添えてリレーの再起動をキューに入れ、それを取り消す。

次のものはあなただけのもので、エージェントトークンには 403 AUTH_PERSON_REQUIRED が返ります。

  • 質問カードへの回答や却下。 別の会話の通常の質問カード、Safety check(安全確認)、承認カード、プランカードも含みます。relay_tool の answer_question は Only the person can answer questions; ask them in the relay UI と返します。
  • Inbox(受信箱)。
  • 設定、プロバイダーへのサインイン、ペアリング、プッシュ通知のデバイス、共有リンク。
  • セッションの削除、グループの作成・名前の変更・削除。
  • 今すぐの再起動、単純なシャットダウン、更新とインストール。
  • Web UI のライブ接続。

セッションのトークンはそのセッションのためだけに働きます。relay_tool は別の会話への呼び出しを拒否し(AUTH_CONVERSATION_MISMATCH)、エージェントが新しいセッションを開始できるのは relay_tool の create_session を通してだけです。そこではあなたの Allow(許可)とセッション数の上限が適用されます。エージェントが owner_approved を設定しても、リレーはそれを無視します。

リレーホストで実行するスクリプトも同じトークンを使います。セッションの中では Authorization: Bearer $OAR_AGENT_TOKEN、セッションの外では oar agent-token がトークンを出力します。どちらもリレートークンではありません。トークンを送らないスクリプトには 401 The relay token is no longer in the config; use OAR_AGENT_TOKEN が返ります。

ブラウザーセッション #

サインインでは、サインインボックスまたはサインイン用アドレスで、リレートークンを一度だけそのブラウザーのセッションと引き換えます。以後はブラウザーの Cookie がトークンではなくセッションを持ち、リレーはそのハッシュだけを保存します。

  • 有効期間。 セッションは最後に使われてから 30 日、最長で 400 日続きます。リレーが保持するのは最大 50 件で、新しいセッションが来ると、最も長く使われていないものが押し出されます。
  • 証明キー。 サインインすると、ページは 2 つ目の秘密も受け取ります。ページはそれを自分のストレージに保管し、すべてのリクエストで送ります。ブラウザーはリレーの Cookie をリレーホストのすべてのポートに送るため、エージェントがそこで動かす開発サーバーを開くと、そのサーバーも Cookie を受け取ります。証明キーがなければ、Cookie で開けるのはブラウザーが自分で読み込む添付ファイル、生成された画像、メディアだけです(保護の及ばない範囲を参照)。ブラウザーでサイトのデータを消去するとキーも消え、そのブラウザーはもう一度サインインすることになります。
  • キーはリレーから出ません。 ページが証明キーを送るのは、リレー自身のアドレス(ポートも含めて)の /api/ の下だけです。エージェントが別のアドレスから返信に入れた画像は、リレーホストの別のポートからのものも含め、キーを受け取ることはなく、ビューアーに 🖍️ も表示されません。
  • パスで開くファイル。 ページがパスで開くファイル(画像、動画、ダウンロード、新しいタブで開く PDF)は、アドレスにファイル許可 k を持ちます。ページは証明キーを使ってそれを要求します。ファイル許可が開くのはその 1 つのファイルだけで、このブラウザーの Cookie と一緒の場合に限り、最長 10 分間有効です。ページは必要に応じてそれを更新するので、長い動画も途切れません。ページからコピーしたファイルのリンクは、その後は使えなくなります。間違った、または期限切れの k には、パスにかかわらず同じ 403 AUTH_FILE_CAPABILITY が返るので、ファイルについて何も分かりません。
  • メディアのアドレスにはタグが付きます。 メディアギャラリーは、すべてのアドレスにタグ t を付けて渡します。タグのないメディアのアドレスには、誰が要求しても 404 が返るので、コピーされた Cookie でメディアを一通り見て回ることはできません。タグに期限はありませんが、relay-secrets.json が置き換えられると古いメディアのアドレスは使えなくなり、ギャラリーは新しいアドレスを渡します。
  • 0.9.27 より前のブラウザーは、Cookie にトークンを持っています。その Cookie ではもう何も開けません。ページが起動すると、サインインボックスなしで、その Cookie を一度だけセッションとその証明キーに引き換えます。更新前から開いたままのタブは古いページを実行しているので、一度だけ再読み込みが必要です。
  • サインアウトされた場合。 セッションが無効になったブラウザーは、サインインページに This browser was signed out と表示します。そのブラウザーから通知に応答すると Signed out, open OAR と表示されます。
  • スクリプトはセッションを作りません。 Authorization ヘッダーにリレートークンを入れたリクエストは、セッションなしであなたとして動作し、ブラウザーの一覧に追加されることはありません。

Settings → Security(設定 → セキュリティ) #

Settings → Security は、誰がこのリレーを使えるかを扱います。エージェントとペアリングしたリレーは開けません。

  • Browsers signed in(サインイン中のブラウザー)には、ここにセッションを持つすべてのブラウザーが並びます。このブラウザーが先頭で、this browser の印が付きます。各行には、名前、いつどの方法でサインインしたか(リレートークン、サインインリンク、ターミナル、またはセッション導入前からの引き継ぎ)、最後に確認された日時と最後のアドレスが表示されます。名前は、Rename(名前を変更)するまでは、ブラウザーが報告したブラウザーとシステムから付けられます。最後のリクエストが、リレー自身のホストからそこにあるプロキシやトンネルを通って届いたブラウザーには、this host (forwarded for …)(このホスト、… からの転送)と表示され、括弧の中に転送元のアドレスが入ります。
  • 行の Sign out(サインアウト)は、そのブラウザーのセッションをすぐに終了し、ライブ接続を閉じ、プッシュ通知を止めます。Sign out all other browsers(他のすべてのブラウザーをサインアウト)はこのブラウザーだけを残します。Sign out this browser(このブラウザーをサインアウト)は、ここにサインインボックスを表示します。どれも先に確認を求めます。

新しいサインインの通知 #

ブラウザーがリレートークン、サインインリンク、またはターミナルでサインインすると、サインインが完了する前に、サインイン中の他のすべてのブラウザーに知らされます。

  • ヘッダーの下のバナーに、いくつあっても 1 行が表示されます。New browser signed in: ,
    , via … に Sign it out(サインアウトさせる)と Got it(了解)が付くか、3 new browsers signed in (latest: …) と表示されます。Show all(すべて表示)は会話の上に一覧を開き、各ブラウザーがいつどの方法でサインインしたかと Sign it out を表示します。Got it を 1 回押すと、すべてが閉じられます。
  • プッシュ通知 New browser signed in が届きます。デバイスでアプリを開いているときも、新しいブラウザー以外のセッションを持つすべてのデバイスに届きます。通知には Sign it out アクションがあり、タップすると Settings → Security が開きます。5 分以内に複数あると、新しいものが前のものを置き換えます。スイッチは Settings → Notifications(設定 → 通知)の A new browser signed in です。

リレー自身のホストからそこにあるプロキシやトンネルを通って届いたサインインは、this host と表示され、括弧の中に転送元のアドレスが入ります。そのアドレスだけが表示されることはありません。

リレーは通知を 7 日間保持します。通知を閉じると、そのブラウザーでだけ閉じられます。そのため、新しいセッションが自分のサインインを他のブラウザーから隠すことはできません。もう一度サインインしたブラウザーには、閉じたものも含め、過去 7 日間の通知が再び表示されます。ターミナルからのサインインの通知は、そのブラウザーがサインインしている間、後にいくつサインインが続いても残ります。

別のデバイスをサインインする #

スマートフォンでリレートークンを入力する必要はもうありません。

  1. サインイン中のブラウザーで Settings → Security → Sign in another device(設定 → セキュリティ → 別のデバイスをサインイン)を開き、Make a sign-in link(サインインリンクを作成)を押します。
  2. もう一方のデバイスでリンクを開くか、Show QR code(QR コードを表示)を押して、そのデバイスのカメラでスキャンします。

リンク(…/?signin=…)は、10 分以内に 1 回だけ、ブラウザー 1 つをサインインさせます。タブには残り時間が表示されます。最初に開いた人がサインインするので、あなただけが見られる場所でだけ表示または送信してください。QR コードは、1 分後、ページを離れたときや設定を閉じたとき、リンクが使われたか期限切れになったとき、そして Hide QR code(QR コードを隠す)を押したときに、再び隠れます。新しいリンクを作ると前のリンクは無効になり、リレーを再起動しても無効になります。

リレーホストでは、oar url --sign-in が、スマートフォンから届くアドレスでこのようなリンクと QR コードをターミナルに出力します。リレーがこれを作るのは 10 分間に最大 3 回です。新しいリンクは前のリンクを置き換え、前のリンクはそれ以降使えなくなります。コマンドもそのことを表示します。この方法でサインインしたブラウザーは、ブラウザーの一覧で from the terminal (oar url --sign-in) と表示されます。

同じホスト名でポートだけが違う 2 つのリレー(host:3333、host:3334)は、ブラウザーの中で 1 つのサインイン Cookie を共有し、互いをサインアウトさせてしまいます。それぞれに別のホスト名を付けてください。

リレートークン #

リレートークンは本人の認証情報です。パスワードマネージャーに保管してください。リレーはそのハッシュだけを、データフォルダーの relay-secrets.json に保存します。シークレットの保存場所を参照してください。新しいトークンは oaro1_ で始まります。以前のバージョンのトークンも引き続き使えます。

  • 表示されるのは 1 回だけです。 ターミナルで oar setup を実行すると、新しいトークンが、サインインリンクと QR コードとともに 1 回だけ表示されます。ターミナルがない場合(サービス、スクリプト、エージェント)は、何もトークンを出力しません。その出力は、エージェントが読めるログに残るからです。
  • oar url はトークンを出力しません。 リレーにはできません。ハッシュしか持っていないからです。
  • なくした場合。 まだサインインしているブラウザーから別のデバイスをサインインさせるか、トークンを置き換えます。サインイン中のブラウザーがない場合は、リレーホストのターミナルで oar setup --new-token を実行します。

新しいリレートークンを生成する #

Settings → Security → Relay token(設定 → セキュリティ → リレートークン)には、トークンが設定されているか、リレーがそのハッシュだけを保存していること、そしてトークンが作成または最後に置き換えられた日時が表示されます。Generate new relay token(新しいリレートークンを生成)は、まず The current token stops working at once. Signed-in browsers stay signed in; agents keep working. と確認し、その後で新しいトークンを 1 回だけ表示します。

  • トークンは Show(表示)を押すまで隠れています。Save in password manager(パスワードマネージャーに保存。パスワードマネージャーがリレーの名前で保存するよう提案します)、Copy(コピー)、Copy pairing link(ペアリングリンクをコピー)があります。
  • 古いトークンが、ブラウザーのページ以外のもの(スクリプトや古いペアリングしたリレーなど)に最後に使われた日時と、そのアドレスが表示されます。
  • まだ古いトークンで呼び出しているペアリングしたリレーが一覧になり、それぞれに Open there(そちらで開く)があります。これは、そのリレーの Settings → Relays(設定 → リレー)を、ペアリングリンクを受け付ける状態の Add a relay(リレーを追加)とともに開きます。キーでサインインするリレーは引き続き動作し、一覧には出ません。

ダイアログを閉じると、トークンはページから消えます。貼り付けた後はクリップボードを消去してください。クリップボードの履歴に残るからです。

すぐに変わること:古いトークンは使えなくなります。サインイン中のブラウザーはサインインしたままで、エージェント、そのトークン、セッションワーカーは動作を続け、キーを持つペアリングしたリレーも動作を続けます。古いトークンを送っていたスクリプトには新しいトークンが必要です。できれば OAR_AGENT_TOKEN を使ってください。ターミナルでは、oar setup --new-token が NEW と入力した後に同じことを行い、リレーを再起動します。

0.9.26 以前が oar copilot で起動したリレーや、手動の --token で起動したリレーは、一度停止して起動し直すまで、スーパーバイザーのコマンドラインに古いトークンを持ち続けます。新しいトークンを生成する前に、それを行ってください。アップグレードの注意点を参照してください。

0.9.27 に更新すると、ヘッダーの下のバナーに Your relay token was readable by agents until this version. Generate a new one. と表示されます。Generate new token(新しいトークンを生成)は上のダイアログを開き、Dismiss(閉じる)はバナーを隠します。隠すのはリレー全体で 1 回です。バナーを閉じた後も新しいトークンが推奨される間は、トークンを置き換えるまで、Security(セキュリティ)タブに小さな点が付き、トークンの行に Recommended(おすすめ)のタグが付きます。

リレーが行っていないのにトークンが変わった場合も、バナーに The relay token was changed outside OAR と表示されます。config.json に authToken が戻された場合や、relay-secrets.json が変更された場合です。あなた自身が行ったのなら閉じてください。そうでなければ新しいトークンを生成してください。これが表示されるのは、サインインしたあなた自身のページだけで、共有ビューには表示されません。

リレーが配信しないファイル #

認証情報が何であっても、リレートークンであっても、OAR のファイルルートはリレー自身のファイルを配信も変更もしません。relay-secrets.json、データベース(oar.db とその -wal ファイルと -shm ファイル、そのバックアップ、書き込み中のバックアップ)、そして config.json です。これらには 403 FILE_PROTECTED が返ります。ファイルブラウザーでは、これらも、これらを含むフォルダーも、名前の変更、移動、削除ができません。メディアギャラリーも、メッセージが名前を挙げたこれらのファイルを配信しません。これらへのリンクやハードリンクも拒否されます。これによってこれらのファイルが外されるのはファイルルートからだけです。エージェント自身のシェルは今も読めます(保護の及ばない範囲を参照)。

ペアリングしたリレー #

ペアリングしたリレーは、互いのリレートークンをもう保持しません。両方が 0.9.27 以降なら、ペアリングでは相手のリレーのペアリングリンクにあるトークンを 1 回だけ、キーの交換に使います。以後、各リレーは自分のキーで相手にサインインします。このキーで開けるのは、リレー同士が呼び出し合うルートだけです。設定、ファイル、ペアリング、セッションの課金、カードや ask への回答は決して開けません(403 REMOTE_RELAY_PEER_SCOPE)。リレーのトークンを置き換えても、キーによるペアリングはもう壊れません。以前にペアリングしたリレーは、両方が 0.9.27 で動くようになってから約 1 分以内に、自動でキーに切り替わります。

  • 双方向。 Also add this relay there(このリレーを相手側にも追加)にチェックを入れると、各リレーが相手からキーを受け取ります。
  • 一方向。 チェックを外すと、リンクのトークンは追加のためだけにメモリ上で使われ、保存されません。相手のリレーはこのリレーに受信のみのキーを渡し、Inbound only(受信のみ)として一覧に表示します。そのリレーはこのリレーを呼び出すことはなく、その Remove(削除)でキーがすぐに取り消されます。こちら側の行には One way(一方向)と表示されます。
  • 追加中のトークン。 両方が 0.9.27 なら、リンクのトークンは追加の実行中だけメモリ上に保持され、キーが動作すればデータベースに書き込まれることはありません。動作するキーなしで終わった追加(古いリレー、または交換の失敗)だけが、キーが動作するまでトークンを保存します。そのように保存されてから削除されたトークンは、SQLite がその領域を再利用するまで、データベースの空きページと oar.db-wal に読み取れる形で残ることがあります。それが気になる場合は、そのリレーのトークンを置き換えてください。
  • Settings → Relays の Re-pair(再ペアリング)は、1 クリックでキーを交換し直します。このリレーが持つものが相手側でもう何も使えない場合や、相手のリレーが古い場合は、アドレスが入力された状態で Add a relay が開きます。そのリレーのペアリングリンクを貼り付けると、エントリがその場で更新されます。
  • Renew key(キーを更新)と Revoke key(キーを取り消す)は、1 つのリレーに対して働きます。キーは 30 日ごとに自動で更新されます。取り消したキーは、更新するまで、またはそのリレーがこのリレーのペアリングリンクから再び追加されるまで無効のままです。再び追加されると、そのリレーは再び動作するキーを受け取ります。そのリレーを完全に締め出せるのは、リレーを削除し、さらに新しいリレートークンを生成した場合だけです。

検証済みの送信元と未検証の送信元 #

ペアリングしたリレーからのプロンプトには、それをサインインさせたキーのリレーの名前が、ここであなたが付けた名前で示されます。リクエストが自分について述べている内容は使われません。

  • 検証済み。 キーで届いたプロンプトです。制限で許される範囲のことができます。
  • 未検証。 ここで確認済みのキーを持たないリレー(0.9.27 より古い OAR、またはまだ確認されていないキー)も、そのセッションには届きます。ただし、そのプロンプトには claimed(未検証)のタグが付き、エージェントはヘッダー行で "(unverified)" と読み、何も開けません。返信のアクセスも、ホップの許容も、プッシュ通知の抑制も、ask も監視もありません。送信側のエージェントにはその理由が伝えられます。0.9.27 より前に保存されたプロンプトも未検証として扱われます。
  • 拒否された名乗り。 別のリレーを名乗るキーは拒否されます(REMOTE_RELAY_ORIGIN_MISMATCH)。キーを持つリレーを名乗る、それ以外の認証情報も拒否されます(REMOTE_RELAY_PEER_KEY_REQUIRED)。拒否はそれぞれログに記録され、そのリレーの行で N refused claims since start として数えられます。リレーごとに最初の 1 件は Inbox に通知を出します。
  • 変わった識別情報は保留されます。 リレーがキーを持つと、またはこのリレーがそのリレーからのキーを持つと、そのアドレスとリレー ID が固定されます。それらが変わるか、そのアドレスで別のリレーが応答すると、そのキーは取り消され、このリレーはそのリレーのために持っているもの(そのリレーがこのリレーに渡したキーやトークン)を何も送らず、その行であなたが Confirm(確認)するまで新しいキーは発行されません。アドレスをキーを受け取ったときのものに戻すと、アドレスの変更だけが原因の保留は解除されます。

ペアリングしたリレーの質問には、そのリレーで、そこにサインインして回答します。Inbox はそれらを読み取り専用で Open there とともに表示し、0.9.27 のリレーなら、その質問を小さなウィンドウで相手側に開く選択肢ボタンも表示します。質問と Inbox を参照してください。

センシティブなファイルの編集 #

Claude、Claude API、DeepSeek のセッションは、Claude Code がセンシティブと判定したファイルを編集する前に、あなたに確認します。そこを変更すると、git、シェル、ツールの動作が変わることがあるからです。.bashrc のようなシェルの起動ファイル、.npmrc、.git/ や .claude/ の下にあるものなどが該当します。このような編集は、autopilot を含むすべてのリレーモードで、Safety check カードで待機します。カードにはファイルと変更全体、そして Allow once(今回だけ許可)と Deny(拒否)が表示されます。回答できるのはあなただけで、エージェントトークンとペアリングしたリレーのキーは拒否されます。許可されるのはその 1 回の編集だけで、回答されないカードはファイルを変更しないまま残します。セッションを監視しているエージェントやペアリングしたリレーが受け取るのは、カードの固定の 1 行目と File: の行だけで、変更内容は受け取りません。

このようなファイルを読むことや、リレーを通じて送ることには確認は求められません。Claude Code が判定しない方法でファイルを書き込むコマンドも同様です。このカードはエージェントの編集に対する確認であって、サンドボックスではありません。

保護の及ばない範囲 #

エージェントトークンは、エージェントのツールとあなたのツールを分けます。サンドボックスではありません。エージェントはリレーと同じオペレーティングシステムのユーザーとして動作し、そのユーザーは今も次のことができます。

  • リレーのファイルを変更する。 エージェントは relay-secrets.json、config.json、データベース、リレーのコードを書き換え、再起動をキューに入れて、自分のトークンを仕込めます。リレーはそれに気付くだけです。起動時にトークンのハッシュをデータベース内のコピーと比較し、The relay token was changed outside OAR と報告します。両方を編集するエージェントは、これをすり抜けられます。同じファイルから、どのセッションのエージェントトークンも作れます。ファイルルートはこれらのファイルを拒否しますが、エージェントのシェルはファイルルートを使いません。
  • ターミナル用の経路を使う。 oar setup --new-token と oar url --sign-in のターミナルの確認は手間を増やすだけで、境界ではありません。エージェントはターミナルを偽装したり、oar agent-token でルートを呼び出したりできます。この方法で行われたサインインは、上で説明したとおり他のすべてのブラウザーに知らされ、ブラウザーの一覧に "via the terminal" と表示されます。そのブラウザーをサインアウトさせてから、トークンを置き換えてください。
  • リレーホスト上のブラウザーのセッションを奪う。 同じマシン、同じユーザーのブラウザーは、Cookie と証明キーをそのユーザーが読める場所に保存します。両方がそろえば完全なセッションになり、それを持つ人は、新しいトークンの作成を含め、Web UI であなたができることを何でもできます。回復するには、新しいリレートークンを生成し、それでサインインしてから、Sign out all other browsers を押します。新しいトークンだけでは、どのブラウザーもサインアウトされません。
  • Cookie だけで開くコンテンツを読む。 ブラウザーが ID やハッシュで自分で読み込む添付ファイル、生成された画像、インデックスされたメディアは、今も証明キーなしで Cookie だけで開きます。そのため、ホストの別のポートで動き、あなたの Cookie を受け取るサーバーは、それらを取得できます。パスで開くファイルはこれに含まれません。それには証明キーかファイル許可が必要です。エージェントトークンなら、いずれにせよこれらすべてを読めます。
  • ペアリングしたリレーの認証情報を読む。 このリレーがデータベースに保存しているもの、そしてかつてリレー用に保存したトークンです。後者はデータベースの空きページに残っていることがあります。キーで開けるのは相手側のリレー用のルートだけで、そのリレーで Revoke key を押せば無効になります。
  • トークンの古いコピーを見つける。 0.9.27 より前のもので、シェルの履歴、バックアップ、コピーした config.json、または以前のバージョンの oar copilot や手動の --token で起動したリレーのスーパーバイザーのコマンドライン(そのリレーを一度停止して起動し直すまで)などです。以前からこのリレーでエージェントを動かしていたなら、更新後に新しいトークンを生成してください。
  • リレーを停止する。 同じユーザーのプロセスはリレーを終了できます。そのため、停止前の oar コマンドの確認は便利な機能であって、保護ではありません。

リレートークン自体は、今もそれを持つ人なら誰にでもすべてを開きます。