Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ mado はログインの確認と、ブラウザと RDP サーバーの間の中
- つなぐ先は設定の `targets` に書いたものに限る。ブラウザが選んだ先はサーバーが発行するトークンに入れて渡すので、ブラウザから任意の宛先は指定できない
- Windows のユーザー名とパスワードはブラウザの中で CredSSP に使う。mado には送らない
- AMT のパスワードも同じで、ブラウザが HTTP Digest の応答を計算する。mado は決まった AMT の WS-Man(`/wsman`)とリダイレクト(SOL)の port にだけ中継する。AMT の port は外に開けない([docs/amt.md](docs/amt.md#ネットワークとセキュリティ))
- AMT と RDP のユーザー名とパスワードは、つなぐ前の画面で「パスワードをこの端末に保存する」を選んでつながったときだけ、ブラウザの中に保存できる(つなぐ先と種類ごと)。取り出せない AES-GCM の鍵(WebCrypto)で暗号化して IndexedDB に置き、mado には送らない。守れるのは「プロファイルのファイルを読まれても平文は出ない」までで、同じブラウザでページを開ける人と、ページに入り込んだスクリプトからは使える。「保存を消去」と、画面のログアウトで消える([docs/amt.md](docs/amt.md#ユーザー名とパスワードの保存))
- Talos のダッシュボードは、mado が `talosctl dashboard` を ConPTY で動かして中継する。コマンドは mado.json で決まり、ブラウザは選べない。バーの「シャットダウン」「再起動」は `talosctl shutdown` / `reboot` を決まった引数で動かす(2 回押しで確定)。talosconfig は `os:operator`(設定は変えられない)のものを DPAPI で保護して置き、名前付きパイプで talosctl に渡す(ディスクに平文を書かない。[docs/talos.md](docs/talos.md#鍵の扱い))
- mado は RDP サーバーの証明書を検証しない(自己署名なので)。代わりにブラウザが、つなぐ先ごとに証明書の SHA-256 の指紋を覚えて比べる(trust on first use)。はじめての先では証明書を見せて信頼するかを聞き、前と違えば強く警告する。断ればユーザー名もパスワードも使わない。mado と RDP サーバーの間に割り込まれても、気づかずに認証を渡さないため。詳しくは [docs/rdp-client.md](docs/rdp-client.md#rdp-サーバーの証明書)
- 証明書は Let's Encrypt から取り、残り 30 日を切ったら取り直す(HTTP-01)
Expand Down Expand Up @@ -90,7 +91,7 @@ MSI を先に入れてもいい。設定が無いとサービスの起動に失
| `webtransport` | WebTransport の UDP の port。既定は `tls` が `acme` のとき https と同じ port(443)。`{ "port": 8443 }` で変え、`false` か port `0` で使わない。msquic が読めないときや UDP で待ち受けられないときは、ログに書いて WebSocket だけで動く |

IdP には戻り先として `https://<host>/callback` を登録する。Entra ID ならアプリロールを作ってユーザーに割り当て、その値を `required_role` に書く。
`/logout` は mado のセッションの Cookie を消すだけで、IdP からはログアウトしない。
`/logout` は mado のセッションの Cookie を消すだけで、IdP からはログアウトしない。画面の「ログアウト」は、`/logout` に移る前に、その端末に保存したパスワードと鍵を消す([docs/amt.md](docs/amt.md#ユーザー名とパスワードの保存))。

ログは `C:\ProgramData\mado\logs\mado.log`。10 MB を超えると `.1` に移す。

Expand Down
3 changes: 3 additions & 0 deletions bun.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

52 changes: 50 additions & 2 deletions docs/amt.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,8 @@ SOL と IDE-R は、無効なら mado の画面のバーの「SOL・IDE-R を有
- シャットダウン(12)、再起動(14)は OS に頼む操作で、AMT がリクエストできると答えたときだけ出る(OS 側の対応が要る)
- 電源の入れ直し(5)は強制再起動とほぼ同じで紛らわしいので出さない
- 出すものは AMT が返す `AvailableRequestedPowerStates` に従う(挙げていなければ今の電源の状態で決める)。状態は 15 秒ごとと、操作の 3 秒あとに読み直す
- 2 回押しで確定する。1 回目でボタンの文が「もう一度押すと強制再起動」のように変わり、バーの状態の文(読み上げにも伝わる)に「もう一度押すと強制再起動します」と出る。3 秒以内にもう一度押すと実行し、押さなければ元に戻る。別のボタンを押すと待ちは取り消す。キーボード(Enter・Space)でも同じ。ダブルクリック(1 回目から 0.4 秒以内)とキーの押しっぱなしは 2 回目とみなさない
- 「電源オン」は 1 回押しで実行する(動いている PC に影響しないので、聞き返さない)
- ほか(シャットダウン・再起動・強制再起動・強制電源オフ)は、動いている PC に影響するので 2 回押しで確定する。1 回目でボタンの文が「もう一度押すと強制再起動」のように変わり、バーの状態の文(読み上げにも伝わる)に「もう一度押すと強制再起動します」と出る。3 秒以内にもう一度押すと実行し、押さなければ元に戻る。別のボタンを押すと待ちは取り消す。キーボード(Enter・Space)でも同じ。ダブルクリック(1 回目から 0.4 秒以内)とキーの押しっぱなしは 2 回目とみなさない
- OS を止めない操作(強制再起動・強制電源オフ)は戻せない操作として、乗せたときと 2 回目を待つ間は赤い字になる
- 「SOL を切断」「SOL に接続」「閉じる」
5. SOL・IDE-R の受け口(16994 / 16995)か SOL・IDE-R が無効なら、SOL にはつながず、バーに「SOL・IDE-R を有効にする」が出る(押すと確かめる窓が出て、有効にできたら SOL につなぐ)
Expand All @@ -52,7 +53,37 @@ SOL と IDE-R は、無効なら mado の画面のバーの「SOL・IDE-R を有
- 起動の様子は SOL に出る(BIOS の画面も SOL に出すよう `UseSOL` を立てる)。終わったら「IDE-R を終了」
- 速さは AMT と回線しだいで、数 MB/秒ほど。Talos の metal ISO(100MB 前後)は、起動に要る分だけ読まれるので数分かかる

ユーザー名は RDP と同じく、つなぐ先ごとにブラウザ(localStorage)に覚える。パスワードは覚えない(ブラウザのパスワードの保存は使える)。
ユーザー名は RDP と同じく、つなぐ先ごとにブラウザ(localStorage)に覚える。パスワードは、「パスワードをこの端末に保存する」にチェックを入れてつながったときだけ、ブラウザの中に暗号化して保存する(下の「ユーザー名とパスワードの保存」。ブラウザのパスワードの保存も使える)。

## ユーザー名とパスワードの保存

AMT と RDP の先では、つなぐ前の画面のパスワードの欄の下に「パスワードをこの端末に保存する」のチェックが出る(既定はオフ)。Talos の先には入れるものが無いので出ない。

- **保存するのはブラウザの中だけ。** mado のサーバーには送らず、置かない(mado はパスワードを受け取らない作りのまま)。保存はその端末のそのブラウザ(プロファイル)だけのもので、ほかの端末には出てこない
- **つなぐ先と種類(AMT / RDP)ごとに、ユーザー名とパスワードを保存する。** 同じ PC でも AMT と RDP は別に持つ。RDP の欄はユーザー名とパスワードだけで、ドメインはユーザー名に `ドメイン\ユーザー` の形で書くので、一緒に保存される
- **保存するのは、チェックを入れてつながったあと。** AMT は電源の状態を読めたとき、RDP は CredSSP を通ってつながったとき。断られたパスワードは保存しない
- **保存があれば、その先を選んだときに欄に入れ、チェックを入れておく。自動ではつながない。** つなぐのは今までどおり「開く」「接続」を押したときだけ(AMT は続けて間違えると締め出すので、押した 1 回につき試すのは 1 度のまま)
- **保存したパスワードで認証を断られたら**(AMT や Windows のパスワードを変えたあと)、「保存したパスワードでは認証できませんでした。入力し直すか、保存を消去してください」と出して、パスワードの欄は空のままにする(同じものをもう一度は送らせない)。保存は残っているので、入力し直してつながれば上書きし、「保存を消去」で消せる。
回線などほかの理由でつながらなかったときは、保存したものを欄に入れ直す。RDP は、サーバーが理由(NTSTATUS)を返して断ったときだけ見分ける(古いサーバーは理由を返さずに切ることがあり、そのときは入れ直す)
- **消し方**
- 「保存を消去」(保存がある先を選んでいるときだけ、チェックの横に出る): その先・その種類の保存を消す
- チェックを外してつなぐ: つながったあとに、その先の保存を消す
- 画面の「ログアウト」: mado のセッションを消す前に、この端末の保存と鍵をすべて消す(ログアウトは、その端末を使い終えるときの操作なので残さない)。セッションの期限が切れてログインし直すだけなら残る。URL に `/logout` を直に打ったときは、画面を通らないので消えない
- mado.json の一覧から無くなった先の保存は、次に画面を開いたときに消す(消す操作を出す場所が無くなるため)
- ブラウザでサイトのデータを消せば、すべて消える

### 置き方と、守れる範囲

そのままは置かない。WebCrypto で **取り出せない(`extractable: false`)AES-GCM(256 ビット)の鍵** を作って IndexedDB(`mado-logins` の `keys`)に置き、
その鍵で暗号化したもの(保存のたびに新しい 96 ビットの IV。追加の認証データに「種類:つなぐ先」)を IndexedDB(`logins`)に置く(`web/saved-login.ts`)。localStorage には置かない。

- 守れること: ブラウザのプロファイルのファイル(IndexedDB の中身)を読んだだけでは、平文のパスワードは出てこない。鍵はブラウザの中からも値として取り出せない(`exportKey` できない)
- **守れないこと**: 同じブラウザ(プロファイル)でこのページを開ける人は、保存したパスワードを使えるし、欄に入ったものを読める。ページに入り込んだスクリプト(XSS、悪意のある拡張機能)も、鍵を使って復号できる。
鍵そのものもプロファイルのファイルの中にあるので、ファイルを読める相手がブラウザの鍵の置き方まで調べれば、いずれ復号できる。OS の資格情報の保管庫ほどは守れない
- そのため、自分だけが使う端末でだけ保存する。共用の端末では保存しない(保存したら、ログアウトで消す)
- 保存が使えないブラウザ(IndexedDB か WebCrypto が無い・止めてある。プライベートウィンドウの一部、https でも localhost でもない先など)では、チェックを出さない。つなぐのは今までどおりできる。
チェックを入れてつながったのに保存できなかったときは「パスワードを保存できませんでした」と出る
- mado の画面は外のスクリプトを読まず(すべて exe に埋め込んだもの)、インラインのスクリプトも無い。mado は今のところ Content-Security-Policy を返していない(この変更で足しても緩めてもいない)

### Talos のコンソールを見る

Expand All @@ -66,6 +97,7 @@ AMT の SOL は、OS からは PCI のシリアル(lspci で「KT Controller」)

WS-Man もリダイレクトも、AMT の認証は HTTP Digest(MD5、qop=auth)。Digest の応答はブラウザが計算する(`web/amt/digest.ts`。MD5 は WebCrypto に無いので `web/rdp/crypto.ts` の実装を使う)。
mado に届くのは計算した応答だけで、パスワードは含まれない。Basic 認証(パスワードがそのまま流れる)は、AMT が使えると言っても使わない。
パスワードを保存したとき(上の「ユーザー名とパスワードの保存」)も同じで、保存はブラウザの中だけにあり、mado には送らない。

### WS-Man(電源)

Expand Down Expand Up @@ -129,8 +161,12 @@ addon-fit は枠の大きさから行と桁を出す公式の部品(1KB 足ら
## 試験

- `bun test web/amt`: Digest(RFC 2617 の例)、WS-Man の封筒と返事、偽の AMT(`web/amt/amt.fixture.ts`)とのリダイレクトと SOL、IDE-R(OPEN_SESSION、TEST_UNIT_READY・READ_CAPACITY・緩衝より大きい READ_10・範囲の外の読み出し・PING)、起動の設定の手順
- `bun test web/saved-login.test.ts`: パスワードの保存(保存・読み出し・上書き・消去・先と種類ごとの分離・置いたものに平文が無く鍵を取り出せないこと・使えない環境)。WebCrypto は bun のもの、IndexedDB は fake-indexeddb(下の「IndexedDB の偽物を選んだ理由」)。`bun test web/two-press.test.ts`: 2 回押しと、1 回押しの「電源オン」
- `dotnet run --project tests/Mado.Tests.csproj`: 設定、WS-Man の中継(Digest を確かめる偽の AMT)、SOL の中継、トークンと先の種類
- `tools/amt-e2e/`: Linux のコンテナで mado(`tls: off`)と偽の AMT を動かし、本物の `web/amt` のクライアントで電源と SOL を試す(`e2e.ts`)。`ui.cjs` は headless の Chromium で画面を操作し、`out/` に画面を残す。
電源は、「電源オン」が 1 回押しで入ることと、強制電源オフが 2 回押しのままであることを見る。
パスワードの保存は、違うパスワードを保存しないこと、つながると保存して次から欄に入ること(自動ではつながない)、IndexedDB に平文が無く鍵を取り出せないこと、ほかの先に持ち越さないこと、保存したもので断られたら 1 度でやめて入れ直さないこと、上書き、「保存を消去」、チェックを外してつなぐと消えること、ログアウトで消えることを見る。
試験の mado は http なので、そのままの Chromium には WebCrypto が無い。まずそのまま開いて、チェックが出ずに AMT を開けることを見てから、`--unsafely-treat-insecure-origin-as-secure` を付けた Chromium で保存を試す。
Talos のダッシュボードの先(`z440-talos`)も並べ、一覧から開くと `/ws/talos` につなぎ、閉じた理由と「もう一度開く」が出るところまで試す(Linux の mado には ConPTY が無いので、talosctl は動かさず「not supported」で閉じる。[talos.md](talos.md#試験))

```powershell
Expand All @@ -144,6 +180,18 @@ wslc run --rm --network amtnet -v "${PWD}:/src" -w /tmp mcr.microsoft.com/playwr

本物の AMT では試していないところ: SOL の終わり方(0x22 と 0x12 を送ってから閉じる)、TLS(16993 / 16995)、OS のシャットダウンと再起動(12 / 14)、IDE-R(偽の AMT は BIOS の読み出しの一部だけをまねる。本物の BIOS は MODE SENSE・READ_TOC・GET_CONFIGURATION なども送る)。

### IndexedDB の偽物を選んだ理由

bun には WebCrypto(`crypto.subtle`)はあるが IndexedDB が無い。パスワードの保存の単体テストに偽物が要るので、2026-11-11 に比べた(版と大きさは npm の registry)。

| 候補 | 最新 | ライセンス | 大きさ(展開後) | 依存 | 結論 |
| ----------------------------------------------------------------- | ------------------- | ----------------- | -------------- | -------------- | ------------------------------------------------------------------------------------------------------------------ |
| **[fake-indexeddb](https://github.com/dumbmatter/fakeIndexedDB)** | 6.2.8(2026-11 更新) | Apache-2.0 | 0.35MB | なし | 採用(devDependencies)。メモリの中だけの実装。bun 1.4.4 で、取り出せない CryptoKey を置いて読み戻せることを確かめた |
| [indexeddbshim](https://github.com/indexeddbshim/IndexedDBShim) | 19.0.7(2026-10) | MIT か Apache-2.0 | 10.8MB | WebSQL(SQLite) | 大きく、SQLite のネイティブの部品が要る。試験の偽物には重い |
| 自分で書く(保存の層を挟んで、試験では Map に差し替える) | - | - | - | なし | 依存は増えないが、IndexedDB を呼ぶところ(transaction・鍵の置き方)を単体テストで通せなくなる |

画面(exe)には入らない。使うのは `web/saved-login.test.ts` だけ。

### IDE-R で起動しないとき

- AMT の設定で IDE-R が有効か(MEBx の「SOL/IDER」、または AMT の Web)
Expand Down
Loading
Loading