# 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上限を越えられません。