SAML によるシングルサインオンの仕組み

公開

会社で使う Web サービスのログイン画面で、そのサービス用のパスワードを持たずに、会社のアカウントでログインできることがある。この裏では、SAML という取り決めが使われていることが多い。

この記事では、会社員が会社のアカウントで、仕事で使う Web サービス(app.example.com)にログインする場面を例に、SAML の仕組みを追う。

SAML とは

会社では、仕事で使う Web サービス(チャット、勤怠、経費精算など)がいくつもある。サービスごとに ID とパスワードを作る形では、社員と管理者の両方に負担がある。

  • 社員
    • サービスの数だけパスワードを覚える
    • サービスを開くたびにログインし直す
  • 会社の管理者
    • 退職した人のアカウントを、サービスごとに止める。1 つでも止め忘れると、退職した人がログインできる
    • 多要素認証を必須にしたくても、サービスごとに設定がばらばら

SAML(Security Assertion Markup Language)は、ログインを別のサービスに任せ、その結果を受け取るための取り決め。

標準化団体の OASIS が定めていて、いま使われているのは 2005 年に出た SAML 2.0。

この記事の例では、会社のアカウントを idp.example.net というサービスが管理している。

  • 本人であることを確かめる作業(パスワードの入力、多要素認証)は、idp.example.net が行う
  • app.example.com は、idp.example.net から「ログインしたのはこの人」という結果だけを受け取る
  • app.example.com は、SAML でログインする社員のパスワードを見ないし、保管もしない
flowchart LR
    U["社員"]
    I["idp.example.net<br>パスワードを保管<br>本人を確かめる"]
    S1["app.example.com"]
    S2["別の Web サービス"]
    U -->|"ID とパスワード"| I
    I -->|"ログインした人の情報<br>(ブラウザ経由)"| S1
    I -->|"ログインした人の情報<br>(ブラウザ経由)"| S2

社員は idp.example.net に 1 回ログインすれば、つながっている Web サービスをパスワードなしで開ける。この使い方を SSO(Single Sign-On、シングルサインオン)と呼ぶ。

SAML が決めているのは、app.example.com と idp.example.net の間のやり取り。

  • app.example.com が idp.example.net にログインを頼む方法
  • idp.example.net がログインした人の情報を app.example.com に渡す方法
  • app.example.com が、受け取った情報が本物であることを確かめる方法

やり取りするメッセージは XML で書く。

登場する 4 者と、事前の登録

SAML のログインには、次の 4 者が出てくる。

SAML での呼び名 この記事の例 何か どこにあるか
ユーザー ログインする社員 人 画面の前
ブラウザ Chrome など プログラム 社員の PC
SP(Service Provider) app.example.com ログインの結果を受け取る Web サービス サービスの運営者のサーバー
IdP(Identity Provider) idp.example.net ログインを受け持つサービス IdP の運営者のサーバー

IdP の役をするサービスには、Okta や Microsoft Entra ID などがある。会社はこうしたサービスを契約し、社員のアカウントをそこで管理する。

この記事の例の app.example.com は、いくつもの会社が契約して使う Web サービスで、会社ごとに使っている IdP が違う。

ログインする社員の会社のドメインは example.org、その会社が契約している IdP は idp.example.net。

SAML を使うには、SP と IdP が、お互いの情報を相手に登録しておく必要がある。登録するのは、会社の管理者。

管理者は、app.example.com の中にある会社用の設定画面と、IdP の管理画面を操作する。次の図の矢印は、管理者がどちらの情報をどちらへ登録するかを表す。

flowchart LR
    SP["SP(app.example.com)"]
    IDP["IdP(idp.example.net)"]
    SP -->|"SP のエンティティ ID<br>ACS URL"| IDP
    IDP -->|"IdP のエンティティ ID<br>SSO URL<br>IdP の証明書"| SP

IdP に最低限登録する SP の情報は 2 つ。

名前 何か この記事の例
SP のエンティティ ID IdP が SP を見分けるための名前。URL の形で書くことが多く、その URL で自分のメタデータ(下で説明)を公開することもある https://app.example.com/saml/metadata
ACS URL ログインの結果を IdP から受け取る、SP の URL。ACS は Assertion Consumer Service の略 https://app.example.com/saml/acs

SP に最低限登録する IdP の情報は 3 つ。

名前 何か この記事の例
IdP のエンティティ ID SP が IdP を見分けるための名前 https://idp.example.net/saml/metadata
SSO URL SP がログインを頼むときにブラウザをリダイレクトする、IdP の URL https://idp.example.net/saml/sso
IdP の証明書 IdP の公開鍵が入ったファイル。IdP が付けた署名を SP が確かめるのに使う

メタデータ

上の情報を 1 つずつ手で入力すると、打ち間違えやすい。証明書は長い文字列なので、特に間違えやすい。

そこで SP と IdP は、それぞれ自分の情報を 1 つの XML ファイルにまとめて相手に渡す。このファイルを メタデータ と呼ぶ。相手の管理画面や設定画面に読み込ませると、項目が埋まる。

Microsoft Entra ID や AD FS では、メタデータを「フェデレーション メタデータ」と呼んでいる。

IdP(idp.example.net)のメタデータの例。

<md:EntityDescriptor
    xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata"
    xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
    entityID="https://idp.example.net/saml/metadata"
    validUntil="2027-11-21T00:00:00Z">
  <md:IDPSSODescriptor protocolSupportEnumeration="urn:oasis:names:tc:SAML:2.0:protocol">
    <md:KeyDescriptor use="signing">
      <ds:KeyInfo>
        <ds:X509Data>
          <ds:X509Certificate>MIIC...(略)</ds:X509Certificate>
        </ds:X509Data>
      </ds:KeyInfo>
    </md:KeyDescriptor>
    <md:SingleSignOnService
        Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect"
        Location="https://idp.example.net/saml/sso"/>
  </md:IDPSSODescriptor>
</md:EntityDescriptor>

SP に登録する IdP の情報は、メタデータの次の場所に入っている。

登録する情報 メタデータの中の場所
IdP のエンティティ ID EntityDescriptor の entityID
SSO URL SingleSignOnService の Location
IdP の証明書 KeyDescriptor の中の X509Certificate(証明書を Base64 で文字列にしたもの)
  • IDPSSODescriptor は、この要素の中が IdP としての情報であることを表す
  • SP のメタデータも同じ形
    • エンティティ ID は EntityDescriptor の entityID に入る
    • ACS URL は SPSSODescriptor の中の AssertionConsumerService に入る
  • 書き方は SAML 2.0 の仕様で決まっているので、どの IdP のメタデータも骨組みは同じ。任意の項目や、SAML 以外の拡張をどこまで書くかは IdP ごとに違う

メタデータの渡し方は 2 つある。

  • ファイルで渡す
    • 管理者が IdP の管理画面からダウンロードし、SP の設定画面にアップロードする
  • URL で渡す
    • IdP が公開しているメタデータの URL を、SP に登録する。SP が対応していれば、定期的に読み直す

違いが出るのは、有効期限が近づいた IdP の証明書を入れ替えるとき。

  • URL で渡していれば、SP が読み直したときに新しい証明書も取り込まれる
  • ファイルで渡していると、管理者が新しいメタデータをアップロードし直すまで、SP は古い証明書のまま。IdP が新しい鍵で署名を始めると、全員がログインできなくなる

メタデータの仕様上は、新旧の証明書を両方載せられる。実際に新旧を並べて持てるかは IdP の製品による。Entra ID では、新しい証明書を作った時点で、使い始める前からメタデータに載る。

  • 証明書を 2 つ持てる SP なら、新しい証明書を先に足しておけるので、IdP がいつ切り替えても止まらない
  • 証明書を 1 つしか持てない SP では、IdP が切り替えるのと同じ時刻に差し替えるしかない。差し替えが済むまでのログインは失敗する

メタデータには証明書が入っているので、偽物を登録すると、偽物の IdP の署名を信用してしまう。メタデータは、管理者が自分でログインした IdP の管理画面や、https の URL のような、信用できる経路で受け取る。

ログインの流れ

社員が app.example.com のログイン画面でログインを始めてから、ログインが終わるまでに起きることは 7 つ。SP から始まるこの流れを SP-initiated SSO と呼ぶ。

図の実線の矢印は「頼む・送る」、破線の矢印は「それに対する返事」を表す。リダイレクトは、サーバーがブラウザに「次はこの URL を開いて」と返し、ブラウザが自動でその URL に移動すること。

sequenceDiagram
    actor U as ユーザー
    participant B as ブラウザ
    participant SP as SP<br>(app.example.com)
    participant IDP as IdP<br>(idp.example.net)

    U->>B: 1. ログイン画面でログインを始める
    B->>SP: ログインしたい
    SP->>SP: 2. 会社の IdP を見分ける
    SP-->>B: IdP の SSO URL へリダイレクト(認証リクエスト付き)
    B->>IDP: 認証リクエストを届ける
    IDP-->>B: ログイン画面
    U->>B: 3. IdP の画面でパスワードを入力して本人確認
    B->>IDP: パスワードを送る
    IDP-->>B: 4. SAML レスポンスが入ったフォームを返す
    B->>SP: 5. SAML レスポンスを ACS URL へ送る
    SP->>SP: 6. SAML レスポンスを確かめる
    SP-->>B: 7. ログイン後の画面
  1. 社員が app.example.com のログイン画面で、ログインを始める
  2. SP が、この社員の会社の IdP を見分ける。SP は 認証リクエスト を作り、ブラウザをその IdP の SSO URL へリダイレクトする
    • 認証リクエストは「この SP のためにログインさせてほしい」という XML
  3. 社員が IdP の画面で本人確認をする。パスワードは IdP にだけ送られ、SP には渡らない
    • すでに IdP にログインしていれば、この画面は出ない
  4. IdP が SAML レスポンス を作り、それを入れた HTML のフォームをブラウザに返す
    • SAML レスポンスは「ログインしたのはこの人」という結果の XML で、中のアサーション(後で説明)に IdP の署名が付いている
  5. ブラウザが、フォームを SP の ACS URL へ自動で送信する
  6. SP が SAML レスポンスを確かめる
  7. SP が、SAML レスポンスに書かれたユーザーをログイン済みとして扱い、ログイン後の画面を返す

SP と IdP のサーバーは、この流れの中で直接は通信しない。認証リクエストも SAML レスポンスも、ブラウザが運ぶ。

SP が会社の IdP を見分ける方法

SAML は、SP がブラウザをどの IdP へリダイレクトするかの決め方を定めていない。決め方は SP が選ぶ。

  • ログイン画面で入力されたメールアドレスのドメイン(taro@example.org なら example.org)を見る
  • 会社ごとの URL(example-org.app.example.com など)を用意する
  • 会社名や組織の ID を入力してもらう
  • 「Okta でログイン」のような、IdP ごとのボタンを並べる

メールアドレスのドメインを見る方法では、ドメインが SSO を使う会社のものでなければ、そのまま app.example.com 自身のパスワードの入力に進める。SSO を使う人と使わない人が、同じログイン画面を使える。

認証リクエスト

SP が会社の IdP を見分けたあと(ログインの流れ 2)に作る認証リクエストの例。

<samlp:AuthnRequest
    xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
    xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
    ID="_a1b2c3d4"
    Version="2.0"
    IssueInstant="2026-11-21T01:00:00Z"
    Destination="https://idp.example.net/saml/sso"
    AssertionConsumerServiceURL="https://app.example.com/saml/acs"
    ProtocolBinding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST">
  <saml:Issuer>https://app.example.com/saml/metadata</saml:Issuer>
</samlp:AuthnRequest>

要素の名前 AuthnRequest の Authn は、Authentication(認証)の略。

項目 意味
ID SP がこの認証リクエストに付けた ID。SAML レスポンスの中に同じ値が入って返る
IssueInstant 認証リクエストを作った時刻。末尾の Z は UTC(協定世界時)の意味
Destination 送り先。IdP の SSO URL
AssertionConsumerServiceURL 結果を返してほしい先。SP の ACS URL
ProtocolBinding 結果(SAML レスポンス)の返し方。HTTP-POST は、フォームの送信(POST)で返してほしいという指定。この認証リクエスト自体の送り方とは別
Issuer 認証リクエストを作った者。SP のエンティティ ID

xmlns: で始まる 2 行は、samlp: と saml: が付いたタグが SAML のものであることを示す宣言。

認証リクエストは、URL に付けて送ることが多い。

その場合、SP は、この XML を圧縮して Base64 という方式で文字列に変え、SAMLRequest というパラメータに入れて URL に付ける。リダイレクト先の URL は次の形になる。

https://idp.example.net/saml/sso
  ?SAMLRequest=fZE%2FT8MwEMX3fgqUPX9BDFYSKdCBSkVETWBgQdfkRC3FdvBdUD8%2B...(略)
  &RelayState=<SP が作った値>
パラメータ 意味
SAMLRequest 認証リクエストの XML を圧縮して文字列に変えたもの
RelayState SP が付ける値。IdP は中身を見ずに、SAML レスポンスと一緒にそのまま SP へ返す。ログインのあと、社員が最初に開こうとしたページへ SP が戻す、などに使う

SAML レスポンスを運ぶ HTML のフォーム

IdP と SP のサーバーは直接通信しないので、IdP は SAML レスポンスを、ブラウザに SP へ送信させる。

社員が IdP のログイン画面でパスワードを送信すると(ログインの流れ 3)、IdP はその返事として、ログイン画面とは別の、次の HTML を返す。

<body onload="document.forms[0].submit()">
  <form method="post" action="https://app.example.com/saml/acs">
    <input type="hidden" name="SAMLResponse" value="PHNhbWxwOlJlc3BvbnNl...(略)"/>
    <input type="hidden" name="RelayState" value="<SP が作った値>"/>
  </form>
</body>
  • action は SP の ACS URL
  • SAMLResponse は、SAML レスポンスの XML を Base64 で文字列に変えたもの
  • onload="document.forms[0].submit()" は、ページを開いたらすぐにフォームを送信する JavaScript

ブラウザはこのページを一瞬だけ開き、すぐにフォームを SP へ送信する。社員にはほぼ見えず、IdP のログイン画面から SP の画面へそのまま切り替わったように見える。

ここで起きているのは、リダイレクトではなくフォームの送信(POST)。認証リクエストと SAML レスポンスでは、運び方が違う。

  • 認証リクエストは、URL に付けて運ぶことが多い
  • SAML レスポンスは、フォームの送信の本文に入れて運ぶ。署名が付いていて大きく、URL に収まらないことがあるため

SAML レスポンスの中身

SAML レスポンスの中には アサーション が入っている。アサーションは、IdP が「この人がログインした」と述べている部分で、ログインの結果の本体。

SAML(Security Assertion Markup Language)の名前に入っている Assertion は、このアサーションのこと。

flowchart TB
    subgraph R["SAML レスポンス(Response)"]
        RI["Issuer、ID、Destination、InResponseTo<br>レスポンスの情報"]
        RS["Status<br>成功か失敗か"]
        subgraph A["アサーション(Assertion)"]
            direction TB
            AI["Issuer<br>発行した IdP"]
            AG["Signature<br>IdP の署名"]
            AS["Subject<br>ログインした人"]
            AC["Conditions<br>有効な期間と宛先"]
            AA["AuthnStatement<br>いつ、どう本人確認したか"]
            AT["AttributeStatement<br>ログインした人の属性"]
            AI ~~~ AG ~~~ AS ~~~ AC ~~~ AA ~~~ AT
        end
        RI ~~~ RS ~~~ A
    end

SAMLResponse の値を Base64 から元に戻した XML の例。Signature の中身は長いので略している。

<samlp:Response
    xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
    xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
    ID="_r9f8e7d6"
    Version="2.0"
    IssueInstant="2026-11-21T01:00:30Z"
    Destination="https://app.example.com/saml/acs"
    InResponseTo="_a1b2c3d4">
  <saml:Issuer>https://idp.example.net/saml/metadata</saml:Issuer>
  <samlp:Status>
    <samlp:StatusCode Value="urn:oasis:names:tc:SAML:2.0:status:Success"/>
  </samlp:Status>
  <saml:Assertion ID="_as5t4u3v" Version="2.0" IssueInstant="2026-11-21T01:00:30Z">
    <saml:Issuer>https://idp.example.net/saml/metadata</saml:Issuer>
    <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">(略)</ds:Signature>
    <saml:Subject>
      <saml:NameID Format="urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress">taro@example.org</saml:NameID>
      <saml:SubjectConfirmation Method="urn:oasis:names:tc:SAML:2.0:cm:bearer">
        <saml:SubjectConfirmationData
            InResponseTo="_a1b2c3d4"
            Recipient="https://app.example.com/saml/acs"
            NotOnOrAfter="2026-11-21T01:05:30Z"/>
      </saml:SubjectConfirmation>
    </saml:Subject>
    <saml:Conditions NotBefore="2026-11-21T01:00:30Z" NotOnOrAfter="2026-11-21T01:05:30Z">
      <saml:AudienceRestriction>
        <saml:Audience>https://app.example.com/saml/metadata</saml:Audience>
      </saml:AudienceRestriction>
    </saml:Conditions>
    <saml:AuthnStatement AuthnInstant="2026-11-21T01:00:25Z">
      <saml:AuthnContext>
        <saml:AuthnContextClassRef>urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport</saml:AuthnContextClassRef>
      </saml:AuthnContext>
    </saml:AuthnStatement>
    <saml:AttributeStatement>
      <saml:Attribute Name="department">
        <saml:AttributeValue>開発部</saml:AttributeValue>
      </saml:Attribute>
    </saml:AttributeStatement>
  </saml:Assertion>
</samlp:Response>

アサーション(<saml:Assertion> から </saml:Assertion> まで)の項目は次のとおり。

項目 意味 この例では
ID IdP がアサーションに付けた ID _as5t4u3v
Issuer アサーションを発行した IdP IdP のエンティティ ID
Signature IdP がアサーションに付けた署名
NameID ログインした人の ID。何を ID にするか(メールアドレス、社員番号など)は、SP が求める形式に合わせて IdP の設定で決める taro@example.org
SubjectConfirmationData このアサーションの届け先(Recipient)と期限(NotOnOrAfter)。InResponseTo は認証リクエストの ID 届け先は SP の ACS URL。期限は発行の 5 分後
Conditions アサーションが有効な期間(NotBefore から NotOnOrAfter まで)と、誰に向けて発行したか(Audience) 発行から 5 分間。Audience は SP のエンティティ ID
AuthnStatement IdP がいつ、どの方法で本人確認をしたか パスワードで確認
AttributeStatement ログインした人の属性。何を入れるかは IdP の設定で決める 部署が開発部

IdP のメタデータには、NameID に使える形式の一覧が載ることはあるが、この SP にどの形式で送るかは載っていない。

実際に何が送られてくるかは、SP に届いた SAML レスポンスを見て確かめる。

アサーションの外側にあるのは、SAML レスポンスそのものの情報。

  • 発行した IdP の Issuer
  • レスポンスの ID
  • 宛先の Destination
  • 認証リクエストの ID を指す InResponseTo
  • 成否の Status。Success なら、ログインは成功している

この記事の例では、署名が付いているのはアサーションだけで、外側の項目は署名で守られていない(アサーションに加えて、SAML レスポンス全体にも署名を付ける IdP もある)。

アサーションを信用するために署名と項目を確かめる

SAML レスポンスはブラウザが運んでくる。ACS URL は誰でもフォームを送信できる URL なので、SP は届いたものをそのまま信じられない。

同じ形の XML は誰でも作れるし、ブラウザを操作する人なら、送る前に中身(NameID など)を書き換えることもできる。

そこで IdP はアサーションに 署名 を付けている。署名には、2 つで 1 組の鍵を使う。

  • 秘密鍵
    • IdP だけが持つ
    • 署名を作るのに使う
  • 公開鍵
    • IdP の証明書に入っている。SP は事前の登録で受け取っている
    • 署名が秘密鍵で作られたことを確かめるのに使う。公開鍵では署名を作れない
sequenceDiagram
    participant IDP as IdP<br>(idp.example.net)
    participant B as ブラウザ
    participant SP as SP<br>(app.example.com)

    Note over SP: 事前の登録で IdP の証明書(公開鍵)を受け取り済み
    IDP->>IDP: 秘密鍵でアサーションに署名する
    IDP-->>B: SAML レスポンスが入ったフォーム
    B->>SP: SAML レスポンスを送る
    SP->>SP: 1. 登録済みの公開鍵で署名を確かめる
    SP->>SP: 2. アサーションの項目を確かめる
  1. SP が、事前に登録した IdP の公開鍵で、アサーションの署名を確かめる。アサーションが 1 文字でも書き換えられていると、ここで合わなくなる
  2. SP が、アサーションの項目を確かめる

SP が確かめる項目は次のとおり。どれもアサーションの中にあり、署名で守られている。

項目 確かめること 防げること
Audience と Recipient 自分あてか。Audience は自分のエンティティ ID、Recipient は自分の ACS URL と同じか 同じ IdP を使う別の SP 向けに発行されたアサーションを持ち込まれること(別の SP の運営者が、自分のサービスあてに届いたアサーションを app.example.com に持ち込むなど)
NotOnOrAfter(SubjectConfirmationData と Conditions) どちらの期限も過ぎていないか 古いアサーションを使われること
InResponseTo(SubjectConfirmationData の中) このブラウザから始まったログインで、自分が作った認証リクエストの ID か 自分が頼んでいないログインの結果を差し込まれること
アサーションの ID 前に受け取ったアサーションの ID ではないか 盗まれたアサーションをもう一度送られること

InResponseTo もアサーションの ID も ID の値を比べる項目だが、比べる相手が違う。

  • InResponseTo
    • 比べる相手は、SP が作った認証リクエストの ID
    • SP は、作った認証リクエストの ID を、ログインを始めたブラウザと(Cookie などで)結びつけて覚えておく
  • アサーションの ID
    • 比べる相手は、前に受け取ったアサーションの ID
    • SP は、受け取ったアサーションの ID を、期限が切れるまで覚えておく
    • InResponseTo がないアサーションもある(IdP から始まる流れ。次の章で説明)。その場合、もう一度送られることを防ぐ手がかりは、アサーションの ID だけになる

IdP から始まる流れと、ログイン CSRF

IdP は、社員が使える Web サービスの一覧のページを持っていることが多い。

社員がそこで app.example.com のアイコンを押すと、IdP は認証リクエストを受け取らないまま SAML レスポンスを作り、それを入れたフォームをブラウザに返す。

この流れを IdP-initiated SSO と呼ぶ。

sequenceDiagram
    actor U as ユーザー
    participant B as ブラウザ
    participant SP as SP<br>(app.example.com)
    participant IDP as IdP<br>(idp.example.net)

    U->>B: 1. 一覧のページで app.example.com のアイコンを押す
    B->>IDP: アイコンのリンクを開く
    IDP-->>B: 2. SAML レスポンスが入ったフォームを返す
    B->>SP: 3. SAML レスポンスを ACS URL へ送る
    SP->>SP: 4. SAML レスポンスを確かめる
    SP-->>B: 5. ログイン後の画面

この流れには認証リクエストがないので、SAML レスポンスに InResponseTo は入らない。

IdP から始まる流れを受け付ける SP は「自分が頼んだログインの結果か」を確かめられず、いきなり届いた SAML レスポンスを受け入れることになる。

これを突く攻撃に ログイン CSRF がある。

  1. 攻撃者が、自分のアカウントで IdP にログインし、正しい署名付きの SAML レスポンスを手に入れる
  2. その SAML レスポンスを SP の ACS URL へ自動で送信するページを用意し、被害者に開かせる
  3. 被害者のブラウザが、攻撃者のアカウントで SP にログインした状態になる
  4. 被害者が気づかずに入力した情報(業務のデータなど)が攻撃者のアカウントに残り、攻撃者はあとでそれを読める

SP が SP-initiated SSO だけを受け付けていれば、この SAML レスポンスは拒否できる。被害者のブラウザから始まったログインの ID と合う InResponseTo がないため。

IdP の一覧のページから使いたいという要望があるときは、一覧のアイコンで SP のログイン URL を開くようにする方法がある。

そこから SP-initiated SSO が始まるので、一覧のページを残したまま、SP から始まる流れだけを受け付けられる。

OIDC との違い

同じ「ログインを別のサービスに任せる」取り決めに OIDC(OpenID Connect)がある。(OIDC の仕組みは「OIDC の仕組み: ログインの流れと ID トークンの検証」を参照)

目的は同じで、呼び名、データの形式、結果の運び方が違う。

SAML OIDC
ログインを受け持つサービス IdP OP(OpenID Provider)
結果を受け取るサービス SP RP(Relying Party)
ログインの結果 アサーション ID トークン
データの形式 XML JSON(JWT)
結果の運び方 ブラウザがフォームの送信で運ぶ(この記事の例の場合) ブラウザは認可コード(ID トークンと引き換える一時的な文字列)だけを運ぶ。結果は、RP のサーバーが OP と直接通信して受け取る(認可コードフローの場合)
事前の準備 SP と IdP がお互いの情報を登録する RP を OP に登録する(OAuth クライアントの作成)
署名を確かめる公開鍵 事前に登録した証明書 OP が公開している URL から取得する

結果の運び方の違いを図にすると次のとおり。

flowchart LR
    subgraph O["OIDC"]
        direction LR
        OO["OP"] -->|"認可コード"| OB["ブラウザ"] -->|"認可コード"| OR["RP"]
        OR -->|"認可コード(直接)"| OO
        OO -->|"ID トークン(直接)"| OR
    end
    subgraph S["SAML"]
        direction LR
        SI["IdP"] -->|"アサーション"| SB["ブラウザ"] -->|"アサーション"| SS["SP"]
    end

アサーションと ID トークンには、同じ役割の項目が入っている。

入っているもの アサーション ID トークン
発行した者 Issuer iss
ログインした人の ID NameID sub
誰に向けて発行したか Audience aud
期限 NotOnOrAfter exp
頼んだ側が作った値との突き合わせ InResponseTo nonce

Auth0 などを挟む構成

app.example.com が自分で SP になる代わりに、Auth0 のような、Web サービスのログイン機能をまとめて引き受けるサービスに SP の役を任せる構成もある。

この構成では、会社の IdP と SAML でやり取りする SP は Auth0 になる。

  • 会社の IdP の管理画面に登録するエンティティ ID と ACS URL は、Auth0 のもの
  • Auth0 は、アサーションを確かめたあと、Web サービスには OIDC などでログインの結果を渡す
  • Web サービスは、SAML を自分で実装しなくて済む
flowchart LR
    IDP["会社の IdP"]
    A0["Auth0<br>(SAML の SP)"]
    APP["Web サービス"]
    IDP -->|"SAML のアサーション"| A0
    A0 -->|"OIDC の ID トークンなど"| APP

SAML が決めていないこと

SAML が決めているのは SP と IdP の間のやり取りで、次のことは決めていない。

  • 本人の確かめ方
    • パスワード、多要素認証、パスキーのどれを使うかは IdP が決める
  • ログインしたあとの状態
    • SP はアサーションを確かめたあと、自分の Cookie などで「ログイン中」を保つ。その方法は SP が決める
    • アサーションの期限(NotOnOrAfter)は、SP がアサーションを受け入れてよいかを判断するための期限。SP のログイン状態がそこで切れるわけではない
  • SP の中での権限
    • 管理者か一般ユーザーか、のような区別は SP が自分で持つ。IdP が属性で部署や役割を渡し、SP がそれを見て決める形もある
  • アカウントの作成と削除の同期
    • SCIM という別の取り決めが受け持つ。SCIM に対応した IdP と SP をつなぐと、IdP でアカウントを作ったり止めたりしたことが、SP のアカウントにも反映される

用語メモ

用語 読み方 意味
SAML サムル Security Assertion Markup Language の略
SSO エスエスオー Single Sign-On の略。1 回のログインで複数のサービスを使えること
Service Provider サービス・プロバイダー ログインの結果を受け取るサービス。SP
Identity Provider アイデンティティ・プロバイダー ログインを受け持つサービス。IdP
Assertion アサーション IdP がログインの結果を述べた XML の部分
ACS エーシーエス Assertion Consumer Service の略。アサーションを受け取る SP の URL

まとめ

  • SAML は、ログインを IdP に任せ、結果をアサーションで受け取るための取り決め。データは XML
  • SP と IdP は、事前にお互いの情報を登録する。SP は IdP の証明書を受け取っておく
  • 何を以てどの IdP へリダイレクトするかは SP が決める。SAML の仕様では定めていない
  • 認証リクエストも SAML レスポンスもブラウザが運ぶ。SAML レスポンスは、IdP が返す HTML のフォームの送信で SP に届く
  • SP は、登録済みの公開鍵でアサーションの署名を確かめ、宛先・期限・InResponseTo・アサーションの ID を確かめてから使う
  • IdP から始まる流れには InResponseTo がなく、ログイン CSRF を防げない。SP から始まる流れだけを受け付ければ防げる

参考 URL

Ritolabo

100%