管理 SSO(OIDC)
管理コンソールは、任意の OpenID Connect プロバイダ(Google Workspace、Entra ID、Okta、Dex など)経由のシングルサインオンに対応しています。PKCE(S256)付き Authorization Code フロー、state の CSRF トークン、nonce を使います。この機能はオプトインです。設定がない場合、コンソールは変更されず、パスワードフローのままです。
有効化
4 つの値をすべて設定する必要があります。1 つでも欠けると SSO はオフのままです。
環境変数 / config.yaml(admin:) | 意味 |
|---|---|
YABANIN_ADMIN_OIDC_ISSUER / oidc_issuer | プロバイダの issuer URL。例: https://accounts.google.com |
YABANIN_ADMIN_OIDC_CLIENT_ID / oidc_client_id | OAuth クライアント id |
YABANIN_ADMIN_OIDC_CLIENT_SECRET / oidc_client_secret | OAuth クライアントシークレット |
YABANIN_ADMIN_OIDC_REDIRECT_URL / oidc_redirect_url | 例: https://admin.example.com/auth/oidc/callback |
プロバイダのディスカバリドキュメントと JWKS は、起動時に取得されます。失敗すると目立つログを出して、コンソールをパスワードフローのままにします。中途半端に動作する SSO マウントには決してしません。
フロー
GET /auth/oidc/login— 10 分間有効な HttpOnly+Secure Cookie(SameSite=Lax。コールバックはトップレベルのナビゲーションとして届きます)に、使い捨てのstate/nonce/PKCE の組を発行し、プロバイダへリダイレクトします。GET /auth/oidc/callback— 定数時間での state 検査、PKCE verifier を使ったコード交換、ID トークンの検証(プロバイダの JWKS に対する署名、issuer、audience、有効期限、nonce)。- ユーザーの対応付け — フェイルクローズ: 検証済みメールは、既存の有効な管理ユーザーと一致しなければなりません。SSO はアカウントをプロビジョニングせず、ロールを広げることもありません。発行されるセッションは、パスワードフローのセッションと 1 バイト単位で同じです(同じ HMAC Cookie、同じ
IsRoot)。
ワンタイム Cookie は、コールバックのあらゆる結果で消去されます。そのシークレットは、仕組み上一度だけ使えます。