Add OIDC browser approval and PKCE session handoff for pages CLI
Build and publish container images / images (push) Successful in 14m39s
Release container images / release (push) Successful in 25s

This commit is contained in:
Anya Tokugawa committed 2026-11-01 20:26:45 +09:00
1 parent 2af87b4f58
commit 60f5fb1881
18 files changed
+1397 -23

No files matched your search

+82 -3
View File
@@ -13,7 +13,7 @@
- 旧認証設計にはCookie中心の記載が残るが、実装済みのJSONログインはBearerセッションを発行する。CLIはこのフローを使用し、Web Cookieを抽出しない。
- `data/pageswiki-cli` は信頼されたローカル運用ツールとして維持。遠隔版はサブプロジェクト `pages-cli`、実行名 `pages`(`pages-cli/pages`)とし、DB・Document Storeを直接開かない。
サーバAPI/DBスキーマの追加・変更はない。初期実装はPython 3.9以降の標準ライブラリで動作するUnix系クライアント(fcntl、readline使用)。Windowsネイティブ版は未対応。
初期のパスワード版にはサーバAPI/DBスキーマの追加・変更はない。後続のOIDC引き継ぎでは下記のauthエンドポイントとmanaged component `cli-auth` v1を追加する。Python 3.9以降の標準ライブラリで動作するUnix系クライアント(fcntl、readline使用)。Windowsネイティブ版は未対応。
## 利用方法
@@ -69,6 +69,65 @@ TabはPath候補を取得し、上下キーは当該プロセス内の履歴を
一覧は既存の件数制限を維持し、truncatedを表示する。巨大な全階層を再帰取得しない。読み取りのRaw言語選択は既存サーバの候補選択に従うが、編集は指定言語のheadを必須とし、存在しない場合は拒否する。
## OIDCブラウザ引き継ぎ(2026-11-01実装、本番未反映)
`pages login --oidc` はブラウザを開き、`--no-browser` はURLだけを表示する。
CLI側に受信ポートは不要で、SSH先から開始して別のPC/スマホで承認できる。
接続先のOIDC設定・既存アカウントとの対応を再利用し、新たなprovider登録は不要。
ユーザー名未指定なら認証結果をセッションに保存する。指定済みなら一致を検査し、
不一致時は新セッションを失効させるリクエストを送って保存を止める。
設定上のusernameと認証結果のusernameは別々に保持し、接続先・アカウントの手編集対策を維持する。
### プロトコル
[RFC 8628](https://datatracker.ietf.org/doc/html/rfc8628)の別端末承認・ポーリングの考え方と、
[RFC 7636](https://www.rfc-editor.org/rfc/rfc7636)のS256照合を参照する。
これはPagesWiki専用のsession handoffであり、汎用OAuth Device Authorization Serverの
discovery/grant_type/client registrationへの完全準拠を標榜しない。
| 入口 | 用途 |
| --- | --- |
| POST `/_/auth/cli/start` | formの`code_challenge`、`code_challenge_method=S256`で開始 |
| GET `/_/auth/cli/verify?request=...` | OIDCへの入口と、認証後の本人・接続先確認/承認フォーム |
| GET `/_/auth/oidc?cli=...` | 既存のnonce・state・PKCE・署名検証を使うOIDCフロー |
| POST `/_/auth/cli/verify` | browser session、CSRF、request、確認コード、必要ならTOTPで承認/拒否 |
| POST `/_/auth/cli/token` | formの`device_code`、`code_verifier`を照合して単回交換 |
1. CLIは暗号学的乱数のverifierを生成し、そのSHA-256を送る。サーバは独立した256bitの
public request ID/device codeと32bit確認コードを生成する。
返却するverification URIは同一origin内の固定Path。CLIもPath形式を厳密に検査する。
2. ブラウザは既存CookieがあってもOIDCフローを通る。新しいOIDC callbackで作られた
browser sessionにリクエストを一度だけ束縛する。他ブラウザによる再束縛を拒否。
3. callbackだけではCLIへ認証情報を渡さない。承認画面はterminalの確認コード入力を要求し、
フォーム内にコードを埋め込まない。本人が開始した操作だけ承認するよう警告する。
同一origin検査+browser tokenとrequestに束縛したCSRFを使用する。
4. 登録済みローカルTOTPを検査し、使用済みTOTPの再利用も既存処理で拒否する。
承認後に新たにTOTPが有効になった場合、未検証grantの交換を拒否する。
5. CLIは5秒間隔でpoll。pendingのみ継続し、slow_downで間隔を5秒ずつ最大30秒へ増やす。
拒否・失効・ネットワーク障害・交換応答の喪失では自動再送しない。
6. grantの消費と専用`pw_api_`セッション発行を同じtransactionで確定する。
Principal/Domain membership/承認元browser sessionの失効・期限を再検査する。
セッションは既存の権限評価に従い、期限はDomain設定と承認元session期限の短い方。
MFA levelを保持する。ブラウザCookieや外部provider tokenをCLIへ流用しない。
### 永続化・上限
- managed component `cli-auth` v1に短期状態を保存。既存authテーブルやURIは改名しない。
- grantは5分で失効。確認失敗は最大5回、OIDC開始は1grantあたり3回まで。
- 同一Domainで5分間に64件まで、全体の保持件数は4096件まで。発行前に作成10分超の行を削除する。
上限判定は単一INSERT内で行い、並行発行で超過しない。長期履歴にはしない。
- device code/確認コード/browser tokenはハッシュだけを保存。verifierはCLIのメモリだけ。
新しいAPI Bearerの平文は既存0600セッションファイルだけに保存する。
- 外向け応答はno-store、承認ページはno-referrer・frame禁止。Bearer・verifier・確認コードを
URLに含めない。リクエスト本文をアクセスログへ記録しない運用を前提とする。
- read-onlyインスタンスは発行・承認・交換しない。初期化は通常のmanaged schema手順に従う。
v0.2.0へ戻す前には追加componentを含む互換性を確認し、schema履歴を削除して回避しない。
HTTP応答が失われた場合にセッションが発行済みの可能性は残る。平文BearerをDBへ保持して
再配布する方式は採らず、利用者が設定画面で不要なセッションを失効する。
Ctrl+C時は未交換grantを即時サーバ削除せず、5分の期限で失効させる。
この上限は入口全体のDDoS対策ではない。reverse proxyでの一般的なリクエスト制限は別途必要。
## セキュリティと運用上の制限
- 遠隔はHTTPS必須、証明書検証を無効化するオプションなし。HTTPはlocalhost/127.0.0.1/::1の開発専用。
@@ -82,14 +141,34 @@ TabはPath候補を取得し、上下キーは当該プロセス内の履歴を
Python unittest:origin制限、端末制御文字、別origin redirect遮断、非JSON/403/サイズ上限、TOTP、資格情報権限・symlink・並行実行拒否、authoring/CAS payload、ダウンロード上書き拒否、409時の原稿保全。
設定追加後は12件:既定値/複数接続切替/言語保存、一時上書き、設定表示からのトークン除外、セッション保持中の再接続先変更拒否、手編集での接続先不一致拒否も検査。HTTP統合試験では公開エントリーポイントのconfigure→login→引数省略のls/status/edit→logoutを通す。
Python単体試験18件:既定値/複数接続切替/言語保存、一時上書き、設定表示からのトークン除外、接続先変更拒否、PKCE、poll間隔、URL検査、アカウント不一致、取消、通信断、username未指定でのsession保持、開始API未対応/OIDC無効時の診断を検査する。
Goの `TestRemoteCLIHTTPIntegration`:一時DBと本物のHTTPハンドラでログイン、一覧、編集状態、authoring変換、保存、古いRevision拒否、Rawハッシュ、immutable拒否、存在しない言語拒否、put、ログアウト後の拒否を検査。Pythonがないビルド環境ではこの統合試験をskipする。外部カレンダーや本番資格情報は使わない。
OIDCは署名付き模擬providerによるcallback→承認→交換のHTTP試験、12並行交換で1sessionのみ、
越境・別origin・期限・失効・MFA・不正コード・発行上限・途中失敗rollbackを検査する。
`TestRemoteCLIOIDCIntegration`ではPython CLIから実際のHTTP経由でconfigure→OIDC待機/交換→一覧→authoring保存→logoutを実行する。
この試験のブラウザ操作だけはfixtureの承認ブリッジを使い、実OIDC callbackは別のHTTP試験で検証する。
承認画面のChromium試験は1440px/390pxで実フォームとCookieによる承認を確認する。
本番OIDC providerでの実ログインは未実施。
2026-11-01の実行結果:全Goテスト(キャッシュなし)、全Go vet、関連store/serverのrace検査、
Python 18件、OIDCとパスワードのCLI HTTP統合試験、承認画面と既存CookieログインのChromium試験が成功。
CLI承認画面のモバイルスクリーンショットも確認した。実機Safariは未確認。
前段のイベントログ修正を保持し、本番のv0.2.0・ユーザーPATH上の旧CLIは変更していない。
OIDCは機能追加なので、ログ修正単独のPATCHと区別しv0.3.0で公開する。
サーバーとCLIの両方が必要。開始APIの404/405/501は未対応または接続先の誤りとして明示し、
OIDC無効の403と区別する。エラー時のログイン要求は自動再送せず、資格情報も保存しない。
ソースのチェックポイント:`.deployment-backups/dev-cli-oidc-20261101/source-after.tar.gz`
(SHA-256 `3e4228cd53b4220dffe43a80b4ed02c0bd757a8b3845829b7d3a77a64b0e9c4b`)。
OIDC関連18ファイルのみで、本番DB・鍵・セッション・前段のログ保存修正は含まない。
変更前はGitの`0f686aa`と比較し、対象ファイル単位で復元する。作業ツリー全体をresetしない。
次段階の順序:
1. Ctrl+Pによる検索選択、補完の引用文字/途中カーソル対応、永続履歴の明示opt-in。
2. 新規Page+Path+初回Revisionの原子的な作成API、create/upload-only権限、並行作成の衝突、言語分岐。
3. 競合の対話選択・復旧コマンド、巨大転送のstreamingとキャンセル、mget/mput(globのlocal/remoteを明示)。
4. OIDCブラウザ認証の短命・単回・PKCE相当ハンドオフ。既存device approvalをそのまま転用せず、本人確認・Domain・CLIリクエストを束縛する。
4. OIDC引き継ぎの本番schema適用・サーバ/CLI配布・実providerログイン確認。初期実装は上記のとおり完了、v0.2.0環境への反映は未実施。
5. OS keyring、Windows対応、非公開の短縮リンク引き継ぎ。自動的な公開shareは行わない。