管理 SSO(SAML 2.0)
管理コンソールは、任意の SAML 2.0 アイデンティティプロバイダ(Okta、Entra ID、OneLogin、Shibboleth など)経由のシングルサインオンにも対応します。実装は、github.com/crewjam/saml のサービスプロバイダです(OP-14)。OIDC フローと同様、この機能は オプトイン です。設定がない場合、SAML ルートはマウントされず(404 を返します)、コンソールは変更なくパスワードフローのままです。
有効化
| 環境変数 | 必須 | 意味 |
|---|---|---|
YABANIN_SAML_IDP_METADATA_URL | はい | IdP メタデータ文書の URL。例: https://idp.example.com/saml/metadata |
YABANIN_SAML_IDP_METADATA_URL_FILE | いいえ | メタデータ URL を保持する Docker/K8s のシークレットファイル(直接指定の変数が優先されます) |
YABANIN_SAML_ENTITY_ID | いいえ | SP エンティティ ID。デフォルトは ACS のオリジン(https://admin.example.com) |
YABANIN_SAML_ACS_URL | いいえ | Assertion Consumer Service。デフォルトは https://<admin_domain>/auth/saml/acs(YABANIN_ADMIN_DOMAIN から) |
YABANIN_SAML_ROLE_ATTR | いいえ | ログイン監査エントリに asserted_role として記録される SAML 属性(情報のみ。何も付与しません) |
メタデータ URL は、起動時に一度だけ取得されます。失敗すると目立つログを出し、コンソールをパスワードフローのままにします。中途半端にマウントされた SSO にはなりません。SP の署名鍵ペアは、プロセスごとに一時的です(IdP が検証するのはアサーションであり、こちらのリクエストではありません)。バインディングが要求する場合、AuthnRequest はその鍵で署名されます。
エンドポイント
| ルート | 目的 |
|---|---|
GET /auth/saml/metadata | IdP 側でインポートするための SP メタデータ XML(エンティティ ID と ACS) |
GET /auth/saml/login | フローを開始します。署名付き AuthnRequest で、IdP へリダイレクトします |
POST /auth/saml/acs | Assertion Consumer Service |
3 つとも公開かつ未認証のルートであり、メタデータ URL の設定があるときだけ存在します。