SAMLメッセージとは?

SAML(Security Assertion Markup Language)2.0は、多くのシングルサインオン(SSO)環境で使われています。Okta、Microsoft Entra ID、Google Workspace、Keycloakなどの会社のIDプロバイダーを通じてアプリにサインインすると、アプリはIDプロバイダーにリクエスト(AuthnRequest)を送信し、IDプロバイダーはユーザーの身元を示すレスポンス(Assertionを含むResponse)を返します。どちらもXML文書ですが、エンコードされた状態で送受信されるため、ブラウザーのネットワークログではランダムな文字が長く並んだように見えます。

デコード方法

お手元のメッセージを、次のいずれかの形式で貼り付けてください。

  • ブラウザーの開発者ツールのネットワークタブ、またはSAMLトレーサー拡張機能からコピーした、SAMLRequestまたはSAMLResponseフィールドの値。
  • そのフィールドを含むURL全体、またはSAMLResponse=…&RelayState=…のようなフォーム本文。RelayStateと、署名付きリダイレクトの場合は署名アルゴリズムも表示されます。
  • フィールドを確認できるXMLそのもの。

デコーダーがエンコード形式を自動で判別します。

  • HTTP-POSTバインディングでは、XMLはBase64でエンコードされ、非表示のフォームフィールドで送信されます。
  • HTTP-Redirectバインディングでは、リンクに収められるよう、XMLをDEFLATEで圧縮してBase64でエンコードし、さらにURLエンコードします。デコーダーはこの3つの処理を元に戻します。

改行、URLセーフなBase64、フォームのデコード時にスペースへ変換されたプラス記号にも対応しています。

表示される内容

  • バインディングとパラメーター:メッセージのエンコード方法と、リクエストかレスポンスかを表示します。
  • メッセージ:SSOの設定やデバッグでよく確認されるフィールドを表示します。発行者(送信元)、宛先、ステータス(Success、またはResponder / AuthnFailedなどのエラー)、NameID(サインインしたユーザー)とその形式、Audience(Assertionの対象となるアプリ)、有効期間(Not before、Not on or after)が含まれます。また、認証コンテキスト、セッションインデックス、メッセージ、Assertion、またはHTTP-Redirectバインディングの場合はURLに署名が含まれているかどうかも表示します。
  • 属性:IDプロバイダーが公開したメールアドレス、名前、グループなどのユーザー属性と、それぞれのすべての値を表示します。
  • デコード済みXML:メッセージ全体をインデントして表示します。コピーまたはダウンロードできます。

知っておくと便利なこと

  • デコーダーは署名の有無を表示しますが、署名の検証は行いません。検証にはIDプロバイダーの証明書が必要であり、サービスプロバイダー側で行う必要があります。
  • 暗号化されたAssertion(EncryptedAssertion)は、サービスプロバイダーの秘密鍵がないと読み取れません。そのため、デコーダーは暗号化されたAssertionの存在を表示しますが、内容は表示できません。
  • SAMLメッセージの時刻はUTCです。サインインに失敗するよくある原因のひとつはサーバー間の時刻のずれで、Not beforeの時刻が未来になっていたり、Not on or afterの時刻がすでに過ぎていたりします。
  • すべての処理はブラウザー内で行われます。貼り付けた内容が外部に送信されることはありません。SAMLレスポンスには個人情報が含まれることがあるため、これは重要です。

機能

  • HTTP-Redirect(DEFLATE)およびHTTP-POST(Base64)メッセージをデコード
  • 値、URL全体、フォーム本文、プレーンXMLに対応
  • 発行者、ステータス、サブジェクト、条件、認証の詳細を一覧表示
  • すべての属性とその値を表示
  • コピーまたはダウンロードできる、インデント済みのXML
  • ブラウザー内で動作