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.
64 lines
5.3 KiB
Markdown
64 lines
5.3 KiB
Markdown
# 5. 認証・グループ・権限
|
|
|
|
状態:パスワード・TOTP・セッション、OIDC、LDAP、SMTPリンク、グループと主要な認可経路は実装済み。全経路の監査完了を意味しません。
|
|
|
|
2026-11-01、純粋な権限・公開範囲の評価を [Schutzaria](schutzaria.md) へ初期分離。
|
|
認証・権限情報の読込・更新transactionは既存側に残し、API・ACL設定・公開範囲は変更しません。
|
|
承認の継承・reviewer定足数を実装済みとするものではありません。
|
|
|
|
## 認証から認可へ
|
|
|
|
認証器はPrincipal identityを証明します。その後、Domain membership、グループ・Role、対象操作のcapability、上位Localityの制限を評価します。OIDCのclaimやメールアドレスだけで管理権限を付与しません。
|
|
|
|
Principalにはactive / readonly / suspended / quarantinedの状態があります。membershipや状態の失効は次の要求で反映します。
|
|
|
|
LDAPはドメイン単位で設定します。検索用アカウントで`{{username}}`を
|
|
RFC 4515エスケープして一意なエントリを取得し、そのエントリのユーザーDNで
|
|
再bindできた場合だけ認証成功です。初回だけローカルの一意なユーザー名または
|
|
メールアドレスへ連結でき、その後は`entryUUID`やActive Directoryの
|
|
`objectGUID`など、設定した不変属性とprovider UUIDの組で識別します。DN、表示名、
|
|
メールアドレスを継続ログインの識別子にはしません。自動作成は任意で、作成時は
|
|
ローカルパスワードを持たない通常のmemberに限定します。
|
|
|
|
LDAP/LDAPS、StartTLS、証明書検証、追加CA PEM、検索Base DNとfilter、属性mapping、
|
|
既存アカウントの照合項目、保存済み設定によるログインテストを管理画面から設定
|
|
できます。bindパスワードは暗号化し、利用者パスワードは保存・ログ出力しません。
|
|
LDAPグループをPagesWikiのグループや権限へ同期する処理は認証と分離し、明示的な
|
|
mappingだけを適用する後続タスクです。
|
|
|
|
## セッションの目的を分離する
|
|
|
|
ブラウザはHttpOnlyのホスト限定Cookie、APIは明示的なBearer credentialを扱います。現行はブラウザ用とAPI用のトークン種別を分け、相互に流用しません。「全画面でlocalStorageへBearerを置く」構成にはしていません。
|
|
|
|
adapter、federation、認証challenge、将来のshareはそれぞれ別の検証系です。明示された無効なAuthorizationをCookieで救済しません。Cookie経由の変更には同一origin検証、ログアウトにはPOSTを使います。
|
|
|
|
OIDCはissuer・署名・claim・state/nonce/PKCE・browser bindingを検査します。SMTPリンクは短命・一回限りのchallengeで、配送遅延をログイン要求に持ち込みません。メール一致とメール所有の証明、外部identityの明示的な連結は引き続き整理が必要です。
|
|
|
|
## 権限プロファイル
|
|
|
|
| 表示用プロファイル | 許可する内容 | 許可しない内容 |
|
|
| --- | --- | --- |
|
|
| read | 閲覧 | 全変更 |
|
|
| read/write once | 未存在の対象の新規作成・アップロード、閲覧 | 上書き、再編集、削除 |
|
|
| read/write | 閲覧・作成・更新・rename・link | deleteの暗黙付与 |
|
|
| upload only | 指定範囲の未存在対象へアップロード | 一覧、閲覧、上書き、削除 |
|
|
| group admin / user | グループ内の管理上の役割 | それだけを根拠にした本文権限 |
|
|
|
|
削除は独立したgrantです。新規作成・uploadの可否は正規化後の最終Pathをトランザクション内で検査します。Pathを先に調べ、後で無条件上書きする実装は禁止です。
|
|
|
|
## 管理グループと所有者
|
|
|
|
`campus_admin` はキャンパスとドメイン配置、`domain_admin` はDomain設定・アカウント・グループを管理するビルトイングループです。普通のグループ管理者がこれらを自分へ付与できてはいけません。
|
|
|
|
Quartier・Spotのco-ownerは公開設定等の委譲された管理者です。所有者であることと、上位が許可していない公開を広げることは別です。
|
|
|
|
## TODO
|
|
|
|
- 全変更経路で認可versionと更新対象を同一トランザクションに固定する。
|
|
- 最後の管理者の停止・移管、メール所有、外部identity連結・解除。
|
|
- OIDC/LDAP外部グループの明示mapping、由来を保持した同期・失効・監査。
|
|
- 説明可能な権限総覧:付与元、継承、上位制限、対象操作、失効理由を表示する。
|
|
- PSK継承、adapter、Asset等を含む拒否・競合・再送テストの拡充。
|
|
|
|
個人用 `/u/{username}`、グループ用 `/g/{groupname}` は本文領域と `/_/edit` 等の管理領域を区別します。プロフィール画像変更を本文の無制限履歴と混同しません。ユーザー領域の所有者はプロフィール情報・画像・Wiki root・配下のaudienceを個別に狭められます。`private` は通常のDomain read grantより優先し、所有者と復旧権限を持つDomain管理者だけが読めます。匿名公開はDomainのpublic上限を越えられません。
|