Skip to content

U2 起動の前の確かめと symlink(#3604 #3864) - #4027

Draft
takemi-ohama wants to merge 11 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u2-account-dir
Draft

takemi-ohama wants to merge 11 commits into
sprint/3604-3864-relay-accountsfrom
impl/3604-u2-account-dir

Conversation

@takemi-ohama

@takemi-ohama takemi-ohama commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

概要

実装の単位 U2「起動の前の確かめと symlink」(実装計画 issues/issue-3604-3864-plan.md の Task 4)。

  • plugins/ndf/src/ndf/domains/relay/account_dir.py(新設): is_local・link_shared・planned_links・config_file・shared_config_file・effective_env・auth_overrides・check_local・check_config・check_account と型 Checked・Local・Links。飛ばす理由(REASONS)と RELOGIN_REASONS
  • account_registry.py: mark_relogin
  • 満たす受け入れ条件: 3604:4・3604:5・3604:8・3604:9(印)・3604:10・3604:12・I1・I2・I3・I5
  • 同期・書き戻し・使用の届け(sync_config・prepare・settle ほか)は U3 の範囲で、ここでは作らない

実装の中で決めたこと

  • check_account の引数を Launch(env・cwd・argv)にまとめた。 詳細設計のシグネチャは引数が 8 つで、このリポジトリの PLR0913(上限 6、抑制できない)に当たる。子が実際に受け取る 3 つは U3 の ready・prepare も同じ組で渡すので、1 つの型にした(設計への指摘)
  • 型 Resolved をこの単位で作った。 effective_env の返りで、Checked が持つため。起動指示は U3 の範囲に挙げていたが、計画の Task 4 の effective_env に要る。pins(キーの子の照合した設定への固定)はキーの子の単位で使うので入れていない(設計への指摘)
  • Resolved.profile を足した。 有効なプロファイルの認証の形(oidc_federation か)を auth_overrides が Resolved だけで判定するためで、設計の型には無い(設計への指摘)。プロファイルの置き場は WIF の文書のとおり <設定ディレクトリ>/active_config(無ければ default)と configs/<名前>.json の authentication.type
  • サーバーから取った管理の設定の出所の名前を 管理の設定(remote-settings.json) にした。 設計の 管理の設定(サーバーの控え) は、検査 banned-word が「控え」を廃止した語として落とす
  • 管理の設定の保存先はモジュールの定数(MANAGED_FILES・MANAGED_DIR)だけにし、effective_env の引数にしなかった。 テストは定数を差し替える(引数を足すと auth_overrides との呼び方が分かれるため)
  • 「認証の値の変数」は、子の環境の表の account-drop の行のうち secret が真のもの(ANTHROPIC_API_KEY・ANTHROPIC_AUTH_TOKEN・CLAUDE_CODE_OAUTH_TOKEN)にした。 表から引き、一覧を写さない
  • プロジェクトとローカルの env で重ねない変数は CLAUDE_CONFIG_DIR・CLAUDE_CODE_OAUTH_TOKEN・CLAUDE_CODE_OAUTH_SCOPES の 3 つ。 設計の「ほか」の中身は確かめていない
  • 読めない利用者・プロジェクトの設定は無いものとして扱い、読めないプロファイルは auth_unresolved にした(設計の「解けない源の扱い」に行が無い)
  • account_registry に BASE_NEXT_FILE・PENDING_FILE(ファイル名だけ)を足した。LOCAL_NAMES と check_local が使う
  • cross-review の修正(r1〜r5、9c8e6d6c7〜3f25fdd2f)のうち設計に根拠の無い防御を、新しいコミット 8a2afc1 で戻した。 脅威の範囲は「うっかり」と「権限の無い人」だけで、同じ利用者の権限で設定ディレクトリに罠を置く攻撃は範囲の外(設定ディレクトリに書ける者は、symlink を使わずとも認証ファイルを直に読める)。判断の基準は「設計の文言に根拠があるか」
    • 戻したもの: symlink・ハードリンクを親の成分・配下・inode までたどる拒否(保護する実体の一覧・backups の照合・Unsafe)、共有のディレクトリを起動のたびに再帰で走査する処理(深さ・件数の上限)、管理の設定の解釈のうち設計に無いもの(policyHelper・控えの適用の保留・managedSourcesBehavior・起動時だけ読む変数)、primaryApiKey、起動引数の細かい解釈(-- 以降・-pc の連結・--bare・--restricted)、mark_relogin の FIFO・親の差し替え・予測できる一時名への備え(set_capacity と同じ _read → 書き換え → write の形へ)、_relink の一時名の乱数化(設計の <項目>.<pid>.link へ)
    • 残したもの: managed-settings.d の隠しファイルを読まない・在るのに列挙できなければ auth_unresolved(r1-4・r1-5)、相対の ANTHROPIC_CONFIG_DIR を子の作業ディレクトリで解く(r1-7)、Resolved の repr に env・helper を出さない(r1-9、I5)、check_account の拒否を項目名と stamps を持つ Refused(str の子)で返す(r1-11。ready の Probe.stamps が失敗でも判定に使った源を持つため)、共有側の projects・settings.json の作成の競合で落ちない(r1-12)、1 回の stat で stamps と在るか無いかを取り権限の失敗を解けないとする(r2-9)、umask に関わらず account.json が 0600(r3-5。write の fchmod で満たし、テストを残す)
    • 見送った 3 件: r4-2(走査の上限)は再帰の走査ごと消えた。r5-7(prepare の link_shared の失敗の扱い)は Unsafe を消して設計どおり OSError だけになった。r4-3(<共有>/ndf から ndf/accounts/<別名>/ の認証ファイルへ届く)は塞がず設計への指摘に残す(I1 の文言は共有側の .credentials.json で、ndf を外すと子のフックが relay.current・relay.version を読めない)
    • 設計への指摘として残すもの: r4-3 の ndf/accounts の扱い、/login で保存した API キー(primaryApiKey)を「当たる条件」に入れるか、管理の設定の policyHelper・控えの適用の保留と --bare・--restricted を実効値の作り方に入れるか、argv の読み方(今は名前の一致だけで、値として渡った --settings も読む)

テスト

テストは CI で走らせる(.ndf/project.json の test.ci.only)。先に push したテストだけのコミット: e7413eb。実装のコミット: f7f528d(Launch と出所の名前に合わせてテストも直した)

実装の時点の差分の行数(uv.lock・docs/contracts/env.md を除く): 4 files changed, 1156 insertions(+)(src 575 行・tests 581 行)

戻した後の差分の行数(git diff --shortstat origin/sprint/3604-3864-relay-accounts...HEAD -- . ':(exclude)**/uv.lock'): 4 files changed, 1281 insertions(+)(src 620 行・tests 661 行)。cross-review の修正の後は 2,466 行だった

関連: #3604 #3864

🤖 Generated with Claude Code

https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP

takemi-ohama and others added 3 commits November 21, 2026 22:37
U2(実装計画の Task 4)。account_dir の is_local・link_shared・planned_links・config_file・
shared_config_file・effective_env・auth_overrides・check_local・check_account と、
account_registry の mark_relogin を縛る(3604:4・5・8・9・10・12、I1・I2・I3・I5)。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
U2(実装計画の Task 4)。account_dir に is_local・link_shared・planned_links・config_file・
shared_config_file・effective_env・auth_overrides・check_local・check_config・check_account と
型 Links・Local・Resolved・Checked・Launch、理由の符号(REASONS・RELOGIN_REASONS)を置く。
account_registry に mark_relogin と、同期の途中の記録・保留の更新のファイル名を足す。

check_account は引数の上限(PLR0913、6 つ)に合わせ、子の環境・作業ディレクトリ・起動引数を
Launch にまとめて受ける。サーバーから取った管理の設定の出所の名前は remote-settings.json にする
(廃止した語を避ける)。テストはこの 2 点に合わせて直した。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
- 起動引数を `--` で止め、値を取るオプションの値を読まない。区切りの解けない引数は auth_unresolved(r1-1)
- 制御キーだけの管理の設定をポリシーなしとみなす(r1-2)。選ばれた policyHelper は auth_unresolved(r1-3)
- managed-settings.d の隠しファイルを読まず、検査・列挙に失敗したら auth_unresolved(r1-4・r1-5)
- サーバーから取った写しの保留される変数は下の源の値を打ち消さず、ANTHROPIC_CONFIG_DIR は重ねない(r1-6)
- 相対パスの ANTHROPIC_CONFIG_DIR を子の作業ディレクトリから解く(r1-7)
- 設定ファイルの primaryApiKey を auth_overridden にする(値は出さない。r1-8)
- Resolved の repr から env と helper を外す(r1-9)。子が開く settings.json のパスの stat も持つ(r1-10)
- 失敗の返りを str の Refused にし、項目名と stamps を持たせる(r1-11)
- 共有側の作成の競合で先行の項目を使い、一時の名前を排他的に取り、認証ファイルを指す別名を張らない(r1-12〜14)
- mark_relogin は実体のディレクトリと独立した account.json にだけ書く(r1-15)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
takemi-ohama and others added 4 commits November 21, 2026 23:16
…3864)

- 短縮オプションの連結(-pc・-pnx)を commander と同じ規則で分けて読む(r2-1)
- --bare と実効の CLAUDE_CODE_SIMPLE は OAuth を読まないので auth_overridden、--restricted は利用者・プロジェクト・ローカルの設定を読まない(r2-2)
- サーバーから取った写しがポリシーを持っても、管理の設定のファイルの policyHelper は auth_unresolved(r2-3)
- 起動の時点にだけ読む選択の変数(ANTHROPIC_PROFILE・フェデレーションの 2 つ・ANTHROPIC_CONFIG_DIR)を写しから重ねない(r2-4)
- planned_links が link_shared と同じ拒否の判定を使い、拒んで起動の後に無い settings.json を不在として判定する(r2-5)
- 共有の項目の symlink を参照ごとにたどって途中の名前と置き場を見て、ディレクトリの配下の symlink も見る(r2-6)
- mark_relogin は account.json を非ブロッキングで開いて型とリンク数を確かめる(r2-7)。確かめたディレクトリを FD で固定し、排他的に作った一時ファイルから置き換える(r2-8)
- _layer は 1 回の stat で印と在るか無いかを決める(r2-9)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…27 の r3。#3604 #3864)

- 参照先を OS と同じ順に成分ごとに解き、symlink を経た後の途中の成分と行き着いた先で、保存先への進入とアカウント固有の名前を見る(`..` は解いた後の親へ上がる)
- 共有側そのものかその祖先へ行き着く別名、認証・設定のファイルの名前の通常ファイル、保護する実体の別名のハードリンクを公開しない
- 拒んだ項目でアカウント側に残す利用者の symlink も検査し、届くなら消さずに起動を not_account_local で拒む
- 起動の前の確かめは settings.json だけを見て共有の履歴の木を歩かない。配下の走査は深さと列挙の数に上限を置き、保護する実体にハードリンクが無ければ配下の stat を省く
- mark_relogin の一時ファイルを fchmod で 0600 に確定する(umask に左右されない)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…3864)

- 見終えたディレクトリの判定を拒否も含めて持ち、後の項目で使い回す。循環は今たどっている経路だけで見て、循環か上限で見切った間の偽の判定は使い回さない(r4-1)
- 保護する実体の一覧はアカウント固有の名前を lstat して作り(列挙できないアカウントの中も見る)、backups の配下の通常ファイルも含める。一覧を確定できなければ、別名を持つファイルを公開しない(r4-4)
- 配下のファイルと symlink の名前にも is_local() を当てる(旧形式の .config.json・認証ファイルの名前の symlink)(r4-5)
- 拒んだ項目でアカウント側に残す通常ファイルとディレクトリも、保護する実体の別名か・配下の参照先を見て、届けば起動を拒む(r4-6)
- link_shared は残す項目が届くとき全項目の処理の後に Unsafe を上げ、起動を止める(r4-7)
- 別名を持たないファイル(st_nlink が 1)は保護する実体の一覧を作らない。check_account の settings.json の確かめで登録の保存先を列挙しない(r4-8)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…027 の r5。#3604 #3864)

- 保護する実体を is_local と同じ規則で集め、前方一致の名前を列挙で拾う。列挙できなければ一覧を未確定にする(r5-1)
- 保護する名前が symlink なら参照先の inode を保護する(共有の .claude.json から dotfiles へ。r5-2)
- アカウント側に残す項目(飛ばした実体・アカウント側にだけある実体)を、共有側の判定によらず検査する(r5-3)
- アカウント側の走査で、自分の設定ディレクトリへ至る途中の成分は進入とみなさない(r5-4)
- 保護一覧は別名を持つファイルに当たってから作り、共有側とアカウント側の走査で 1 つを使う(r5-5)
- ディレクトリの列挙と symlink の解決を呼び出しの中で使い回し、見直しでも列挙し直さない(r5-6)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
takemi-ohama and others added 4 commits November 22, 2026 00:40
#3864)

cross-review の修正(r1〜r5)のうち、承認済みの設計に根拠の無い防御を戻し、f7f528da3 の形へそろえる。
脅威の範囲は「うっかり」と「権限の無い人」だけで、同じ利用者の権限で設定ディレクトリに罠を置く攻撃は範囲の外。

戻したもの:
- symlink・ハードリンクを親の成分・配下・inode までたどる拒否(保護する実体の一覧・backups の照合・Unsafe)
- 共有のディレクトリを起動のたびに再帰で走査する処理(深さ・件数の上限)
- policyHelper・控えの適用の保留・managedSourcesBehavior・起動時だけ読む変数の解釈、primaryApiKey
- 起動引数の細かい解釈(-- 以降・-pc の連結・--bare・--restricted)
- mark_relogin の FIFO・親の差し替え・予測できる一時名への備え(set_capacity と同じ形へ)
- _relink の一時名の乱数化(設計の <項目>.<pid>.link へ)

残したもの(設計の文言に根拠のある直し):
- managed-settings.d の隠しファイルを読まない・列挙できなければ auth_unresolved(r1-4・r1-5)
- 相対の ANTHROPIC_CONFIG_DIR を子の作業ディレクトリで解く(r1-7)
- Resolved の repr に env・helper を出さない(r1-9)
- check_account の拒否が項目名と stamps を持つ Refused(r1-11。ready の Probe.stamps のため)
- 共有側の作成の競合で落ちない(r1-12)
- 1 回の stat で stamps と在るか無いかを取り、権限の失敗を解けないとする(r2-9)
- umask に関わらず account.json が 0600(r3-5。write へ戻して満たす。テストを残す)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYHP7z4QjHh8vkcxvdbGUP
…3604 #3864)

- _relink: 一時の名前 <項目>.<pid>.link に symlink でない実体があれば消さずに FileExistsError(I2)。残りの symlink だけ張り直す(r1-2)
- _flag: claude_args の表で読み、-- より後の位置引数とほかのオプションの値を --settings・--setting-sources と読まない(r1-3)。claude_args.options を足した
- _profile: active_config が UTF-8 でない・名前が configs/ の直下のファイルにならないときは例外を出さず auth_unresolved(r1-10)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… を解けないとする

- r2-1: 固定の一時名を消さず、呼び出しごとに mkdtemp で作ったディレクトリの中で張って移す
- r2-2: ANTHROPIC_CONFIG_DIR に NUL があればファイルに触れる前に auth_unresolved とする

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…を次に片付ける(PR 4027 の 3 回目の r3。#3604 #3864)

- r3-1: os.replace をやめ、確保した一時の名前へ os.rename で退避してから中身を見る。symlink なら消して排他で張り直し、
  実体なら os.link で元の名前へ戻して skipped に入れる。ディレクトリは ENOTDIR で移らずに残る
- r3-2: mkdtemp・rmdir と成功時の空振りの unlink をなくし、`.ndf-relink.<項目>.<乱数>` を os.symlink の排他で作る。衝突したときだけ引き直す
- r3-3(実装側): link_shared の最初に _sweep が中断した一時の名前を片付ける(symlink は消し、実体は元の名前が空いていれば戻す)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant