Storebrowse
Storebrowseは、クライアントとサーバー間の相互通信に使用されるコマンドラインユーティリティです。StoreFront内およびCitrix Gateway内のすべての操作を認証するために使用されます。
Storebrowseユーティリティを使用すると、管理者は以下のような操作を自動化できます:
- ストアを追加します。
- 構成済みのストアから公開アプリと公開デスクトップを一覧表示します。
- 公開された仮想アプリと仮想デスクトップを選択して、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] |
要件
- Windows向けCitrix Workspaceアプリバージョン1808以降。
- 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基本:HTTP基本認証を有効にすると、StorebrowseユーティリティがStoreFrontサーバーと通信できます。デフォルトでは、このオプションはStoreFrontサーバーで無効になっています。HTTP基本認証方式を有効にします。
Storebrowseユーティリティは、以下のいずれかの方式の認証方法をサポートします:
-
Storebrowseユーティリティに組み込みの
AuthManager
を使用します。注:Storebrowseユーティリティを使用する場合、StoreFrontでHTTP基本認証方式を有効にします。これは、ユーザーがStorebrowseコマンドを使用して資格情報を提供する場合に適用されます。 - Windows向けCitrix Workspaceアプリに外部
Authmanager
を含めることができます。
Citrix Gatewayでのシングルサインオン
Citrix Gatewayのサポートに加えて、シングルサインオンを使用できるようになりました。ユーザー資格情報を提供することなく、ストアを追加し、公開リソースを列挙することができます。
Citrix Gatewayでシングルサインオンを使用する方法については、「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`
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
オプションを使用するには、起動URLとストアURLの入力が必要です。起動URLは、StoreFrontサーバーまたはCitrix Gateway 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ファイルを生成します。起動オプションを使用するには、リソース名とストア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
前の結果で太字の名前は、起動オプションの入力パラメーターとして使用されます。
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
説明:
公開アプリおよび公開デスクトップのカスタムパスに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
説明:
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(Citrix Virtual Apps and Desktopsサービスの新名称)を使用できます。各アプリやデスクトップに再認証する必要なくサインインできます。ストアを追加すると、Citrix Virtual Apps and DesktopsおよびCitrix DaaSとともに資格情報とスタートメニューの設定がCitrix Gatewayサーバーにパススルーされます。
この機能は、Citrix Gatewayバージョン11以降でサポートされています。
前提条件:
Citrix Gatewayのシングルサインオンを構成するための前提条件については、「ドメインパススルー認証の構成」を参照してください。
グループポリシーオブジェクト(GPO)管理用テンプレートを使用してCitrix Gatewayでシングルサインオン機能を有効にできます。
- 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)
では大文字小文字が区別され、大文字のみを使用する必要があります。
ICOSDKを使用するサードパーティのアプリケーションでSSONを有効にするには、次のレジストリを作成します:
- レジストリキー:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson
- レジストリ値:サードパーティアプリケーションのフルパス
- レジストリの種類:reg_multi_sz
例:
- レジストリキー:
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson
- レジストリ値:C:\temp1\abc.exe;C:\temp2\xyz.exe
- レジストリの種類:reg_multi_sz
注:
- セミコロンで区切られた複数のサードパーティアプリケーションを提供できます。