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.
131 lines
9.9 KiB
Markdown
131 lines
9.9 KiB
Markdown
# Schutzaria の権限と公開範囲の評価契約
|
|
|
|
2026-11-01、既存の権限・公開範囲の純粋な評価処理を `internal/schutzaria` に初期分離した。
|
|
認証済みPrincipalと対象Domainに対して読み込んだ事実を評価する部品であり、
|
|
認証器、DBアクセス、権限変更、匿名公開の確定を一括で置き換えるものではない。
|
|
既存の許可・拒否、公開の明示的な承認、URI・JSON・DB・監査記録の形式を維持する。
|
|
[コンポーネント命名](component-names.md)、[認証と権限](auth-permissions.md)、
|
|
[Localityの権限・公開](../locality-access-publication.md) を併読する。
|
|
|
|
## 責務と境界
|
|
|
|
| 所有者 | 担当する処理 |
|
|
| --- | --- |
|
|
| 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の検証は省略できない。
|
|
匿名要求は既存の公開経路を通し、無効な認証情報を匿名へ降格させない。
|
|
|
|
既存の[自動公開](../automatic-publication.md)は明示的な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は既存側の責務とする。
|
|
|
|
[承認ワークフロー](../publication-approval-inbox.md)の上位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認可の試験を維持する。
|
|
|
|
結果は [コンポーネント検証記録](component-names.md#検証記録) に記録する。
|
|
一時DBと合成データで検証し、本番ACLの変更や外部カレンダーへのアクセスは行わない。
|
|
ソース変更・テストと、commit・push・本番反映は別段階とする。
|