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に入る
- エンティティ ID は
- 書き方は 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. ログイン後の画面
- 社員が
app.example.comのログイン画面で、ログインを始める - SP が、この社員の会社の IdP を見分ける。SP は 認証リクエスト を作り、ブラウザをその IdP の SSO URL へリダイレクトする
- 認証リクエストは「この SP のためにログインさせてほしい」という XML
- 社員が IdP の画面で本人確認をする。パスワードは IdP にだけ送られ、SP には渡らない
- すでに IdP にログインしていれば、この画面は出ない
- IdP が SAML レスポンス を作り、それを入れた HTML のフォームをブラウザに返す
- SAML レスポンスは「ログインしたのはこの人」という結果の XML で、中のアサーション(後で説明)に IdP の署名が付いている
- ブラウザが、フォームを SP の ACS URL へ自動で送信する
- SP が SAML レスポンスを確かめる
- 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 URLSAMLResponseは、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. アサーションの項目を確かめる
- SP が、事前に登録した IdP の公開鍵で、アサーションの署名を確かめる。アサーションが 1 文字でも書き換えられていると、ここで合わなくなる
- 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 などで)結びつけて覚えておく
- 比べる相手は、SP が作った認証リクエストの
- アサーションの
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 がある。
- 攻撃者が、自分のアカウントで IdP にログインし、正しい署名付きの SAML レスポンスを手に入れる
- その SAML レスポンスを SP の ACS URL へ自動で送信するページを用意し、被害者に開かせる
- 被害者のブラウザが、攻撃者のアカウントで SP にログインした状態になる
- 被害者が気づかずに入力した情報(業務のデータなど)が攻撃者のアカウントに残り、攻撃者はあとでそれを読める
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
- [official] Security Assertion Markup Language (SAML) v2.0 - OASIS Open
- [official] Assertions and Protocols for the OASIS Security Assertion Markup Language (SAML) V2.0
- [official] Bindings for the OASIS Security Assertion Markup Language (SAML) V2.0
- [official] Profiles for the OASIS Security Assertion Markup Language (SAML) V2.0
- [official] Metadata for the OASIS Security Assertion Markup Language (SAML) V2.0
- [official] Security Assertion Markup Language (SAML) V2.0 Technical Overview
- [official] Microsoft Entra フェデレーション メタデータ - Microsoft identity platform | Microsoft Learn
- [official] チュートリアル: フェデレーション証明書の管理 - Microsoft Entra ID | Microsoft Learn
- [official] Configure Auth0 as a SAML Service Provider - Auth0 Docs