Extract Grammaratur, Dregarnuhr, Geduldh, Mestionora, Ordoschnellic, Schutzaria, Kunstzeal and Seheweit behind compatible application contracts. Include accumulated editor resilience, navigation and theme UX, remote CLI, storage/schema and DR groundwork, tests and design/operations documentation. Verified: uncached full Go suite; go vet ./...; race tests for all eight components; 11 targeted Chromium tests; Node suites; 19 Python CLI tests; reproducible editor build. No push, release tag or deployment in this checkpoint.
9.9 KiB
Schutzaria の権限と公開範囲の評価契約
2026-11-01、既存の権限・公開範囲の純粋な評価処理を internal/schutzaria に初期分離した。
認証済みPrincipalと対象Domainに対して読み込んだ事実を評価する部品であり、
認証器、DBアクセス、権限変更、匿名公開の確定を一括で置き換えるものではない。
既存の許可・拒否、公開の明示的な承認、URI・JSON・DB・監査記録の形式を維持する。
コンポーネント命名、認証と権限、
Localityの権限・公開 を併読する。
責務と境界
| 所有者 | 担当する処理 |
|---|---|
| Schutzaria | Path読み取りgrant、Locality制限の交差、グループ権限プロファイル、公開上限と意図、公開対象Pathの適格性、ユーザー領域のaudience、既存承認要求の状態遷移 |
| store | Principal/membership/role/groupの有効性を含むDB読込、Objectの全alias検査、所有者権限、epoch/topology、更新transaction、trigger、監査、承認対象とmanifest |
| server | セッション・HTTP認証、endpointと対象の解決、legacy/enforcingの選択、ユーザー領域の追加制限、匿名と認証済み経路の分離、表示・エラー応答 |
| Mestionora等 | 呼出し元が渡す読み取り判定の適用。検索自体で権限を作らない |
依存は server/store → schutzaria → 標準ライブラリの文字列等の処理のみ。 SchutzariaからDB、HTTP、ファイル、時計、server/storeへ依存しない。 認証情報やネットワーク接続を受け取らず、ログに対象本文・ユーザー情報を追加しない。 OIDC/LDAP、Cookie/Bearer、共有用credentialの検証方式は変更しない。
store.ReadPathPolicy、LocalityPolicy、UserSpacePolicy、UserSpacePathPolicy は型aliasで維持。
従来の公開評価・ユーザー領域評価関数は新実装へ委譲し、承認遷移エラーの同一性も保つ。
新しいmigration、既存ACLの再登録、ポリシー設定の初期化は不要。
PathとLocalityの評価
ReadPathPolicy は読み取り専用・要求単位のスナップショット。
構築時に入力sliceを内部mapへコピーし、外部の変更で既存要求の権限が広がらないようにする。
nilとゼロ値は拒否する。新たなglobal cacheやユーザー間の共有cacheは作らない。
- RoleのPath grantは完全一致、Domain grantまたは既存Path wildcardはDomain内の全Path。
- グループscopeはそのPathと配下。
/aと/abを区別し、%・_はワイルドカードにしない。 - Object grantはこのスナップショットへ含めない。Objectが読めても全aliasの存在を公開しない。
- Locality内の該当ユーザー/グループは和集合、祖先と同一Pathの複数Locality制限は積集合。
- 一つでもread/writeが拒否なら、下位の肯定grantで回避できない。
- Localityの肯定grantで追加できるのはread/write/create/uploadのみ。rename/link/delete/manageは増やさない。
- 管理者の回復用制限回避は基礎grantを維持するだけで、新しい権限は作らない。
LocalityAccess.Decide は制限と基礎grantを合成する低水準操作である。
nilのLocality制限は「制限なし」としてbasisを返すが、nilのReadPathPolicyは常に拒否する。
読込失敗と「制限なし」を混同しない。storeは全読込が成功してからスナップショットを返す。
今回、Locality読込エラー時に部分的なReadPathPolicyを返さずnilを返すよう明確化した。
Path正規化・Domain/Principalの選択・アカウント状態の評価は呼出し元の責務。 Schutzariaのコンストラクターに利用者入力のadmin/allフラグを直接渡さない。 既存のscope文字列の意味を保つため、この分離では追加のURL decodeやPath正規化を行わない。
Object取得は引き続きstoreで全ローカルaliasの制限を交差させる。 外国Domain側の制限検査はローカル管理者のshortcutより先に行い、独立したObject grantで 元Domainの制限を迂回させない。正本やPathの更新triggerも既存のまま残す。
権限プロファイル
| プロファイル | 許可するcapability |
|---|---|
| read | read |
| read_write_once | read、create、upload |
| read_write | read、create、write、upload、rename、link |
| upload_only | upload |
どのプロファイルもdeleteや管理権限を暗黙に追加しない。 read_write_onceの「未存在対象のみ」は、更新するtransactionでの存在確認と組み合わせて成立する。 プロファイル判定単独で、既存文書を上書きできないことを保証するわけではない。 Principalのreadonly・停止やmembership/groupの失効は、従来のDB読込で先に適用する。
公開設定と実際の匿名公開
EvaluateLocalityPublication はDomainから下位への、検証済みの順序付きchainを受け取る。
Domainのpublicは公開を許す上限であり、それだけではPageを公開しない。
祖先のauthenticated_aclを下位のpublicで解除できず、不明なpolicyは拒否する。
既存互換として空chainは (allows=true, published=false) の中立値を返す。
呼出し側は実在するDomainと階層を解決し、allowsだけを匿名アクセス許可に使わない。
PublicSemanticPath は予約名前空間・不正なPathの除外だけを担当する。
これがtrueでも、内容の読取権限、alias、現行Revision、hash、公開manifest、
governance/topology versionの検証は省略できない。
匿名要求は既存の公開経路を通し、無効な認証情報を匿名へ降格させない。
既存の自動公開は明示的なStreet/Spot設定に限る。 上位required、設定時のpublisherの現在の権限、固定したPath境界、公開範囲の確認は storeのtransactionに残す。今回の分離で自動公開の既定値を変えたり、旧記事を新たに公開しない。
ユーザー領域はrootと配下の設定が独立しており、rootのprivateを全配下のprivateへ読み替えない。 配下overrideはさらに狭くするだけで、親のprivateを子のpublicで再公開できない。 プロフィール・avatar・管理Path、所有者とDomain管理者の扱いは既存の呼出し元で維持する。 不明なvisibilityの入力検証とDomainの公開上限は保存側で行う。
承認と共有の範囲
ApprovalNextState は現在のpending状態、generation一致、既知のdecisionだけを評価する。
changes_requestedは従来どおりrejectedへ遷移する。ここでapprovedを返しても、
公開manifestを作成したり、reviewer権限を付与したりしない。
要求UUID・Domainの限定、認可、更新transactionとCAS、監査・Inboxは既存側の責務とする。
承認ワークフローの上位requiredの継承、reviewerの委譲制約、 定足数、自己承認の禁止、期限と現行sourceの再検証、承認と公開確定の接続には未完了部分がある。 状態遷移の抽出を、それらの実装完了や本番利用の許可とは扱わない。 共有リンクのpurpose・期限・失効・対象の検証も今回新たに有効化・省略しない。
予算と一貫性の残件
既存の読み取りgrant最大4,096件、Locality制限最大4,096件、Object alias最大10,000件、 ユーザー領域override最大256件を維持する。上限超過やDBエラーは拒否し、途中までの許可一覧を使わない。 評価コアはDBの件数を増やさず、Path評価も保存されたancestor境界に対して行う。
不変の要求内スナップショットは、DB上の全権限情報を単一時点で読み込んだ保証ではない。
LoadReadPathPolicyの通常DB経路はgrantとLocalityを別queryで読む。
更新処理や匿名公開側にあるtransactionを、この分離で取り除かない。
- 権限・アカウント状態・対象更新を同一transaction/versionで固定する経路を拡充する。
- ユーザー領域の遅延DB読込を有界の事前読込へ整理する。Mestionoraの認可callbackで別接続を必要とする制約は残る。
- ReadPathPolicy全体の一貫した読込snapshotとcontext予算、group権限列挙の上限を設計する。
- 自動公開の上位requiredを含む評価、所有者の委譲範囲、承認要求の期限・定足数・現行sourceの再検証を次の分離単位として整理する。
- 説明可能な権限総覧を追加する。付与元・拒否元は閲覧者の権限内でのみ開示する。
- 保護されたPathの粗い更新禁止triggerを、権限影響確認付きの原子的移動・mergeへ置き換える。
- 共有リンクとCampus間ポリシー継承を、purpose・version・失効・対象束縛を持つ別契約として完成させる。
検証と反映
コアでは親子のread/write・基礎grant・肯定grantの組み合わせ、同一Pathの複数制限、 文字列境界、snapshotのコピーと並行参照、公開上限、予約Path、ユーザー領域の絞り込み、 承認状態・generationを検証する。型alias・JSON・エラー同一性と読込失敗の拒否も確認する。 既存の匿名ナビゲーション、公開失効、グループ継承失効、governance、Object/Path認可の試験を維持する。
結果は コンポーネント検証記録 に記録する。 一時DBと合成データで検証し、本番ACLの変更や外部カレンダーへのアクセスは行わない。 ソース変更・テストと、commit・push・本番反映は別段階とする。