メインコンテンツまでスキップ

管理 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_idOAuth クライアント id
YABANIN_ADMIN_OIDC_CLIENT_SECRET / oidc_client_secretOAuth クライアントシークレット
YABANIN_ADMIN_OIDC_REDIRECT_URL / oidc_redirect_url例: https://admin.example.com/auth/oidc/callback

プロバイダのディスカバリドキュメントと JWKS は、起動時に取得されます。失敗すると目立つログを出して、コンソールをパスワードフローのままにします。中途半端に動作する SSO マウントには決してしません。

フロー​

  1. GET /auth/oidc/login — 10 分間有効な HttpOnly+Secure Cookie(SameSite=Lax。コールバックはトップレベルのナビゲーションとして届きます)に、使い捨ての state/nonce/PKCE の組を発行し、プロバイダへリダイレクトします。
  2. GET /auth/oidc/callback — 定数時間での state 検査、PKCE verifier を使ったコード交換、ID トークンの検証(プロバイダの JWKS に対する署名、issuer、audience、有効期限、nonce)。
  3. ユーザーの対応付け — フェイルクローズ: 検証済みメールは、既存の有効な管理ユーザーと一致しなければなりません。SSO はアカウントをプロビジョニングせず、ロールを広げることもありません。発行されるセッションは、パスワードフローのセッションと 1 バイト単位で同じです(同じ HMAC Cookie、同じ IsRoot)。

ワンタイム Cookie は、コールバックのあらゆる結果で消去されます。そのシークレットは、仕組み上一度だけ使えます。

セキュリティ契約​

  • email_verified が必須です。 メールを検証せずに主張するプロバイダでは、誰もログインできません。
  • 自動プロビジョニングはありません。 未知のメールアドレスは、無効化されたアカウントと同じ拒否を受けます。ユーザーの列挙もなく、SSO によるサインアップもありません。
  • Nonce が ID トークンをこのログインに結び付けます。 別のセッション向けに発行されたトークンは、再送できません。
  • オープンリダイレクトはありません。 成功時は常に / に着地します。ログインのリダイレクトは、常に設定された issuer を対象とします。
  • メールのローカル部はログに残りません。対応付けを拒否したときに記録されるのはドメインだけです。