仮想チャネル許可リスト
The virtual channel allow list is a feature that allows you to control which non-Citrix virtual channels are allowed in your environment. By default, the virtual channel allow list feature is enabled. As a result, only Citrix virtual channels are allowed to open in Citrix Virtual Apps and Desktops™ sessions. If there is a need to use custom virtual channels, whether homegrown or from a third party, these need to be explicitly added to the allow list.
構成
仮想チャネル許可リストはデフォルトで有効になっています。この機能は、Citrixポリシーの以下の設定を使用して構成できます。
-
仮想チャネル許可リスト: この機能を有効または無効にし、仮想チャネルをリストに追加します。
-
仮想チャネル許可リストログスロットリング: 仮想チャネル許可リストイベントログのスロットリング期間を設定します。
-
仮想チャネル許可リストログ記録: 仮想チャネル許可リストのログレベルを設定します。
仮想チャネルを許可リストに追加する
仮想チャネルを許可リストに追加するには、以下の情報が必要です。
-
コードで定義されている仮想チャネル名。最大7文字です。例:
CTXCVC1。 -
VDAマシン上で仮想チャネルを開くプロセスのパス。例:
C:\Program Files\Application\run.exe。
必要な情報が揃ったら、仮想チャネル許可リストポリシー設定を使用して、仮想チャネルを許可リストに追加する必要があります。リストに仮想チャネルを追加するには、仮想チャネル名の後にコンマ、そして仮想チャネルにアクセスするプロセスのパスを入力します。複数のプロセスがある場合は、各プロセスをコンマで区切って追加できます。
単一プロセスの場合
前の例を使用して、以下のエントリをリストに追加します。
CTXCVC1,C:\Program Files\Application\run.exe
複数のプロセスの場合
複数のプロセスがある場合は、次のエントリをリストに追加します。
CTXCVC1,C:\Program Files\Application\run.exe,C:\Program Files\Application\run2.exe
ワイルドカードの使用
ワイルドカード (*) の使用がサポートされています。アプリケーションのバージョンに基づいてディレクトリ名または実行可能ファイル名が変更される場合、またはサードパーティコンポーネントがユーザープロファイルにインストールされている場合に、ワイルドカードを使用できます。
次のシナリオでワイルドカードを使用できます。
-
完全なディレクトリ名を置き換える場合。 例:
C:\Program Files\Application*\run1.exe -
ディレクトリ名の一部を置き換える場合。 例:
C:\Program Files\Application\v*\run1.exe -
実行可能ファイル名を置き換える場合。 例:
C:\Program Files\Application\v1.2*.exe -
実行可能ファイル名の一部を置き換える場合。 例:
C:\Program Files\Application\v1.2\run*.exe
次の制限が適用されます。
-
ワイルドカードは単一のディレクトリを置き換えるためにのみ使用できます。たとえば、実行可能ファイルが
C:\Program Files\Application\v1.2\run1.exeにある場合-
許可:
C:\Program Files\Application*\run1.exe -
不許可:
C:\Program Files*\run1.exe
-
-
エントリにはファイル名拡張子を含める必要があります。
-
許可:
C:\Program Files\Application\v1.2*.exe -
許可されていません:
C:\Program Files\Application\v1.2*
-
-
すべてのパスはローカルである必要があります。
注:
-
ネットワークパスは許可されていません。
-
ワイルドカードのサポートは、Citrix Virtual Apps™ and Desktops 2206 から利用可能です。
-
ワイルドカードのサポートは、Citrix Virtual Apps and Desktops 2203 LTSR の CU2 から利用可能です。
システム環境変数の使用
システム環境変数を使用して、許可リスト内の信頼されたプロセスの定義を簡素化できます。
%programfiles%、%programfiles(x86)%、%systemdrive%、%systemroot% など、標準で提供されている任意の変数を使用できます。
カスタム環境変数も、システムレベルで定義されている限り使用できます。
以下に、標準で提供されている環境変数の例を示します。
-
%programfiles%\Application\v1.2\run.exe -
%programfiles%\Application*\run.exe -
%programfiles(x86)%\Application\v1.*\run.exe
以下に、カスタムシステム環境変数の例を示します。
-
カスタム変数名:
app -
カスタム変数値:
%programfiles%\Application\ -
許可リストエントリ:
CTXCVC1,%app%\run.exe
注:
ユーザー環境変数はサポートされていません。
環境変数サポートは、Citrix Virtual Apps and Desktops バージョン 2209 から利用可能です。
仮想チャネル名とプロセスを取得する
VDAマシン上で仮想チャネルの名前とそれを開くプロセスを取得する最も簡単な方法は、仮想チャネルを提供した開発者またはサードパーティベンダーから情報を取得することです。
または、機能のログを適用し、以下の手順に従うことで情報を取得できます。
-
カスタム仮想チャネルのクライアントおよびサーバーコンポーネントが配置されたら、仮想アプリケーションまたは仮想デスクトップを起動します。
-
VDAマシンのシステムイベントログで、カスタム仮想チャネルの名前と、それを開こうとしたプロセスを探します。利用可能なイベントの詳細については、イベントログを参照してください。
-
セッションからログアウトします。
-
特定された仮想チャネルとプロセスに対して、仮想チャネル許可リストポリシー設定にエントリを追加します。
-
マシンを再起動します。
-
VDAが登録されたら、仮想アプリケーションまたは仮想デスクトップを実行して、カスタム仮想チャネルが正常に開くことを検証します。
Citrix仮想チャネルに関する考慮事項
すべての組み込みCitrix仮想チャネルは信頼されており、追加設定なしで開くことができます。ただし、以下の2つの機能は、外部依存関係のため、許可リストに明示的なエントリが必要です。
-
マルチメディアリダイレクト
-
Skype for Business 用 HDX リアルタイム最適化パック
マルチメディアリダイレクト
システムのメディアプレーヤーとしてWindows Media Player以外のメディアプレーヤーを使用する場合、それを信頼されたプロセスとして許可リストに追加する必要があります。許可リストのエントリには、以下の情報が必要です。
-
仮想チャネル名:
CTXMM -
プロセス: VDAマシンで使用されるメディアプレーヤーへのパス。例:
C:\Program Files (x86)\Windows Media Player\wmplayer.exe。 -
許可リストエントリ:
CTXMM,C:\Program Files (x86)\Windows Media Player\wmplayer.exe
Skype for Business 用 HDX リアルタイム最適化パック
許可リストのエントリには、以下の情報が必要です。
-
仮想チャネル名:
CTXRMEP -
プロセス: VDAマシン内のSkype for Business実行可能ファイルへのパス。これはSkype for Businessのバージョンやカスタムインストールパスの使用によって異なる場合があります。例:
C:\Program Files\Microsoft Office\root\Office16\lync.exe.. -
許可リストエントリ:
CTXRMEP,C:\Program Files\Microsoft Office\root\Office16\lync.exe