Storebrowse

Storebrowseは、クライアントとサーバー間の相互通信に使用されるコマンドラインユーティリティです。StoreFront内およびCitrix Gateway内のすべての操作を認証するために使用されます。

Citrix Receiver for Windowsの古いバージョンのStorebrowseユーティリティに関するドキュメントは、Storebrowse for Citrix Receiver for Windowsを参照してください。

Storebrowseユーティリティを使用すると、管理者は以下のような操作を自動化できます:

  • ストアを追加します。
  • 構成済みのストアから公開アプリおよびデスクトップを列挙します。
  • 公開されたCitrix Virtual Apps and Desktopsを選択して、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](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ファイルを生成します。クイック起動オプションを使用するには、起動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 Virtual Apps and Desktopsとともに資格情報とスタートメニューの設定がCitrix Gatewayサーバーにパススルーされます。

この機能は、Citrix Gatewayバージョン11以降でサポートされています。

前提条件:

Citrix Gatewayのシングルサインオンを構成するための前提条件については、「ドメインパススルー認証の構成」を参照してください。

グループポリシーオブジェクト(GPO)管理用テンプレートを使用してCitrix Gatewayでシングルサインオン機能を有効にできます。

注:

Citrix ReceiverからCitrix Workspaceアプリをアップグレードする場合、または初めてインストールする場合、最新のテンプレートファイルをローカルGPOに追加する必要があります。テンプレートファイルをローカルGPOに追加する方法について詳しくは、「グループポリシーオブジェクト管理用テンプレート」を参照してください。アップグレードの場合、最新のファイルをインポートするときに既存の設定が保持されます。

  1. gpedit.mscを実行して、Citrix WorkspaceアプリGPO管理用テンプレートを開きます。
  2. [コンピューターの構成] ノードで、[管理用テンプレート]>[Citrixコンポーネント]>[Citrix Workspace]>[ユーザー認証]>[Citrix Gatewayのシングルサインオン] に移動します。
  3. シングルサインオンオプションで[有効]または[無効]に切り替えます。
  4. [適用][OK] の順にクリックします。
  5. Citrix Workspaceアプリのセッションを再起動して、この変更を適用します。

制限事項:

  • Storebrowseユーティリティでの資格情報入力操作のために、StoreFrontサーバーでHTTP基本認証を有効にします。
  • Citrix Virtual Apps and Desktopsを列挙または起動するためにユーティリティを使用してHTTPストアに接続しようとする場合、コマンドラインオプションを使用した資格情報の入力はサポートされません。この問題を回避するには、コマンドラインで資格情報を提供しないときに外部AuthManagerモジュールを使用します。
  • Storebrowseユーティリティは、現在、StoreFrontサーバー上のCitrix Gatewayで構成された単一ストアのみをサポートしています。
  • Storebrowseユーティリティの資格情報の入力は、Citrix Gatewayが単一要素認証で構成されている場合にのみ機能します。
  • StorebrowseユーティリティのコマンドラインオプションUsername (-U)Password (-P) Domain (-D)では大文字小文字が区別され、大文字のみを使用する必要があります。