Citrix Workspace app for Windows

Storebrowse

注:

この記事は、Citrix Workspaceのオンプレミス展開にのみ適用されます。クラウド展開については、「Workspaceの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 Server 2022
Windows Server 2016
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基本:外部ユーザーインターフェイスを使用してドメイン修飾ユーザー名とパスワードを取得する、サードパーティクライアント統合およびWebポータルで使用されます。StoreFrontは、IISの基本認証機能を使用して、資格情報をStoreFrontサーバーに転送します。次に、StoreFrontはDomain ServicesまたはBroker XML Service認証を使用して資格情報を検証し、グループ情報を取得します。HTTP基本認証を有効にする方法については、「認証方法の管理」ドキュメントの「HTTP基本」 を参照してください。

Storebrowseユーティリティは、以下のいずれかの方式の認証方法をサポートします:

  • Storebrowseユーティリティに組み込みのAuthManagerを使用します。注:Storebrowseユーティリティを使用する場合、StoreFrontでHTTP基本認証方式を有効にします。この方法は、ユーザーがStorebrowseコマンドを使用して資格情報を提供する場合に適用されます。
  • Windows向けCitrix Workspaceアプリに含まれるAuthmanagerを使用します。ドメインパススルー認証を使用する場合は、この方法を使用できます。詳しくは、「ドメインパススルー認証」を参照してください。

公開デスクトップまたはアプリケーションからの起動

ICAファイルを使用せずに、ストアから直接リソースを起動できるようになりました。

注:

Storebrowseコマンドを使用してSaaSアプリ、または公開コンテンツを開くことはできません。

コマンドの使用方法

以下のセクションでは、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

Storebrowseコマンドのステータスの追跡

2305.1リリース以降、Storebrowseコマンドの実行ステータスをファイルで追跡できます。成功ステータスを追跡するには、-f launchコマンドで一意のファイル名を指定します。このコマンドは、指定した名前のファイルを生成します。失敗ステータスは、自動的に作成されるica.errorファイルに存在します。

注:

-f launchコマンドでファイル名に必ず.ica 拡張子を追加してください。そうしない場合、ファイルは生成されません。

成功と失敗の両方を追跡するファイルは%LOCALAPPDATA%\citrix\selfservice\cacheにあり、必要に応じてこれらのファイルを監視できます。

この拡張機能は、デフォルトで有効になっています。

以下は、-fオプションで起動コマンドを使用する例です:


-launch -f <uniqueFileName.ica> "launchcommandline"
For example:
SelfService.exe storebrowse -launch -f uniqueFileName.ica -s store0-5c3ec017 -CitrixID store0-5c3ec017@@a9a8e3ac-099d-4577-b84e-e33d0695df39.Notepad -ica "https://cwawiniwstest.cloudburrito.com/Citrix/Store/resources/v2/YTlhOGUzYWMtMDk5ZC00NTc3LWI4NGUtZTMzZDA2OTVkZjM5Lk5vdGVwYWQ-/launch/ica" -cmdline

<!--NeedCopy-->

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でシングルサインオン機能を有効にできます。

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

注:

  • セミコロンで区切られた複数のサードパーティアプリケーションを提供できます。
  • この機能は、バージョン2107以降でサポートされています。
Storebrowse