StoreFrontのハイブリッド起動によるアプリ保護
Citrix Virtual Apps and Desktopsのハイブリッド起動では、（ネイティブブラウザーでストアURLを入力して）StoreFront for Webにサインインし、ネイティブのCitrix WorkspaceアプリとそのHDXエンジンで仮想アプリおよび仮想デスクトップを起動します。ハイブリッドという用語は、StoreFront for WebとネイティブのCitrix Workspaceアプリの組み合わせでリソースに接続して使用することを意味します。
注：
エンドポイントにネイティブのCitrix Workspaceアプリコンポーネントがインストールされていない場合、それはCitrix WorkspaceストアとHDXエンジンの両方がブラウザー内に存在するゼロインストール構成です。これはHTML5向けCitrix Workspaceアプリと呼ばれ、Citrix WorkspaceまたはCitrix StoreFrontのいずれかでホストされます。このドキュメントでは、このシナリオには対応していません。
StoreFrontのハイブリッド起動によるアプリ保護は、アプリ保護が有効なリソースを列挙してブラウザーから起動する機能を提供します。
注：
［簡易バージョンを使用］（HTML5クライアントを使用）または ［インストール済み］ オプションを選択すると、Citrix Workspaceアプリがブラウザーで正常に検出されないため、アプリ保護が有効なセッションがブロックされます。
StoreFrontのカスタマイズが展開され、ネイティブのCitrix Workspaceアプリがブラウザーで正常に検出された場合、ブラウザーを使用してアプリ保護が有効なアプリとデスクトップにアクセスできます。「展開方法」セクションを参照してください。
前提条件
Citrix Workspaceアプリバージョン1912 LTSR以降、およびStoreFrontバージョン3.12以降を使用していることを確認します。 アプリ保護に必要なCitrixコンポーネントのバージョンについて詳しくは、「システム要件」を参照してください。
展開方法
-
stf-customization-AppP.zipという名前のZipファイルをダウンロードします。これには、StoreFrontサーバーマシンに展開する必要があるすべてのファイルが含まれています。Citrixのダウンロードページからファイルをダウンロードします。ファイルには次のものが含まれます：
- ストアのbinフォルダーにコピーする必要があるDLL
- ソリューションが機能するために必要なJavaScriptファイルおよびその他のファイル
- StoreFront管理者がソリューションの展開に使用する、deploy-solution.ps1 PowerShellスクリプト
-
stf-customization-AppP.zipファイルを解凍し、ファイルが抽出された新しい管理者PowerShellを開きます。
deploy-solution.ps1コマンドを実行します。このコマンドは、次の引数を指定します。-
-Action：スクリプトが実行するアクション。許可される値は次のとおりです：-
Deployアクションは、ソリューションをシームレスに展開します。このソリューションが変更するファイルのバックアップを作成し、ソリューションファイルをコピーして、サービスを再起動します。次のスクリーンショットは、StoreFrontサーバーにソリューションを展開するコマンドです：
-
ApplyUICustomizationアクションはストアUIにカスタマイズを適用するため、［インストール済み］ オプションと ［簡易バージョンを使用］ オプションは表示されません。このアクションにより、ブラウザーでネイティブのCitrix Workspaceアプリが強制的に検出され、ブロックまたはサポートされていないシナリオを確実に回避できます。
-
RemoveUICustomizationアクションはApplyUICustomizationのアクションを元に戻し、［インストール済み］ オプションと ［簡易バージョンを使用］ オプションが再び表示されます。
-
-
-StoreName：アクションを実行する必要があるストアの名前。このパラメーターは必須であり、Deployアクションとともに渡す必要があります。 -
-BackupDir：必要なディレクトリにバックアップを作成するためにDeployアクションで渡すことができるパラメーター。渡されない場合、バックアップはデスクトップに作成されます。これはオプションのパラメーターです。
-
注：
StoreCustomization_Input.dllまたはStoreCustomization_Launch.dllに既存のカスタマイズがある場合、このソリューションを展開するとそれらが上書きされます。
アプリ保護が有効なアプリとデスクトップは、カスタマイズを展開した後にのみ列挙されます。展開しない場合、アプリとデスクトップは列挙されません。
保護されたリソースのハイブリッド起動に関するエンドユーザーエクスペリエンス
-
管理者がStoreFrontサーバーにソリューションを展開後、クライアント側でストアにサインインします。次に、WebブラウザーでURLを使用してStoreFrontにアクセスします。
-
Citrix Workspaceアプリがブラウザーで正常に検出されたかどうかを確認するには、［アカウント設定］ で ［現在のステータス］ を確認します。
-
Citrix Workspaceアプリが正常に検出されると、アプリ保護が有効になっているすべての仮想アプリとデスクトップを表示して起動できます。
StoreFrontでトレースを有効にする
StoreFrontでトレースを有効にして、ログを収集できます。トレース機能は、詳細情報をトレースに書き込みます。このトレースを使用して、構成されたNetScaler Gatewayセッションポリシーラベルがストアに適切に渡されているかどうかを確認できます。StoreFrontサーバー上のトレースダンプのデフォルトの場所は C:\Program Files\Citrix\Receiver StoreFront\Admin\traceです。
トレースを有効にしてトレースレベルを設定するには、PowerShellスクリプトSetDSStoreCustomizationTraceLevel.ps1を使用します。このスクリプトは、 こちらにあるパブリックのStoreFrontカスタマイズSDKで提供されます。このスクリプトの実行時に、以下のパラメーターを入力する必要があります：
- SiteId：ストアが展開されているIISサイトID
- VirtualPath：ストアへの仮想パス
- TraceLevel：Error、Info、Off、Verbose、およびWarningのトレースレベルを設定
次のPowerShellコマンドを実行して、ストアのSiteIdとVirtualPathを確認します：cd 'c:\program files\Citrix\Receiver Storefront\Scripts'.
.\ImportModules.ps1
Get-DSStoreFeatureInstances
PowerShellスクリプトSetDSStoreCustomizationTraceLevel.ps1の実行中に、コマンドから取得したSiteIdとVirtualPathを使用します。
トラブルシューティング
アプリ保護が有効なセッションを起動すると、次のエラーが発生することがあります：
このエラーの考えられる原因は次のとおりです：
-
アプリとデスクトップが、ブラウザーで開くように構成されています。
次の画面に示すように、Citrix Workspaceアプリの検出中に ［簡易バージョンを使用］ をクリックすると、このシナリオに直面します。
-
ブラウザーがCitrix Workspaceアプリを検出しません。
次の画面に示すように、Citrix Workspaceアプリの検出中に ［インストール済み］ をクリックすると、このシナリオに直面します。
ソリューション：上記のシナリオに対応し、アプリ保護が有効なセッションを起動するには、［アカウント設定］ で ［Citrix Workspaceアプリを変更］ をクリックし、Citrix Workspaceアプリが検出されるまで待ちます。
最適化
アプリ保護が有効なセッションを開始するには、Citrix Workspaceアプリの検出が必須です。保護されたセッションのハイブリッド起動中の障害を回避するために、StoreFront管理者はdeploy-solution.ps1コマンドのApplyUICustomizationアクションを使用して、［簡易バージョンを使用］ オプションと ［インストール済み］ オプションを非表示にすることができます。