Liferay サポート用の SAML Tracer エクスポートを生成する方法

ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

SAML Tracer は、シングル・サインオンおよびシングル・ログアウト中にブラウザを介して送信される SAML メッセージを表示するための便利なデバッグ・ツールであり、さまざまなブラウザでの SAML 要求および応答の表示およびエクスポートなど、SP および IdP が開始した SAML フローの両方の分析に役立つ。

Liferayサポートが時折要求する素晴らしい診断ツールです。 以下は、使用するブラウザに応じて、SAML Tracer エクスポートを生成するために使用できる手順である。

重要：誰かにファイルを提供する前に、ファイルがサニタイズされていることを確認してください。 SAML Tracer JSON ファイルはすべての SAML 要求を記録するため、機密データが含まれている可能性がある。 SAML トレーサ・ログをエクスポートするときに、マスキング・オプションを使用できる。 しかし、これはクッキーの値のようなトラブルシューティングに必要な値をマスキングするかもしれないので、手動でのマスキングが必要かもしれない。 Liferayサポートにファイルを提供する前に、生成されたJSONファイルの機密情報を確認してください。

解像度

SAML Tracer のインストールとセットアップ

1. SAML-tracer または同様のブラウザ・ツールをインストールする。

   • Firefox ブラウザにインストールするには、SAML Tracer for Firefox（SimpleSAMLphp社）にアクセスし、拡張機能をインストールする。

   • Chrome ブラウザにインストールするには、SAML Tracer for Google Chrome（SimpleSAMLphp社）にアクセスして、拡張機能をインストールする。

   • 他のブラウザでも、SAML DevTools や SAML Chrome Panel などの同様のツールを利用できる。 事実上、ウェブブラウザの中間者攻撃を実行するためのソフトウェアをインストールすることになるので、注意を払い、信頼できるソースからツールを選択してください。

2. インストールに成功したら、ブラウザのメニュー・バーから Tools > SAML Tracer（または Chrome の Extensions > SAML Tracer）を選択して、SAML Tracer にアクセスする。

3. SAML Tracer ウィンドウを開いたまま、サービス・プロバイダのサイトに移動する。
4. SAML-tracer は、HTTP 要求と応答のログを自動的に記録し始めます。 (ログ表示を簡素化するために、上部の「リソースのフィルタリング」を有効にすることができます)。
5. トレースしたいタスクを完了する（つまり、選択したIdPでSPに認証する）
6. SAML 要求と応答には、以下のように SAML タグが付けられる。

SAML Tracer Log Export

• SAML-tracer 出力をエクスポートするには、SAML-tracer の Export ボタンをクリックし、エクスポートされたファイ ルに異なる cookie フィルタ・プロファイルを持たせるかどうかを選択する。
• SAML-tracer は、ファイルを .JSON ファイルとして、設定されたダウンロード場所にエクスポートする。
• Liferayサポートにこの.JSONファイルを提供する前に、必要に応じてサニタイズしてください。

追加情報

• サポートチケット - ベストプラクティス
• Liferayサポート用HARファイルの作成方法