シトリックスクラウド™

複数のカスタム URL を使用して SAML でストアにサインイン

ストアのカスタム URL で SAML をサポートするアーキテクチャは、SAML IdP 内で構成されたたった1つの SAML アプリケーションを使用して、複数のカスタムドメインをサポートするように簡素化および更新されました。Citrix Cloud の認証プラットフォームとストアのカスタム URL サービス内で変更が行われ、SAML および条件付き認証で最大 10 個のカスタム URL をサポートできるようになりました。従来、cloud.com SAML エンドポイントを持つ SAML アプリケーションを1つ、カスタム URL を含む SAML エンドポイントを持つ別の SAML アプリケーションを構成する必要がありました。すべての SAML ユースケースをサポートするために、複数の異なる SAML アプリケーションを作成および維持する必要はなくなりました。

複数のカスタム URL をサポートする新しいアーキテクチャの利点。

saml.cloud.com (米国、EU、APS)、saml.citrixcloud.jp (日本)、saml.cloud.us (政府機関) など、Citrix Cloud リージョンに一致する Citrix Cloud SAML エンドポイントを含む SAML アプリケーションを1つ作成するだけです。

SAML アプリケーションエンドポイントの例:

  • エンティティ ID https://saml.cloud.com または https://saml.cloud.com/<guid>
  • アサーションコンシューマーサービス (SSO): https://saml.cloud.com/saml/acs
  • ログアウト (SLO): https://saml.cloud.com/saml/logout/callback

サポートされている SAML ログオンユースケース:

  • 単一の SAML アプリケーションで、いずれかのストア URL を使用してストアにログオン store.cloud.com または store.mycustomer.com

  • 管理者アクセスに SAML を使用して Citrix Cloud にログオンする場合も、同じ汎用 SAML アプリケーションを使用します。
  • IdP 内の単一の SAML アプリケーションで、複数の異なる SAML アプリケーションを作成および維持することなく、最大 10 個のストアカスタム URL をサポートできるようになりました。Citrix Cloud は、すべての SAML ユースケースをサポートするために、カスタム URL SAML エンドポイントを持つ追加の SAML アプリケーションを必要としなくなりました。

よくある質問

ストアにおけるマルチカスタム URL 機能とは何ですか?

従来、Citrix Cloud は最初のストア cloud.com URL にリンクされた単一のカスタム URL のみをサポートしていました。現在、最大 10 個のストア cloud.com URL のそれぞれにカスタム URL を構成できます。これらは URL のペアを形成し、各カスタム URL は対応する cloud.com URL の DNS における CNAME です。

マルチカスタムURLのリリース前は、プライマリcloud.comストアURLに関連付けられたカスタムURLは1つのみ、StoreFront Cloud > アクセス内でサポートされていました。

SAMLカスタムドメインストアURL

マルチカスタムURLのリリース後のStoreFront Cloud > アクセス。1~10個のカスタムURLがサポートされるようになりました。

条件付き認証の複数のカスタムドメイン

カスタムURLを移行する必要があるかどうかは、どのように判断すればよいですか

これは、Citrix Cloudとストアで使用したい認証機能の組み合わせ、現在のログオンシナリオ、および現在のSAMLソリューションによって決定されます。ガイダンスとして以下の表を使用してください。

SAMLログオンシナリオ 未移行のカスタムURL 移行済みのカスタムURL
カスタムURLエンドポイントを使用する1つのSAMLアプリでのストアへのログオン サポートされています (カスタムURL 1つ) サポートされていません (カスタムURL 1~10個)
2つのSAMLアプリでのストアへのログオン サポートされています (カスタムURL 1つ) サポートされています (カスタムURL 1~10個)
SAML 1xアプリとcloud.com URLエンドポイントを使用したCitrix Cloud管理者ログイン サポートされています サポートされています
2x SAMLアプリを使用したCitrix Cloud管理者ログイン サポートされています サポートされています
SAML 1xアプリとカスタムURLエンドポイントを使用したCitrix Cloud管理者ログイン 非対応 非対応
ストアURLとSAMLを使用した条件付き認証ポリシー サポートされています
サポートされています
エンドユーザーがブラウザまたはCitrix Workspaceアプリにcloud.com URLを入力する
ストアURLとSAMLを使用した条件付き認証ポリシー 未サポート (カスタムURL 1つ)
サポート済み (URL 1~10個)
エンドユーザーはブラウザまたはCitrix WorkspaceアプリにカスタムURLを入力します

複数のカスタムURLをサポートするために、SAMLとカスタムURLのアーキテクチャを変更する必要があったのはなぜですか

スケーラビリティ。Citrix Cloud内で複数のカスタムURLが導入されたことにより、カスタムURLごとにSAMLアプリを必要とする従来のアーキテクチャではスケーリングできず、Citrix Cloud管理者とIdP管理者の両方にとって非現実的です。

従来のSAMLカスタムURL要件:

  • SAMLを使用したCitrix Cloud管理者ログオン用のSAMLアプリケーション1つ cloud.com
  • カスタムURLごとにSAMLアプリケーション1つ。

IdP構成の複雑さ。各SAMLアプリケーションは、SAMLエンドポイントを除いて同一に構成する必要があり、SAML IdP内で追加の作業が発生していました。これにより、展開と構成の複雑さが増していました。新しいマルチカスタムドメインアーキテクチャでは、この必要がなくなり、IdP内でSAMLアプリケーションを1つだけ使用して1~10個のカスタムURLをサポートできます。

継続的なIdPメンテナンス作業。複数のSAMLアプリケーションを構成および維持し、複数のSAMLアプリケーションで毎年継続的に証明書ローテーション作業を実行する必要があることは、Citrix Cloud管理者とIdP管理者の両方にとって手間がかかり、望ましくありません。カスタムドメインが追加され、SAMLアプリケーションの数が増えるにつれて、この問題は管理者にとってさらに深刻になります。新しいアーキテクチャでは、すべてのSAMLおよびカスタムURLのユースケースに対してSAMLアプリケーションが1つだけ必要となるため、このメンテナンスの問題が解消されます。

Citrixが現在のカスタムURL SAMLソリューションから新しいよりシンプルなソリューションへの移行を求めているのはなぜですか

マルチカスタムURL機能とカスタムURLを使用した条件付き認証の両方を使用するには、従来の1xおよび2x SAMLアプリケーション構成を更新および移行する必要があります。このドキュメントには、従来の1xまたは2x SAMLアプリケーションソリューションのいずれかを使用しているお客様向けの移行手順が記載されています。

StoreFront Cloud > アクセス内のこの警告は、移行が必要なカスタムURLが1つ以上あることを示しています。

SAMLカスタムドメインURLの警告(/ja-jp/citrix-cloud/media/saml-custom-domain-url-warning.png)

この警告は、StoreFront Cloud > 認証内でSAMLまたは条件付き認証のいずれかを有効にしている場合にのみ表示されます。

認証ページのスクリーンショット(/ja-jp/citrix-cloud/media/saml-custom-domain-workspace-config.png)

最大10個までのすべての新しいカスタムURLをサポートするために、SAML IdP構成は同じですか

はい。ストアにアクセスするためにカスタムURLを1つだけ使用する場合でも、複数使用する場合でも、SAMLアプリケーションを同じように構成してください。

複数のSAMLアプリと複数のカスタムドメインで条件付き認証は現在サポートされていますか

はい。これは、多くの大企業が利用したいと考える一般的なシナリオです。1~10個のcloud.com URLのいずれかを使用して、異なるSAMLアプリケーションに解決する条件付き認証ポリシーを作成することは常に可能でした。これで、cloud.com URLのそれぞれが独自のカスタムURL(URLのペア)を持つことができます。

エンドユーザーが使用するストアURLに基づいて異なるIdP間の切り替えに関する詳細な手順については、この記事条件付き認証の記事を参照してください。

複数のカスタムURLを使用しない場合、またはカスタムURLとSAMLで条件付き認証を使用しない場合、移行されていないレガシーSAML接続は引き続き機能しますか

はい。既存のレガシー1xおよび2x SAMLアプリソリューションとの下位互換性は維持され、既存のSAMLアプリケーションソリューションは引き続き機能し、サポートされます。カスタムURLのいずれかが未移行の状態のままである場合、SAMLまたは条件付き認証でカスタムURLを使用することはできません。

マルチカスタムURL機能のリリース後に新しいカスタムURLをオンボードした場合、これらの新しいURLに対して移行を実行する必要がありますか

いいえ。マルチカスタムURL機能のリリース後に新しくオンボードされたすべてのカスタムドメインは、新しいアーキテクチャをサポートし、移行する必要はありません。移行は、マルチカスタムURL機能のリリース前に作成されたカスタムURL構成にのみ適用されます。これは通常、複数のカスタムURLのサポートが導入される前に存在していた、Citrix Cloudテナント内で構成した最初で唯一のカスタムURLに該当します。

レガシーカスタムURLとSAML構成の移行

移行アクションを実行する前に、現在のカスタムURLとSAML構成、および1xまたは2x SAMLアプリケーションソリューションで現在運用しているかどうかを理解するために、レガシーカスタムURL SAML構成セクション全体を読む必要があります。移行アクションは計画されたメンテナンス期間中に実施し、IdPから古いSAMLアプリケーションを削除する前に、SAMLログオンに影響がないことを確認するために移行後にテストを実施する必要があります。

重要:

Citrix CloudとSAML IdPの両方におけるレガシーSAML構成が、このドキュメントの「レガシーカスタムURL SAML構成」セクションで説明されている1xまたは2x SAMLアプリソリューションのいずれとも正確に一致しない場合、サポート対象外の状態となります。

現在の2x SAMLアプリケーションカスタムURLソリューションから、新しいよりシンプルなソリューションに移行するにはどうすればよいですか

  1. Citrix Cloud管理者は、IdP管理者と連携して、Citrix CloudのカスタムURLサービスとSAML IdPの両方で必要な変更を行う必要があります。

  2. SAML IdP内で、プライマリおよびセカンダリSAMLアプリケーションの両方の存在と構成を確認します。これは、EntraID、Okta、Duo、PingFederateなど、SAML IdPごとに異なります。

  3. 既存のプライマリSAMLアプリケーションであるCitrix Cloud SAMLエンドポイントは変更しないでください。これは、IDおよびアクセス管理 > 認証内に表示されるSAMLアプリケーションであり、カスタムURLの移行後、すべてのSAMLログオンユースケースで使用されます。

    シトリックス クラウド コマーシャル 米国、イーユー、およびエーピーエスからのプライマリアプリケーションの例

    • エンティティID: https://saml.cloud.com または https://saml.cloud.com/<guid>
    • アサーションコンシューマーサービス (SSO): https://saml.cloud.com/saml/acs
    • ログアウト (SLO): https://saml.cloud.com/saml/logout/callback
  4. この廃止されたセカンダリSAMLアプリケーションを特定します。このSAMLアプリケーションの構成は、StoreFront Cloud > アクセスメニュー内で指定されています。

    セカンダリアプリケーションの例

    • エンティティID: https://saml.cloud.com または https://saml.cloud.com/<guid>
    • アサーションコンシューマーサービス (SSO): https://workspaces.mycompany.com/saml/acs
    • ログアウト (SLO): https://workspaces.mycompany.com/saml/logout/callback
  5. StoreFront Cloud > アクセス」に移動し、「警告アイコン」をクリックして移行UIを開きます。 Migrate Custom URL Warning

  6. 以下に示す「SAML構成を移行」ボタンをクリックします。 Migrate 2 App Solution UI

  7. 警告を受け入れ、このUI内から移行を実行します。 Migrate 2 App Solution Button

  8. 移行」をクリックします。

    重要:

    移行により、ストアのカスタムURLサービス内のレガシーバックエンドデータが更新されます。これは、ストアのカスタムURLサービスレコードに対する元に戻せない操作であり、一度実行すると元に戻すことはできません。

  9. カスタムURLの横にステップ4で表示された警告アイコンは、移行が成功すると消えるはずです。これは、ストアのカスタムURLサービス内のバックエンドデータが更新されたことを示します。

    移行後もすべてのSAMLログオンユースケースが引き続き成功することを確認します。

    • cloud.com URLを使用してストアへのSAMLログオンをテストします。これはプライマリSAMLアプリケーションを使用します。
    • すべてのカスタムURLを使用してストアへのSAMLログオンをテストします。これは以前、移行はセカンダリSAMLアプリケーションを使用していましたが、現在は変更されていないプライマリSAMLアプリケーションを使用します。
    • 管理者サインインURLを使用してCitrix CloudへのSAMLログオンをテストします。移行前に構成されたAD管理者ユーザーおよびグループを使用します。これはプライマリSAMLアプリケーションを使用します。
  10. バックエンドストアのカスタムURLサービスデータが正常に更新されたことを確認します。

    例: FireFox開発者ツールを使用する場合。

    キーボードのF12キーを押してブラウザの開発者ツールを開き、開発者ツールがすでに実行されているCitrix Cloud UIの他のページから「StoreFront Cloud > アクセス」に移動します。これにより、Citrix Cloudコンソールが行ったすべてのREST API呼び出しがキャプチャされ、カスタムURLのリストが返されます。

    移行されたカスタムURLのトラブルシューティング

    正しいREST API呼び出しをフィルタリングするために、ネットワーク検索ダイアログにcustomdomainを入力します。

    このREST API呼び出しを見つけます: GET https://custom-domain-service.us.wsp.cloud.com/services/custom-domain-service/customers/<CCID>/stores/<storeID>/customdomains

    移行されたカスタムURLオブジェクトには、この追加データが含まれます。

    "addNewSamlVanityFlowRequestHeader":true

    カスタムURLオブジェクトの例:

    "items": [
        {
            "domain": "stores.mycompany.com",
            "id": "74cd36a1-d0b1-48be-a237-cd43770647a9",
            "state": "Ready",
            "workspaceDomain": {
                "domain": "stores.cloud.com"
            },
            "trafficManager": {
                "address": "wsp-cd-eastus2-prod-traffic-manager-profile-12-74788.trafficmanager.net"
            },
            "certificateInformation": {
                "expiry": "2026-05-24T08:23:42.0000000Z",
                "type": "Managed"
            },
            "authentication": {
                "addNewSamlVanityFlowRequestHeader": true
            }
        }
    ]
    <!--NeedCopy-->
    
  11. カスタムURL SAMLエンドポイントを使用するSAML IdP内のセカンダリアプリケーションを削除します。セカンダリSAMLアプリケーションは、SAMLログオンフロー中に使用されなくなります。

    重要:

    移行が成功したこと、および必要なSAMLログオンシナリオがすべてテストされたことを確認してから、セカンダリSAMLアプリケーションを削除してください。

現在の1x SAMLアプリケーションカスタムURLソリューションから、新しいよりシンプルなソリューションへ移行するにはどうすればよいですか

  1. Citrix Cloud管理者は、Citrix CloudのカスタムURLサービスとSAML IdPの両方で必要な変更を行うために、IdP管理者と連携する必要があります。

  2. SAML IdP内で、カスタムURL SAMLアプリケーションの存在と構成を確認します。SAML IdP内には、SAMLアプリケーションが1つだけ構成されている必要があります。これは、EntraID、Okta、Duo、PingFederateなどのSAML IdPごとに異なります。

    既存のプライマリSAMLアプリケーションのCitrix Cloud SAMLエンドポイントは、この例のようになります。

    プライマリアプリケーションの例

    • エンティティID: https://saml.cloud.com または https://saml.cloud.com/<guid>
    • アサーションコンシューマーサービス (SSO): https://workspaces.mycompany.com/saml/acs
    • ログアウト (SLO): https://workspaces.mycompany.com/saml/logout/callback
  3. サポートケースを起票し、Citrixサポートおよびエンジニアリングに連絡して、カスタムドメインの移行に関する支援を依頼してください。SAML構成のレビュー後、Citrixエンジニアリングがお客様に代わってカスタムURLを移行します。

  4. SAMLアプリケーションに安全に変更を加える前に、ステップ3を完了する必要があります。既存のプライマリSAMLアプリケーションのCitrix Cloud SAMLエンドポイントを、この例のように更新してください。

    重要:

    プライマリSAMLアプリケーションの既存のEntityID SAMLエンドポイントを更新または変更しないでください。これらを変更する必要はありません。ACSおよびログアウトSAMLエンドポイントのみを更新する必要があります。

    プライマリアプリケーションの例

    • エンティティID: https://saml.cloud.com または https://saml.cloud.com/<guid> (変更しないでください)
    • アサーションコンシューマーサービス (SSO): https://saml.cloud.com/saml/acs (更新)
    • ログアウト (SLO): https://saml.cloud.com/saml/logout/callback (更新)
  5. StoreFront Cloud > Accessに移動し、警告アイコンをクリックして移行UIを開きます。 カスタムURL移行の警告

  6. Citrixサポートおよびエンジニアリングが移行を完了すると、カスタムURLの横にステップ4で表示された警告アイコンは消えます。これは、ストアのカスタムURLサービス内のバックエンドデータが正常に更新されたことを示します。

  7. すべてのカスタムURL (移行前はセカンダリSAMLアプリケーションを使用していたもの) を使用して、ストアへのSAMLログオンをテストします。

    • cloud.com URLを使用してストアへのSAMLログオンをテストします (引き続きプライマリSAMLアプリケーションを使用します)。
    • すべてのカスタムURL (移行前はセカンダリSAMLアプリケーションを使用していたもの) を使用して、ストアへのSAMLログオンをテストします。

レガシーカスタムURL SAML構成

Citrix Cloud環境に1xまたは2x SAMLアプリケーションソリューションをデプロイしているかどうかを判断するには、現在使用しているSAMLサインインシナリオの組み合わせを特定し、SAML IdP内の現在のSAMLアプリケーションを調べます。

以下のサインインシナリオは、デフォルトで同じSAMLアプリケーション (SAML App 1) を共有します。

  • お使いのリージョンのストアサインインURL (cloud.comcitrixcloud.jpcloud.us) がSAMLプロバイダーでSPエンティティIDとして構成されているSAML認証。
  • 独自のサインインURL (例: https://citrix.cloud.com/go/mycompany) を使用したCitrix CloudのSAML認証。このシナリオでは、管理者はActive Directory (AD) グループメンバーシップに基づいて、SAMLを使用してCitrix Cloudに認証されます。

Citrix® StoreFront Cloudで構成するカスタムドメイン (例: https://workspaces.mycompany.com) を介してユーザーのSAML認証を追加するには、2番目のSAMLアプリケーション (SAML App 2) が必要です。

注:

カスタムURLを追加してSAMLを構成すると、Citrix Cloudでのプロビジョニングに最大24時間かかります。

次の表に、サポートされているSAMLサインインシナリオの組み合わせと必要なSAMLアプリを示します。

ストアURLでストアにサインイン カスタムドメインURLでストアにサインイン SAMLサインインURLを使用してCitrix Cloudにサインイン SAML App 1が必要ですか? SAML App 2が必要ですか?
はい いいえ いいえ はい - cloud.com SAMLエンドポイントを使用 いいえ
いいえ はい いいえ はい - カスタムドメインSAMLエンドポイントを使用 いいえ
いいえ いいえ はい はい - cloud.com SAMLエンドポイントを使用 いいえ
はい いいえ はい はい - cloud.com SAMLエンドポイントを使用します いいえ
いいえ いいえ はい はい - cloud.com SAMLエンドポイントを使用します はい - カスタムドメインSAMLエンドポイントを使用します
はい はい はい はい - cloud.com SAMLエンドポイントを使用します はい - カスタムドメインSAMLエンドポイントを使用します

1x SAMLアプリケーション構成 (レガシーSAML構成)

  1. シトリックスクラウドで、ストアフロントクラウド > アクセス内にカスタムURLを構成しました。
  2. SAMLプロバイダーの管理コンソールで、ストアのカスタムURLをSPエンドポイントとして使用して、1つのSAMLアプリケーションを構成しました。

    レガシーカスタムURL SAMLアプリケーションエンドポイントの例

    • エンティティID: https://saml.cloud.com または https://saml.cloud.com/<guid>
    • アサーションコンシューマーサービス (SSO): https://workspaces.mycompany.com/saml/acs
    • ログアウト (SLO): https://workspaces.mycompany.com/saml/logout/callback

    次の例は、Entra ID のカスタムURL SAMLエンドポイント構成を示しています。

    セカンダリSAMLアプリカスタムドメイン

    次の例は、Okta のカスタムURL SAMLエンドポイント構成を示しています。ここでは、オーディエンス制限にエンティティIDの値が含まれています。

    SAMLカスタムドメインOktaの例

  3. StoreFront Cloud > アクセス > 編集内で、カスタムドメインのみを使用を選択しました。

    カスタムドメインアクセス 1x SAMLアプリ

2 x SAMLアプリケーション構成 (レガシーSAML構成)

  1. Citrix Cloud で、StoreFront Cloud > アクセス内にカスタムドメインを構成しました。

  2. SAMLプロバイダーの管理コンソール内で、2つのSAMLアプリケーションを構成しました。

  3. プライマリSAMLアプリケーション内で、次のcloud.com SPエンドポイントを構成しました。

    • エンティティID: https://saml.cloud.com または https://saml.cloud.com/<guid>
    • アサーションコンシューマーサービス (SSO): https://saml.cloud.com/saml/acs
    • ログアウト (SLO): https://saml.cloud.com/saml/logout/callback

    次の例は、Okta管理コンソールでのこのエンドポイント構成を示しています。

    SAMLカスタムドメインOktaの例

    次の例は、Entra ID管理コンソールでのこのサービスプロバイダーエンドポイント構成を示しています。

    セカンダリSAMLアプリカスタムドメイン

  4. セカンダリSAMLアプリケーション内で、次のストアカスタムドメインSPエンドポイントを構成しました。
    • エンティティID: https://saml.cloud.com
    • アサーションコンシューマーサービス (SSO): https://workspaces.mycompany.com/saml/acs
    • ログアウト (SLO): https://workspaces.mycompany.com/saml/logout/callback 次の例は、Oktaコンソールでのこのサービスプロバイダーエンドポイント構成を示しています。 SAMLカスタムドメインOktaの例
    • 次の例は、Entra IDコンソールでのこのサービスプロバイダーエンドポイント構成を示しています。 セカンダリSAMLアプリカスタムドメイン
  5. StoreFront Cloud > Access > Edit内で、customer.cloud.com URLとカスタムURLの両方を使用を選択しました。 セカンダリSAMLアプリカスタムドメイン

  6. Identity and Access Management > Authentication内で、省略記号メニューからSAMLプロバイダーの選択 > 表示を選択します。SAML構成ページには、エンティティID、SSO URL、およびログアウトURL用に構成されたSAMLエンドポイントのペアが表示されるはずです。 セカンダリSAMLアプリカスタムドメイン
複数のカスタム URL を使用して SAML でストアにサインイン