Storebrowse
Storebrowseは、クライアントとサーバー間の対話に使用される軽量コマンドラインユーティリティです。StoreFront内およびCitrix Gatewayとのすべての操作を認証するために使用されます。
-
Citrix Receiver for Windows用Storebrowseユーティリティの以前のバージョンに関するドキュメントについては、「Storebrowse for Citrix Receiver for Windows」ドキュメントを参照してください。
-
Storebrowseユーティリティを使用すると、管理者は次の日常業務を自動化できます。
- ストアを追加
- 構成済みストアから公開されているCitrix Virtual Apps and Desktops™およびCitrix DaaS（旧Citrix Virtual Apps and Desktopsサービス）を列挙
- 公開されているCitrix Virtual Apps and DesktopsおよびCitrix DaaSを手動で選択してICAファイルを生成
- Storebrowseコマンドラインを使用してICA®ファイルを生成
- 公開されたアプリケーションを起動
Storebrowseユーティリティは、Authmanagerコンポーネントの一部になりました。Citrix Workspaceアプリのインストール後、StorebrowseユーティリティはAuthManagerインストールフォルダーにあります。
StorebrowseユーティリティがAuthmanagerコンポーネントとともにインストールされているかどうかは、次の方法でレジストリパスを確認することで確認できます。
管理者がCitrix Workspaceアプリをインストールした場合:
| 32ビットマシン | [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\AuthManager\Install] |
| 64ビットマシン | [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install] |
ユーザー（管理者以外）がCitrix Workspaceアプリをインストールした場合:
| 32ビットマシン | [HKEY_CURRENT_USER\SOFTWARE\Citrix\AuthManager\Install] |
| 64ビットマシン | [HKEY_CURRENT_USER\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install] |
要件
StoreFrontとCitrix Gateway間でStorebrowseユーティリティがシームレスに動作するように、Citrix Workspaceアプリfor Windowsバージョン1808以降をインストールします。Citrix Workspaceアプリバージョン1809のインストールには、最低530MBの空きディスク容量と2GBのRAMが必要です。
互換性マトリックス
-
Storebrowseユーティリティは、次のオペレーティングシステムと互換性があります。
-
オペレーティングシステム Windows 10 32ビット版および64ビット版 Windows 8.1 32ビット版および64ビット版 Windows 7 SP1 32ビット版および64ビット版 Windows Thin PC Windows Server 2016 -
Windows Server 2012 R2 StandardおよびDatacenterエディション -
Windows Server 2012 StandardおよびDatacenterエディション -
Windows Server 2008 R2 64ビット版 Windows Server 2008 R2 64ビット版 -
接続
Storebrowseユーティリティは、次の種類の接続をサポートします。
- HTTPストア
- HTTPSストア
- Citrix Gateway 11.0以降
注:
Storebrowseユーティリティは、HTTPストアでコマンドラインを使用して資格情報を受け入れません。
認証方法
StoreFrontサーバー
StoreFrontはストアにアクセスするためのさまざまな認証方法をサポートしますが、すべてが推奨されるわけではありません。セキュリティ上の理由から、ストアの作成時に一部の認証方法がデフォルトで無効になっています。
- ユーザー名とパスワード: ユーザーは資格情報を入力し、ストアにアクセスする際に認証されます。最初のストアを作成する際、明示的な認証はデフォルトで有効になっています。すべてのユーザーアクセス方法が明示的な認証をサポートしています。
- ドメインパススルー: ユーザーはドメイン参加済みWindowsコンピューターで認証され、ストアにアクセスする際に自動的にログオンされます。このオプションを使用するには、ユーザーデバイスにCitrix Workspaceアプリがインストールされているときにパススルー認証を有効にする必要があります。ドメインパススルーの構成の詳細については、「パススルー認証の構成」を参照してください。
- HTTP Basic: StoreFrontサーバーと通信するには、StorebrowseユーティリティでHTTP Basic認証を有効にする必要があります。このオプションはStoreFrontサーバーでデフォルトで無効になっています。HTTP Basic認証方法を有効にする必要があります。
Storebrowseユーティリティは、次のいずれかの方法で認証方法をサポートします。
- Storebrowseユーティリティに組み込まれている
AuthManagerを使用。注：Storebrowseユーティリティを使用する際は、StoreFrontでHTTP Basic認証方法を有効にする必要があります。これは、ユーザーがStorebrowseコマンドを使用して資格情報を提供する際に適用されます。 - Citrix Workspaceアプリfor Windowsに含めることができる外部
Authmanager。
Citrix Gatewayのサポート
Storebrowseユーティリティの最新リリースにより、Citrix GatewayのURLを追加できるようになりました。Citrix Gatewayと通信するために、Storebrowseユーティリティに追加の構成は必要ありません。
Citrix Gatewayでのシングルサインオン
新たに追加されたCitrix Gatewayのサポートに加えて、シングルサインオンを使用できるようになりました。ユーザー資格情報を提供することなく、新しいストアを追加し、公開されたリソースを列挙できます。
Citrix Gatewayでのシングルサインオンのサポートの詳細については、「Support for single sign-on with Citrix Gateway」を参照してください。
注:
この機能は、Citrix Gatewayがシングルサインオン認証で構成されているドメイン参加済みマシンでのみサポートされます。
公開されたデスクトップまたはアプリケーションの起動
ICAファイルを使用せずに、ストアから直接リソースを起動できるようになりました。
コマンドの使用法
次のセクションでは、Storebrowseユーティリティから使用できるコマンドに関する詳細情報を提供します。
-a, –addstore
説明:
新しいストアを追加します。ストアの完全なURLを返します。失敗した場合は、エラーが報告されます。
注:
Storebrowseユーティリティを使用して複数のストアを追加できます。
StoreFrontでのコマンド例:
コマンド:
storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of StoreFront*
例:
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a [https://my.firstexamplestore.net](https://my.firstexamplestore.net)
Citrix Gatewayでのコマンド例:
コマンド:
storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*
例:
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a <https://mysecondexample.com>
/?
説明:
Storebrowseユーティリティの使用方法に関する詳細情報を提供します。
(-l), –liststore
説明:
ユーザーによって追加されたストアを一覧表示します。
StoreFrontでのコマンド例:
.\storebrowse.exe –l
Citrix Gatewayでのコマンド例:
.\storebrowse.exe –l
(-M 0x2000 -E)
説明:
利用可能なリソースを列挙します。
StoreFrontでのコマンド例:
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.firstexamplestore.net/Citrix/Store/discovery>
Citrix Gatewayでのコマンド例:
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.secondexample.net>
-q, –quicklaunch
説明:
Storebrowseユーティリティを使用して、公開されたアプリとデスクトップに必要なICAファイルを生成します。quicklaunchオプションは、Store URL（StoreFrontサーバーまたはCitrix Gateway URLのいずれか）とともに、入力として起動URLを必要とします。ICAファイルは、%LocalAppData%\Citrix\Storebrowse\cacheディレクトリに生成されます。
-
公開されたアプリとデスクトップの起動URLは、次のコマンドを実行することで取得できます。
-
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery -
一般的な起動URLは次のようになります。
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
StoreFrontでのコマンド例:
.\storebrowse.exe –U {Username} –P {Password}–D {Domain} –q {Launch_URL_of_published_ apps and desktops }<https://my.firstexamplestore.net/Citrix/Store/resources/v2/Q2hJkOlmNoPQrSTV9y/launch/ica> <https://my.firstexamplestore.net/Citrix/Store/discovery>
Citrix Gatewayでのコマンド例:
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –q {Launch_URL_of_published_ apps and desktops} <https://my.secondexmaplestore.com>
-L, –launch
説明:
Storebrowseユーティリティを使用して、公開されたアプリとデスクトップに必要なICAファイルを生成します。launchオプションは、Store URL（StoreFrontサーバーまたはCitrix Gateway URLのいずれか）とともに、リソース名を必要とします。ICAファイルは、%LocalAppData%\Citrix\Storebrowse\cacheディレクトリに生成されます。
公開されたアプリとデスクトップの表示名は、次のコマンドを実行することで取得できます。
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery
このコマンドは次の出力を生成します。
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
上記の出力で太字になっている名前は、launchオプションの入力パラメーターとして使用されます。
StoreFrontでのコマンド例:
.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –L “{Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery>
Citrix Gatewayでのコマンド例:
<.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –L {Resource_Name} https://my.secondexamplestore.com>
-S, –sessionlaunch
説明:
ストアを追加し、公開されているリソース（アプリとデスクトップ）を列挙し、単一のコマンドでリソースを起動できます。このオプションは、ユーザー名、パスワード、ドメイン、起動するリソースのフレンドリ名、ストアURLをパラメーターとして受け取ります。ただし、ユーザーが資格情報を提供しない場合、資格情報の入力を求めるAuthManagerプロンプトが表示され、その後リソースが起動されます。
公開されているアプリとデスクトップのリソース名は、以下のコマンドを実行することで取得できます。
.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery
このコマンドを実行すると、以下の出力が得られます。
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
上記出力で太字になっている名前は、-Sオプションへの入力パラメーターとして使用されます。
StoreFrontでのコマンド例:
.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –S “{Friendly_Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery >
Citrix Gatewayでのコマンド例:
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –S {Friendly_Resource_Name} <https://my.secondexamplestore.com>
-f, –filefolder
説明:
Storebrowseユーティリティを使用して公開されている任意のアプリとデスクトップに対して、–fオプションで定義されたカスタムパスに、必要なICAファイルを生成します。
起動オプションでは、ストアURLとともにリソース名とフォルダー名を入力として必要とします。ストアURLは、StoreFrontサーバーまたはCitrix Gateway URLのいずれかです。
StoreFrontでのコマンド例:
.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {Store}
Citrix Gatewayでのコマンド例:
.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {NSG_URL}
-t, –traceauthentication
説明:
Storebrowseユーティリティに組み込まれているAuthManagerコンポーネントのログを生成します。ログは、Storebrowseユーティリティが組み込みのAuthManagerを使用している場合にのみ生成されます。ログはlocalappdata%\Citrix\Storebrowse\logsディレクトリに生成されます。
注：このオプションは、ユーザーのコマンドラインで最後にリストされるパラメーターにすることはできません。
StoreFrontでのコマンド例:
.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {StoreURL}
Citrix Gatewayでのコマンド例:
.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {NSG_URL}
-d, –deletestore
説明:
既存のStoreFrontまたはCitrix Gatewayストアを削除します。
StoreFrontでのコマンド例:
.\storebrowse.exe –d https://my.firstexamplestore.net/Citrix/Store/discovery
Citrix Gatewayでのコマンド例:
.\storebrowse.exe –d https://my.secondexmaplestore.com
Citrix Gatewayでのシングルサインオンのサポート
シングルサインオンを使用すると、ドメインに認証し、そのドメインによって提供されるCitrix Virtual Apps and DesktopsおよびCitrix DaaS™を、各アプリまたはデスクトップに再認証することなく使用できます。Storebrowseユーティリティを使用してストアを追加すると、資格情報は、列挙された仮想アプリとデスクトップ、およびスタートメニューの設定とともに、Citrix Gatewayサーバーに渡されます。シングルサインオンを構成すると、ストアを追加し、仮想アプリとデスクトップを列挙し、資格情報を複数回入力することなく、必要なリソースを起動できます。
この機能は、Citrix Gatewayバージョン11以降でサポートされています。
前提条件:
Citrix Gatewayのシングルサインオンを構成するための前提条件については、ドメインパススルー認証の構成を参照してください。
Citrix Gatewayでのシングルサインオン機能は、グループポリシーオブジェクト（GPO）管理用テンプレートを使用して有効にできます。
注:
Citrix ReceiverからCitrix Workspaceアプリにアップグレードする場合、またはCitrix Workspaceアプリを初めて新規インストールする場合、最新のテンプレートファイルをローカルGPOに追加する必要があります。ローカルGPOへのテンプレートファイルの追加の詳細については、グループポリシーオブジェクト管理用テンプレートの構成を参照してください。アップグレードの場合、最新のファイルがインポートされても既存の設定は保持されます。
- gpedit.mscを実行してCitrix WorkspaceアプリGPO管理用テンプレートを開きます
- コンピューターの構成ノードで、管理用テンプレート > Citrixコンポーネント > Citrix Workspace > ユーザー認証 > Citrix Gatewayのシングルサインオンに移動します。
- トグルオプションを使用して、シングルサインオンオプションを有効または無効にします。
- 適用をクリックし、OKをクリックします。
- 変更を有効にするには、Citrix Workspaceアプリセッションを再起動します。
制限事項:
- Storebrowseユーティリティでの資格情報インジェクション操作には、StoreFrontサーバーでHTTP基本認証方法を有効にする必要があります。
- HTTPストアがあり、ユーティリティを使用してストアに接続し、公開されている仮想アプリとデスクトップを列挙または起動しようとすると、コマンドラインオプションを使用した資格情報インジェクションはサポートされていません。回避策として、コマンドラインを使用して資格情報を提供しない場合にトリガーされる外部
AuthManagerモジュールを使用してください。 - Storebrowseユーティリティは現在、StoreFrontサーバーで構成された単一ストアのCitrix Gatewayのみをサポートしています。
- Storebrowseユーティリティでの資格情報インジェクションは、Citrix Gatewayがシングルファクター認証で構成されている場合にのみ機能します。
- Storebrowseユーティリティのコマンドラインオプション
Username (-U)、Password (-P)、およびDomain (-D)は大文字と小文字を区別し、大文字のみである必要があります。