Files
pages/docs/design/ja/auth-permissions.md
T
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

5.3 KiB

5. 認証・グループ・権限

状態:パスワード・TOTP・セッション、OIDC、LDAP、SMTPリンク、グループと主要な認可経路は実装済み。全経路の監査完了を意味しません。

2026-11-01、純粋な権限・公開範囲の評価を Schutzaria へ初期分離。 認証・権限情報の読込・更新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上限を越えられません。