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

管理 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/metadataIdP 側でインポートするための SP メタデータ XML(エンティティ ID と ACS)
GET /auth/saml/loginフローを開始します。署名付き AuthnRequest で、IdP へリダイレクトします
POST /auth/saml/acsAssertion Consumer Service

3 つとも公開かつ未認証のルートであり、メタデータ URL の設定があるときだけ存在します。

フロー​

  1. GET /auth/saml/login — AuthnRequest を組み立て(HTTP-Redirect バインディング。署名付き HTTP-POST がフォールバック)、リクエスト ID を /auth/saml にスコープした、ワンタイムの 10 分間 HttpOnly+Secure Cookie に封印します。
  2. IdP がユーザーを認証し、SAML Response を ACS へ POST します。
  3. POST /auth/saml/acs — crewjam は、IdP メタデータで公開された証明書に対する署名、発行者、オーディエンス(SP エンティティ ID)、ACS 受信者、すべてのタイムスタンプ(NotBefore/NotOnOrAfter/IssueInstant。制限されたクロックスキュー)、およびフロー Cookie に対する InResponseTo を検証します。それに加え、アサーション ID は重複排除されます。まだ有効なレスポンスの、バイト単位での 再送は拒否されます。
  4. ユーザーの対応付け — フェイルクローズであり、OIDC フローと同一です。NameID はメールアドレス(形式は emailAddress または unspecified)でなければならず、既存の有効な管理ユーザー と一致する必要があります。SSO はアカウントをプロビジョニングせず、ロールを広げません。発行されるセッションは、パスワードフローのセッションとバイト単位で同じです(同じ HMAC Cookie、同じ IsRoot、同じ 24 時間の adminauth.SessionDuration)。
  5. IdP エンティティ、対応付けられたユーザー、(設定されている場合)アサートされたロール属性を含む login 監査エントリが書き込まれます。

セキュリティ契約​

  • IdP 開始のログインはありません。 AllowIDPInitiated は false です。対応するこちらの AuthnRequest がないアサーションは、直ちに拒否されます。
  • リプレイ耐性。 crewjam は InResponseTo を検証します。アサーション ID キャッシュは、同じアサーションの 2 回目の提示を拒否します。
  • XML の堅牢化。 レスポンスは、解析前に往復検証されます。Go の encoding/xml は、外部エンティティもパラメータエンティティも解決せず、メタデータの取り込みは DTD やエンティティの細工を拒否します(テスト済み)。
  • 未知のメールアドレスは、無効化されたアカウントと同じ拒否を受けます — ユーザーの列挙も、SSO によるサインアップもありません。メールのローカル部はログに到達しません。対応付けの拒否では、ドメインだけが記録されます。
  • オープンリダイレクトはありません。 成功時は、常に / に着地します。
  • アサートされたロール属性は、監査メタデータのみです。権限は常にデータベース上のユーザーレコードから来ます(保護されたセッションのミドルウェアが、リクエストごとにそれを再検証します)。