SAMLを実装する。のバックアップ(No.30)

「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

戻る

目次 †

目次
概要
- スコープ
- スコープ外
  - Web Browser SSO 以外の Profile
  - HTTP Artifact Binding
詳細
例
参考

↑

概要 †

汎用認証サイトにSAML2.0を実装するため作成中。

↑

スコープ †

SAMLの仕様は膨大だが、使われていないものも多い。
以下の範囲に絞れば、実装は割とスリムになる。

↑

Profile †

SP Initiated な Web Browser SSO Profile
Federation Using Out-of-Band Account Linking

↑

Binding †

Authentication Request
HTTP Redirect Binding
Authentication Response
HTTP POST Binding

↑

Core †

Protocols
Authentication Request Protocol

↑

メタデータ †

SP側はメタデータを公開しない。
IdP側はメタデータを公開する。
- メタデータは仕様提示と設定入力支援にのみ使用する。
- メタデータで指定された範囲の仕様で応答する（一意になるオプションは不要）。
- SAML Metadataで、AuthnRequestに指定可能な内容を示す。

↑

トラストサークル †

仕様上、トラストサークルと言う用語は出てこない。

単純に「IdP-SP 間で、お互いを事前に登録し、お互いの証明書を交換する。」こと。

ただ、Azure ADやCybozuの仕様を見ると、Requestに署名しているケースは限られている
（イントラからのフェデレーションではRequestにも署名しているものと思われる）。

↑

署名 †

前述のトラストサークルの慣例から、リクエスト・レスポンス共に署名を行う。

↑

スコープ外 †

↑

Web Browser SSO 以外の Profile †

SAMLは、Web Browser SSO Profile以外で使われていない。

↑

HTTP Artifact Binding †

IdM実験室によると...。

昔はデータサイズの問題で、Artifact Bindingを使っていたが
最近は通信速度や端末性能の向上により、使われることは減ってきているらしい。

SPとIdPの間で直接通信をさせなければならないので、
クラウドサービスと社内IdPを連携させる場合など面倒なため。

ただ、今でも稀にArtifact Bindingしか使えないSPが
存在するので、仕方なく（IdP側に）実装することがある。

なお、AD FSではArtifact Bindingをサポートしている。
Azure ADはPOST BindingのみでArtifact Bindingは使えない。

↑

詳細 †

↑

プロトコル＆アサーション †

↑

AuthnRequest? †

NameIDPolicy

Format

○ emailAddress
○ unspecified
☓ persistent(永続的仮名)
☓ transient（一時的仮名）
☓☓ X509SubjectName
☓☓ WindowsDomainQualifiedName
☓☓ kerberos
☓☓ entity

AllowCreate?="false"

RequestedAuthnContext?
多くのSPでは使用していない

Comparison属性

○ exact
☓ minimum
☓ maximum
☓ better

AuthnContextClassRef?要素
urn:oasis:names:tc:SAML:2.0:ac:classes

○ unspecified（不特定の方法で）
○ PasswordProtectedTransport（パスワード）
☓ Password（PasswordProtectedTransportとの違いが？）
☓ PreviousSession（既存のセッションを利用）
☓ X509
☓ SecureRemotePassword
☓ TimeSyncToken
☓ Smartcard
☓ SmartcardPKI
☓ MobileOneFactorContract
☓ MobileOneFactorUnregistered
☓ MobileTwoFactorContract
☓ MobileTwoFactorUnregistered
☓ PGP
☓ SPKI
☓ XMLDSig
☓ TLSClient
☓ Kerberos
☓ Telephony
☓ NomadTelephony
☓ AuthenticatedTelephony
☓ SoftwarePKI
☓ InternetProtocol
☓ PersonalTelephony
☓ InternetProtocolPassword

↑

Assertion †

例を参考にする。

↑

Response †

例を参考にする。

↑

エンコード・デコード †

下記のsamltool.ioからアサーションを取得し、SAMLTool.comで確認するなど。

↑

ネストした複数のXML署名が Verify できない †

SignedXml?クラスの実装に問題があり、
ネストした複数のXML署名が Verify できないという問題があるらしい。

SAMLはAssertion 側と Response 側どちらでの Signature の存在を仕様上は認めている。

そのためIdP(またはその設定)によっては両方にXML署名が存在する場合がある。

ネストしている場合の正規化では、外側のSignatureを取り除き、内部は残しておく。

System.Security.Cryptography.SignedXml?クラスの実装に問題がある。
（ネストした Signature を扱うと Verify できないバグがある）

※ 外側だけ検証すればイイ気がする。
　コチラが、SignedXml?によるネストしたXML署名・検証結果。

↑

Whitespace を保持したままのXML署名が Verify できない †

XmlDocuement? を利用する際に PreserveWhitespace? を単に true にする。

↑

SAML v2 schema(XSD) による SAML(XML) の検証 †

以下を用いて、SAMLを検証する。

SAML v2 schema - Oasis
- https://docs.oasis-open.org/security/saml/v2.0/saml-schema-protocol-2.0.xsd
- https://docs.oasis-open.org/security/saml/v2.0/saml-schema-assertion-2.0.xsd

XML Schemaによる検証

しかし、結局XPathで検証していたりする。
（適切な、ミニマムのXSDをオンラインで発見できないため）

↑

SAMLTool.com（エンコード・デコード、署名・検証） †

↑

登録情報 †

↑

IdP/STS側 †

新規追加

NameIDFormat
UserId?、UserName?、メアド

SAMLResponseエンドポイント
AssertionConsumerService?とも呼ばれ、
OAuthのコンテキストではredirect_uriに相当する。

OAuth2/OIDCインフラを流用
- Isser（client_idを流用）
- Clientの公開鍵

↑

Client側 †

新規追加
なし

OAuth2/OIDCインフラを流用
- IdPの公開鍵

対応不要
Clientが個別に実装すればイイ
- SAMLRequestエンドポイント
- IdPのログアウト用URL

↑

SAMLのテスト †

↑

IdP側のテスト †

IdM実験室: [SAML]IdPの動作テストに使えるテストSPサイト
https://idmlab.eidentity.jp/2018/02/samlidpsp.html

↑

SP側のテスト †

著名、IdPを使用してテストする。

↑

参考 †

Qiita

単純なSP側のテスト
- Box と Azure AD を統合して、 Box にシングルサインオン (SSO) する環境を一から構成する
  https://qiita.com/Shinya-Yamaguchi/items/58524d1b62f218514423

Hybrid-IdPのイントラ側のテスト
- マネージドドメイン用(AD FS なし) Hybrid Azure AD Join を一から構成する
  https://qiita.com/Shinya-Yamaguchi/items/73016fcdb5beeaefa5ba

↑

例 †

↑

シーケンス(Artifact無し) †

Technical Overviewから取り出したサンプル・シーケンス

↑

リクエスト †

HTTP Redirect Bindingの場合

302

HTTP/1.1 302 Object Moved
Date: 21 Jan 2004 07:00:49 GMT
Location:https://idp.example.org/SAML2/SSO/Redirect?SAMLRequest=request&RelayState=...
Content-Type: text/html; charset=iso-8859-1

GET

GET /SAML2/SSO/Redirect?SAMLRequest=request&RelayState=... HTTP/1.1
Host: idp.example.org

SAMLRequest=request

<samlp:AuthnRequest xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
  xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion" ID="identifier_1" Version="2.0"
  IssueInstant="2004-12-05T09:21:59Z" AssertionConsumerServiceIndex="1">

  <saml:Issuer>
    https://sp.example.com/SAML2
  </saml:Issuer>

  <samlp:NameIDPolicy AllowCreate="true"
    Format="urn:oasis:names:tc:SAML:2.0:nameid-format:transient"/>
</samlp:AuthnRequest>

RelayState?=value
SAMLでは、
- OAuth / OpenID Connectと違って、Resource Serverをサポートしない。
- 故に、SP上のリソースを取得するので、そのリソース入手先のuriを指定する。

↑

レスポンス †

HTTP POST Bindingの場合

自動POST FORMのレスポンス

<form method="post" action="https://sp.example.com/SAML2/SSO/POST" ...>
  <input type="hidden" name="SAMLResponse" value="response" />
  <input type="hidden" name="RelayState" value="value" />
  ...
  <input type="submit" value="Submit" />
</form>

上記のFORMを自動POST

POST /SAML2/SSO/POST HTTP/1.1
Host: sp.example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: nnnn
SAMLResponse=response&RelayState=value

SAMLResponse=response
下記アサーションを参照

RelayState?=value
上記リクエストと同じ値を返す。

↑

アサーション †

<samlp:Response
  xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
  xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
  ID="identifier_2" InResponseTo="identifier_1" Version="2.0"
  IssueInstant="2004-12-05T09:22:05Z" Destination="https://sp.example.com/SAML2/SSO/POST">

  <saml:Issuer>
    https://idp.example.org/SAML2
  </saml:Issuer>

  <samlp:Status>
    <samlp:StatusCode
      Value="urn:oasis:names:tc:SAML:2.0:status:Success"/>
  </samlp:Status>

  <saml:Assertion
    xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
    ID="identifier_3" Version="2.0" IssueInstant="2004-12-05T09:22:05Z">

    <saml:Issuer>
      https://idp.example.org/SAML2
    </saml:Issuer>

    <!-- a POSTed assertion MUST be signed -->
    <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
      ...
    </ds:Signature>

    <saml:Subject>
      <saml:NameID Format="urn:oasis:names:tc:SAML:2.0:nameid-format:transient">
        3f7b3dcf-1674-4ecd-92c8-1544f346baf8
      </saml:NameID>
      <saml:SubjectConfirmation Method="urn:oasis:names:tc:SAML:2.0:cm:bearer">
        <saml:SubjectConfirmationData
          InResponseTo="identifier_1"
          NotOnOrAfter="2004-12-05T09:27:05Z"
          Recipient="https://sp.example.com/SAML2/SSO/POST"/>
      </saml:SubjectConfirmation>
    </saml:Subject>

    <saml:Conditions
      NotBefore="2004-12-05T09:17:05Z"
      NotOnOrAfter="2004-12-05T09:27:05Z">
      <saml:AudienceRestriction>
          <saml:Audience>
            https://sp.example.com/SAML2
          </saml:Audience>
        </saml:AudienceRestriction>
    </saml:Conditions>

    <saml:AuthnStatement
      AuthnInstant="2004-12-05T09:22:00Z" SessionIndex="identifier_3">
        <saml:AuthnContext>
          <saml:AuthnContextClassRef>
            urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport
          </saml:AuthnContextClassRef>
        </saml:AuthnContext>
    </saml:AuthnStatement>
  </saml:Assertion>
</samlp:Response>

↑

シーケンス(Artifact有り) †

医療分野共通認証基盤整備コンソーシアムのドキュメントから取り出したサンプル・シーケンス

↑

リクエスト１ †

HTTP Redirect Bindingの場合

302

HTTP/1.1 302 Object Moved
Date: 21 Jan 2004 07:00:49 GMT
Location:https://auth.pki.med.or.jp/sso/SSORedirect/metaAlias/idp?SAMLRequest=...
Content-Type: text/html; charset=iso-8859-1

GET

GET /sso/SSORedirect/metaAlias/idp?SAMLRequest=... HTTP/1.1
Host: auth.pki.med.or.jp

HTTP POST Bindingの場合

POST FORMのレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN“
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
  <body onload="document.forms[0].submit()">
    <noscript>
      <p>
        <strong>Note:</strong>
        Since your browser does not support JavaScript、you must press the Continue
        button once to proceed.
      </p>
    </noscript>
    <form action=https://ServiceProvider.com/SAML/SLO/Browser method="post">
      <div>
        <input type="hidden" name="RelayState“
        value="0043bfc1bc45110dae17004005b13a2b"/>
        <input type="hidden" name="SAMLRequest“
        value="PHNhbWxwOkxvZ291dFJlcXVlc3QgeG1sbnM6c2FtbHA9InVybjpvYX
        NpczpuYW1lczp0YzpTQU1MOjIuMDpwcm90b2NvbCIgG1sbnM9InVybjpvYXN
        pczpuYW1lczp0YzpTQU1MOjIuMDphc3NlcnRpb24iDQogICAgSUQ9ImQyYjdj
        Mzg4Y2VjMzZmYTdjMzljMjhmZDI5ODY0NGE4IiBJc3N1ZUluc3RhbnQ9IjIwM
        DQtMDEtMjFUMTk6MDA6NDlaIiBWZXJzaW9uPSIyLjAiPg0KICAgIDxJc3N1
        ZXI+aHR0cHM6Ly9JZGVudGl0eVByb3ZpZGVyLmNvbS9TQU1MPC9Jc3N1ZXI
        +DQogICAgPE5hbWVJRCBGb3JtYXQ9InVybjpvYXNpczpuYW1lczp0YzpTQU1
        MOjIuMDpuYW1laWQtZm9ybWF0OnBlcnNpc3RlbnQiPjAwNWEwNmUwLWF
        kODItMTEwZC1hNTU2LTAwNDAwNWIxM2EyYjwvTmFtZUlEPg0KICAgIDxz
        YW1scDpTZXNzaW9uSW5kZXg+MTwvc2FtbHA6U2Vzc2lvbkluZGV4Pg0KPC9
        zYW1scDpMb2dvdXRSZXF1ZXN0Pg=="/>
      </div>
      <noscript>
        <div>
          <input type="submit" value="Continue"/>
        </div>
      </noscript>
    </form>
  </body>
</html>

上記のFORMをPOST

POST /sso/SSOPost/... HTTP/1.1
Host: auth.pki.med.or.jp
Content-Type: application/x-www-form-urlencoded
Content-Length: nnnn
SAMLRequest=request&RelayState=value

SAMLRequest

<samlp:AuthnRequest
  xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
  ID="s2cee63177ff33bcacd5263caa4af9da101837de24"
  Version="2.0"
  IssueInstant="2011-06-28T05:08:41Z"
  Destination="https://auth.pki.med.or.jp/sso/SSORedirect/metaAlias/idp"
  ForceAuthn="false" IsPassive="false"
  ProtocolBinding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Artifact"
  AssertionConsumerServiceURL="https://ServiceProvider.com/SAML/Consumer/metaAlias/sp">
  <saml:Issuer
    xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
    sso-sp
  </saml:Issuer>
  <samlp:NameIDPolicy
    xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
    Format="urn:oasis:names:tc:SAML:2.0:nameid-format:transient"
    SPNameQualifier="openam-sp" AllowCreate="true">
  </samlp:NameIDPolicy>
  <samlp:RequestedAuthnContext
    xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol" Comparison="exact">
    <saml:AuthnContextClassRef xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
      urn:oasis:names:tc:SAML:2.0:ac:classes:X509
    </saml:AuthnContextClassRef>
  </samlp:RequestedAuthnContext>
</samlp:AuthnRequest>

↑

レスポンス１ †

HTTP Redirect Bindingの場合

302

HTTP/1.1 302 Object Moved
Date: 21 Jan 2004 07:00:49 GMT
Location:https://ServiceProvider.com/SAML/SLO/Browser?SAMLart=...&RelayState=...
Content-Type: text/html; charset=iso-8859-1

GET

GET /SAML/SLO/Browser?SAMLart=...&RelayState=... HTTP/1.1
Host: ServiceProvider.com

HTTP POST Bindingの場合
- 仕様中に、formも使用可能とある（≒ HTTP POST Binding使用可能）。
- が、記載無し ... SAMLart送付にPOST不要と言う判断なのだろう。

↑

リクエスト２ †

Artifact Binding

POST /SAML/Artifact/Resolve HTTP/1.1
HOST: IdentityProvider.com
Content-Type: text/xml
Content-Length: nnn
SOAPAction: http://www.oasis-open.org/committees/security
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
    <samlp:ArtifactResolve xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
      xmlns="urn:oasis:names:tc:SAML:2.0:assertion" ID="_6c3a4f8b9c2d" Version="2.0"
      IssueInstant="2004-01-21T19:00:49Z">
      <Issuer>https://ServiceProvider.com/SAML/</Issuer>
      <ds:Signature
        xmlns:ds="http://www.w3.org/2000/09/xmldsig#">...Signature...</ds:Signature>
      <Artifact>...artifact...</Artifact>
    </samlp:ArtifactResolve>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

↑

レスポンス２ †

Artifact Binding

HTTP/1.1 200 OK
Date: 21 Jan 2004 07:00:49 GMT
Content-Type: application/soap+xml
Content-Length: nnnn
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Body>
    <samlp:ArtifactResponse
      xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
      ID="identifier_3" InResponseTo="identifier_2" Version="2.0"
      IssueInstant="2004-12-05T09:22:05Z">
      <samlp:Status>
        <samlp:StatusCode
          Value="urn:oasis:names:tc:SAML:2.0:status:Success"/>
      </samlp:Status>
      <samlp:Response
        xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
        xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
        ID="identifier_4" InResponseTo="identifier_1"
        Version="2.0" IssueInstant="2004-12-05T09:22:05Z"
        Destination="https://ServiceProvider.com/SAML/SSO/Artifact">
        <saml:Issuer>
          medical-doctor-sso-idp
        </saml:Issuer>
        <samlp:Status>
          <samlp:StatusCode
            Value="urn:oasis:names:tc:SAML:2.0:status:Success"/>
        </samlp:Status>
        <saml:Assertion ... </saml:Assertion>        
      </samlp:Response>
    </samlp:ArtifactResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

↑

アサーション †

<saml:Assertion
 xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
 Version="2.0" ID="s2ead62f287a9e36c31b3a693974582fdae20c5351"
 IssueInstant="2011-06-28T05:08:41Z">
 <saml:Issuer>
   medical-doctor-sso-idp
 </saml:Issuer>
 <saml:Subject>
   <saml:NameID
     NameQualifier="medical-doctor-sso-idp"
     SPNameQualifier="sso-sp"
     Format="urn:oasis:names:tc:SAML:2.0:nameid-format:transient">
     1234567890
   </saml:NameID>
   <saml:SubjectConfirmation
     Method="urn:oasis:names:tc:SAML:2.0:cm:bearer">
     <saml:SubjectConfirmationData
       InResponseTo="s2cee63177ff33bcacd5263caa4af9da101837de24"
       NotOnOrAfter="2011-06-28T05:18:41Z"
       Recipient="https://ServiceProvider.com/SAML/Consumer/metaAlias/sp">
     </saml:SubjectConfirmationData>
   </saml:SubjectConfirmation>
 </saml:Subject>
 <saml:Conditions
   NotBefore="2011-06-28T04:58:41Z"
   NotOnOrAfter="2011-06-28T05:18:41Z">
   <saml:AudienceRestriction>
     <saml:Audience>
       sso-sp
     </saml:Audience>
   </saml:AudienceRestriction>
 </saml:Conditions>
 <saml:AuthnStatement
   AuthnInstant="2011-06-28T05:08:41Z" SessionIndex="xxxxx">
   <saml:AuthnContext>
     <saml:AuthnContextClassRef>
       urn:oasis:names:tc:SAML:2.0:ac:classes:X509
     </saml:AuthnContextClassRef>
   </saml:AuthnContext>
 </saml:AuthnStatement>
 <saml:AttributeStatement>
   <saml:Attribute Name="HCROLE ">
     <saml:AttributeValue
       xmlns:xs="http://www.w3.org/2001/XMLSchema"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:type="xs:string">
       Medical Doctor
     </saml:AttributeValue>
   </saml:Attribute>
 </saml:AttributeStatement>
</saml:Assertion>

↑

シーケンス（Azure AD） †

↑

リクエスト †

<samlp:AuthnRequest
  xmlns="urn:oasis:names:tc:SAML:2.0:metadata"
  ID="id6c1c178c166d486687be4aaf5e482730"
  Version="2.0" IssueInstant="2013-03-18T03:28:54.1839884Z"
  xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol">
  <Issuer xmlns="urn:oasis:names:tc:SAML:2.0:assertion">https://www.contoso.com</Issuer>
  <NameIDPolicy
    Format="urn:oasis:names:tc:SAML:2.0:nameid-format:persistent"/>
</samlp:AuthnRequest>

↑

レスポンス †

<samlp:Response
  ID="_a4958bfd-e107-4e67-b06d-0d85ade2e76a"
  Version="2.0" IssueInstant="2013-03-18T07:38:15.144Z"
  Destination="https://contoso.com/identity/inboundsso.aspx"
  InResponseTo="id758d0ef385634593a77bdf7e632984b6"
  xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol">
  <Issuer xmlns="urn:oasis:names:tc:SAML:2.0:assertion">
    https://login.microsoftonline.com/82869000-6ad1-48f0-8171-272ed18796e9/
  </Issuer>
  <ds:Signature xmlns:ds="https://www.w3.org/2000/09/xmldsig#">
    ...
  </ds:Signature>
  <samlp:Status>
    <samlp:StatusCode
      Value="urn:oasis:names:tc:SAML:2.0:status:Success" />
  </samlp:Status>
  <Assertion
    ...
  </Assertion>
</samlp:Response>

↑

アサーション †

<Assertion
  ID="_bf9c623d-cc20-407a-9a59-c2d0aee84d12"
  Version="2.0" IssueInstant="2013-03-18T07:38:15.144Z"
  xmlns="urn:oasis:names:tc:SAML:2.0:assertion">
  <Issuer>https://login.microsoftonline.com/82869000-6ad1-48f0-8171-272ed18796e9/</Issuer>
  <ds:Signature xmlns:ds="https://www.w3.org/2000/09/xmldsig#">
    ...
  </ds:Signature>
  <Subject>
    <NameID>Uz2Pqz1X7pxe4XLWxV9KJQ+n59d573SepSAkuYKSde8=</NameID>
    <SubjectConfirmation Method="urn:oasis:names:tc:SAML:2.0:cm:bearer">
      <SubjectConfirmationData
        InResponseTo="id758d0ef385634593a77bdf7e632984b6"
        NotOnOrAfter="2013-03-18T07:43:15.144Z"
        Recipient="https://contoso.com/identity/inboundsso.aspx" />
    </SubjectConfirmation>
  </Subject>
  <Conditions
    NotBefore="2013-03-18T07:38:15.128Z"
    NotOnOrAfter="2013-03-18T08:48:15.128Z">
    <AudienceRestriction>
      <Audience>https://www.contoso.com</Audience>
    </AudienceRestriction>
  </Conditions>
  <AttributeStatement>
    <Attribute Name="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name">
      <AttributeValue>testuser@contoso.com</AttributeValue>
    </Attribute>
    <Attribute Name="http://schemas.microsoft.com/identity/claims/objectidentifier">
      <AttributeValue>3F2504E0-4F89-11D3-9A0C-0305E82C3301</AttributeValue>
    </Attribute>
    ...
  </AttributeStatement>
  <AuthnStatement
    AuthnInstant="2013-03-18T07:33:56.000Z"
    SessionIndex="_bf9c623d-cc20-407a-9a59-c2d0aee84d12">
    <AuthnContext>
      <AuthnContextClassRef>
        urn:oasis:names:tc:SAML:2.0:ac:classes:Password
      </AuthnContextClassRef>
    </AuthnContext>
  </AuthnStatement>
</Assertion>

↑

シーケンス（Cybozu） †

↑

リクエスト †

<samlp:AuthnRequest
  AssertionConsumerServiceURL="https://(sub_domain).cybozu.com/saml/acs" 
  ID="szqd0c3d0u3vpz5jwna4p24iso42opc4"
  IssueInstant="2013-04-01T00:00:00Z"
  ProtocolBinding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST"
  Version="2.0" xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol">
  <saml:Issuer
    xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
    https://(sub_domain).cybozu.com
  </saml:Issuer>
  <samlp:NameIDPolicy
    Format="urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified" />
</samlp:AuthnRequest>

↑

レスポンス †

<samlp:Response
  xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
  ID="s2b39863179da0358f10bb499d6ac0e64062e89e1d"
  InResponseTo="szqd0c3d0u3vpz5jwna4p24iso42opc4"
  Version="2.0" IssueInstant="2013-04-01T00:30:00Z"
  Destination="https://(sub_domain).cybozu.com/saml/acs">
  <saml:Issuer xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
    http://(idp_host)
  </saml:Issuer>
  <samlp:Status xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol">
    <samlp:StatusCode
      xmlns:samlp="urn:oasis:names:tc:SAML:2.0:protocol"
      Value="urn:oasis:names:tc:SAML:2.0:status:Success"/>
  </samlp:Status>
  <saml:Assertion
    ...
  </saml:Assertion>
</samlp:Response>

↑

アサーション †

<saml:Assertion
  xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion"
  ID="s2822cac48e7b7ec82ff36710996423e7baec43a00"
  IssueInstant="2013-04-01T00:30:00Z" Version="2.0">
  <saml:Issuer>
    https://(idp_host)
  </saml:Issuer>
  <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
    ...アサーションの署名の内容...
  </ds:Signature>
  <saml:Subject>
    <saml:NameID
      NameQualifier="https://(idp_host)"
      SPNameQualifier="https://(sub_domain).cybozu.com"
      Format="urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified">
      watanabe
    </saml:NameID>
    <saml:SubjectConfirmation
      Method="urn:oasis:names:tc:SAML:2.0:cm:bearer">
      <saml:SubjectConfirmationData
        InResponseTo="szqd0c3d0u3vpz5jwna4p24iso42opc4"
        NotOnOrAfter="2013-04-01T00:40:00Z"
        Recipient="https://(sub_domain).cybozu.com/saml/acs" />
    </saml:SubjectConfirmation>
  </saml:Subject>
  <saml:Conditions
    NotBefore="2013-04-01T00:20:00Z"
    NotOnOrAfter="2013-04-01T00:40:00Z">
    <saml:AudienceRestriction>
      <saml:Audience>https://(sub_domain).cybozu.com
    </saml:AudienceRestriction>
  </saml:Conditions>
  <saml:AuthnStatement
    AuthnInstant="2013-04-01T00:29:30Z"
    SessionIndex="s2901e6c0e0cc0c8f1aa1075215125b2676774dd01">
    <saml:AuthnContext>
      <saml:AuthnContextClassRef>
        urn:oasis:names:tc:SAML:2.0:ac:classes:PasswordProtectedTransport
      </saml:AuthnContextClassRef>
    </saml:AuthnContext>
  </saml:AuthnStatement>
</saml:Assertion>

↑

参考 †

SAML認証に関する自分なりのまとめ - なんとな～くしあわせ？の日記
https://nantonaku-shiawase.hatenablog.com/entry/2016/07/13/081053

SAML2.0でのシングルサインオン実装と戦うあなたに(.NET編) - Qiita
https://qiita.com/ea54595/items/e932644477a45070690b

SAML Token - samltool.io
https://samltool.io/

↑

OneLogin? †

↑

developers.onelogin.com †

C# & ASP.NET SAML Authentication Examples
C Sharp ASP SAML Single Sign-On (SSO) Tutorial
https://developers.onelogin.com/saml/c-and-aspnet

onelogin/dotnet-saml: SAML toolkit for .NET
https://github.com/onelogin/dotnet-saml

↑

SAMLTool.com †

SAML Testing Tools | Online SAML Debugger | Examples
https://www.samltool.com/index.php

ONLINE TOOLS
https://www.samltool.com/online_tools.php

X.509 CERTS
https://www.samltool.com/sign_authn.php
- Obtain Self-Signed Certs
  https://www.samltool.com/self_signed_certs.php
- Calculate Fingerprint
  https://www.samltool.com/fingerprint.php
- Format X.509 Certificate
  https://www.samltool.com/format_x509cert.php
- Format Private Key
  https://www.samltool.com/format_privatekey.php

CODE / DECODE
- Base64
  https://www.samltool.com/base64.php
- Gzip
  https://www.samltool.com/gzip.php
- URL Encode/Decode
  https://www.samltool.com/url.php
- Deflate + Base64 Encode
  https://www.samltool.com/encode.php
- Base 64 Decode + Inflate
  https://www.samltool.com/decode.php

ENCRYPT / DECRYPT
- Encrypt XML
  https://www.samltool.com/encrypt.php
- Decrypt XML
  https://www.samltool.com/decrypt.php

SIGN
- AuthNRequest
  https://www.samltool.com/sign_authn.php
- Response
  https://www.samltool.com/sign_response.php
- Logout Request
  https://www.samltool.com/sign_logout_req.php
- Logout Response
  https://www.samltool.com/sign_logout_res.php
- Metadata
  https://www.samltool.com/sign_metadata.php

VALIDATE
- XML Against XSD Schema
  https://www.samltool.com/validate_xml.php
- SAML AuthN Request
  https://www.samltool.com/validate_authn_req.php
- SAML Response
  https://www.samltool.com/validate_response.php
- SAML Logout Request
  https://www.samltool.com/validate_logout_req.php
- SAML Logout Response
  https://www.samltool.com/validate_logout_res.php

ATTRIBUTE EXTRACTOR

XML PRETTY PRINT

BUILD METADATA

EXAMPLES

EXTERNAL SAML TOOLS

↑

Sustainsys/Saml2 †

↑

GitHub †

SignedXml? fails to validate second signature in same document · Issue #32526 · dotnet/corefx
https://github.com/dotnet/corefx/issues/32526
- https://github.com/AndersAbel/DualXmlDsigBug

Sustainsys/Saml2: Saml2 Authentication services for ASP.NET
https://github.com/Sustainsys/Saml2
https://github.com/Sustainsys/Saml2/blob/master/Sustainsys.Saml2/XmlHelpers.cs#L368

↑

NuGet †

NuGet Gallery | Sustainsys.Saml
https://www.nuget.org/packages/Sustainsys.Saml2/

↑

SignedXml?の署名・検証の問題対策 †

SignedXml

https://gist.github.com/daisukenishino2/69074e571cf89c23cce6d1522abc67e5
- ネストしたXMLの署名・検証処理の問題の確認用コード。
- 使用する範囲（SAML2 Assertionの署名・検証）で、問題なく動作するものと思われる。

↑

IdM実験室 †

Azure ADのSAML対応（IdP編）
https://idmlab.eidentity.jp/2014/08/azure-adsamlidp.html

[Office365/AzureAD]OpenAMとのID連携

[AzureAD/Java]WebLogic?/JavaアプリケーションとAzure ADを連携する
https://idmlab.eidentity.jp/2016/01/azureadjavaweblogicjavaazure-ad.html
[AD FS]JavaアプリSPとSAML Artifact Bindingで連携する際の証明書ストア
https://idmlab.eidentity.jp/2016/01/ad-fsjavaspsaml-artifact-binding.html

Tags: :IT国際標準, :認証基盤, :クレームベース認証, :SAML

SAMLを実装する。 のバックアップ(No.30)

目次 †

概要 †

スコープ †

Profile †

Binding †

Core †

メタデータ †

トラストサークル †

署名 †

スコープ外 †

Web Browser SSO 以外の Profile †

HTTP Artifact Binding †

詳細 †

プロトコル＆アサーション †

AuthnRequest? †

Assertion †

Response †

エンコード・デコード †

HTTP Redirect Binding †

HTTP POST Binding †

署名・検証のポイント †

ネストした複数のXML署名が Verify できない †

Whitespace を保持したままのXML署名が Verify できない †

SAML v2 schema(XSD) による SAML(XML) の検証 †

SAMLTool.com（エンコード・デコード、署名・検証） †

登録情報 †

IdP/STS側 †

Client側 †

SAMLのテスト †

IdP側のテスト †

SP側のテスト †

参考 †

例 †

シーケンス(Artifact無し) †

リクエスト †

レスポンス †

アサーション †

シーケンス(Artifact有り) †

リクエスト１ †

レスポンス１ †

リクエスト２ †

レスポンス２ †

アサーション †

シーケンス（Azure AD） †

リクエスト †

レスポンス †

アサーション †

シーケンス（Cybozu） †

リクエスト †

レスポンス †

アサーション †

参考 †

OneLogin? †

developers.onelogin.com †

SAMLTool.com †

Sustainsys/Saml2 †

GitHub †

NuGet †

SignedXml?の署名・検証の問題対策 †

IdM実験室 †