製品ドキュメント
シトリックスクラウド™
PDFを表示

トラブルシューティング

August 3, 2026
Author:  Mark Dear

SAMLサポートケースをオープンする際、Citrixサポートおよびエンジニアリングに何を提供する必要がありますか

SAML関連の問題でサポートが必要な場合、Citrixサポートおよびエンジニアリングは以下の情報を必要とします。

  • 十分なコンテキストを含め、ログオンシナリオとCitrixまたはActive Directory環境を説明してください。
  • 初期設定時にどのCitrix eDocsに従ったか。
  • IdP内のSAMLアプリケーションのスクリーンショットと詳細。
  • お客様のActive Directoryに関する詳細情報。
  • SAMLトレーサーブラウザ拡張機能からのSAMLトレーサーファイル (.json) ファイル。
  • ブラウザ開発者ツールからのHARファイル (.har)。
  • 動作しているエンドユーザーと失敗しているエンドユーザー、またはCitrix Cloud管理者ユーザーの両方の詳細。
  • ストアまたはCitrix CloudへのSAMLログオンを実行しているマシンのパブリック発信元IP。

CitrixサポートおよびエンジニアリングのためのSAMLトレースの取得

Citrixエンジニアリングおよびサポートは、すべてのSAMLデバッグにSAMLトレーサーブラウザ拡張機能の使用を推奨しており、ブラウザ開発者ツールによって生成される.HARファイルも同様です。この拡張機能は、ほとんどの一般的なWebブラウザで利用でき、.JSONファイルをエクスポートします。この拡張機能はSAMLリクエストとレスポンスをXMLにデコードし、人間が読める形式にして、理解とデバッグをはるかに容易にします。

SAMLトレーサーがハイライトされたFirefoxブラウザ拡張機能リスト

SAMLトレーサーファイルの出力

ブラウザからHARファイルを収集してCitrixサポートおよびエンジニアリングに送信するにはどうすればよいですか

詳細については、記事「HARファイルの収集」を参照してください。

便利なサードパーティSAMLデバッグツール

重要:

Citrixは、サードパーティツールがデバッグ目的で使用された場合のいかなる責任も負いません。サードパーティツールおよびウェブサイトの使用とアクセスは、お客様ご自身の責任で行ってください。

ツール 目的
https://www.samltool.io/ Base64 SAMLリクエストとレスポンスをデコードします
https://www.sslshopper.com/certificate-decoder.html 証明書データをデコードします
https://www.rcfed.com/SAMLWSFed/MetadataCertificateExtract SAMLメタデータから署名および暗号化証明書をファイルとして抽出します
私のIPアドレス SAMLログオンを試行しているクライアントの発信元IPを提供します。

属性エラー

属性エラーは、以下のいずれかの条件下で発生する可能性があります。

  • SAML構成で必要な属性が正しくエンコードされていません。
  • cip_sidおよびcip_upn属性がSAMLアサーションにありません。
  • cip_sidまたはcip_oid属性がSAMLアサーションにないか、接続の問題によりCitrix CloudがActive Directoryからそれらを取得できません。

属性エラーが発生すると、Citrix Cloudは問題のある属性を含むエラーメッセージを表示します。

cip_oidが引用された属性エラーメッセージ(/ja-jp/citrix-cloud/media/saml-idp-missing-attribute-error.png)

この種のエラーを解決するには：

  1. SAMLプロバイダーが、次の表に示すように、必要な属性を正しいエンコードで送信していることを確認してください。最低でも、SIDまたはUPN属性のいずれかを含める必要があります。

    属性項目 エンコード 必須
    cip_メール 文字列形式である必要があります (user@domain)
    cip_オブジェクトID Base64または文字列形式である必要があります
    シップ_エスアイディー Base64または文字列形式である必要があります はい、cip_upnを使用しない場合
    シップ_ユーピーエヌ 文字列形式である必要があります (user@domain) はい、cip_sidを使用しない場合

  2. Citrix Cloudが必要とする不足している属性を取得できるように、Cloud Connectorがオンラインで正常であることを確認してください。詳細については、Cloud Connectorの高度なヘルスチェックを参照してください。

予期せぬエラー

Citrix Cloudは、次の場合に予期せぬエラーが発生する可能性があります。

  • ユーザーがIDP開始フローを使用してSAMLリクエストを開始した場合。たとえば、ストアURLに直接移動する代わりに、IDプロバイダーのアプリポータルを通じてタイルを選択してリクエストが行われた場合 (customer.cloud.com)。
  • SAML証明書が無効であるか、期限切れになっている場合。
  • 認証コンテキストが無効である場合。
  • SAMLアサーションと応答の署名が一致しない場合。

このエラーが発生すると、Citrix Cloudは一般的なエラーメッセージを表示します。

予期せぬエラーメッセージ(/ja-jp/citrix-cloud/media/saml-idp-flow-error.png)

このエラーが、IDプロバイダーのアプリポータルを介してCitrix Cloudに移動した結果として発生する場合、以下の回避策を使用できます。

  1. IDプロバイダーのアプリポータルで、ストアURLを参照するブックマークアプリを作成します (例: https://customer.cloud.com)。
  2. SAMLアプリとブックマークアプリの両方にユーザーを割り当てます。
  3. SAMLアプリとブックマークアプリの表示設定を変更し、アプリポータルでブックマークアプリが表示され、SAMLアプリが非表示になるようにします。
  4. Citrix® StoreFront Cloudで常にエンドユーザーに資格情報の入力を求める設定を無効にして、追加のパスワードプロンプトを削除します。手順については、「常にエンドユーザーに資格情報の入力を求める」を参照してください。
トラブルシューティング
August 3, 2026
Author:  Mark Dear
August 3, 2026
Author:  Mark Dear

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.