Files
Anya Tokugawa d5d21b7841
Build and publish container images / images (push) Successful in 9m34s
Release container images / release (push) Successful in 36s
Refactor architecture into eight components and consolidate reliability work
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.
2026-11-01 15:23:31 +09:00

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・本番反映は別段階とする。