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