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] |
要件
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以降
注:
HTTPストアでは、Storebrowseユーティリティはコマンドラインを使用して資格情報を受け入れません。
認証方法
StoreFrontサーバー
StoreFrontはストアにアクセスするためのさまざまな認証方法をサポートしていますが、すべてが推奨されるわけではありません。セキュリティ上の理由から、一部の認証方法はストア作成時にデフォルトで無効になっています。
- ユーザー名とパスワード: ストアにアクセスするために認証される資格情報を入力します。デフォルトでは、最初のストアを作成する際に明示的認証が有効になります。
- ドメインパススルー: ドメイン参加済みWindowsコンピューターで認証された後、ストアに自動的にログオンします。このオプションを使用するには、Citrix Workspaceアプリのインストール時にパススルー認証を有効にします。ドメインパススルーの詳細については、パススルー認証の構成を参照してください。
- HTTP Basic: この方法は、サードパーティのクライアント統合およびWebポータルで使用され、外部ユーザーインターフェイスがドメイン修飾ユーザー名とパスワードをキャプチャするために使用されています。StoreFrontはIISの基本認証機能を使用して資格情報をStoreFrontサーバーに転送します。その後、StoreFrontはドメインサービスまたはブローカーXMLサービス認証を使用して資格情報を検証し、グループ情報を取得します。HTTP基本認証を有効にする方法については、認証方法の管理ドキュメントのHTTP Basicを参照してください。
Storebrowseユーティリティは、次のいずれかの方法で認証方法をサポートしています。
-
Storebrowseユーティリティに組み込まれている
AuthManagerを使用する。注: Storebrowseユーティリティを使用する際は、StoreFrontでHTTP基本認証方法を有効にしてください。この方法は、ユーザーがStorebrowseコマンドを使用して資格情報を提供する際に適用されます。 - Windows向けCitrix Workspaceアプリに含まれる
Authmanagerを使用する。この方法は、ドメインパススルー認証を使用する場合に利用できます。詳細については、ドメインパススルー認証ドキュメントを参照してください。
公開済みデスクトップまたはアプリケーションの起動
ICAファイルを使用せずに、ストアから直接リソースを起動できるようになりました。
注:
SaaSアプリまたは公開コンテンツは、Storebrowseコマンドを使用して開くことはできません。
コマンドの使用法
次のセクションでは、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>
上記は、ゲートウェイで構成されたStoreFrontが単一のストアを持つ場合に機能します。
ゲートウェイで構成されたStoreFrontが複数のストアを持つ場合、次のコマンドを使用する必要があります。
コマンド: storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*?StoreName
-
例:
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a https://mysecondexample.com?Store -
ヘルプ
/?
説明:
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ファイルをカスタムパスに生成します。
起動オプションでは、入力としてフォルダー名とリソース名、およびStore URLが必要です。Store 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のシングルサインオンの構成方法に関する前提条件については、「ドメインパススルー認証の構成」を参照してください。
Citrix Gatewayでのシングルサインオン機能は、グループポリシーオブジェクト（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)は大文字と小文字を区別し、大文字のみである必要があります。
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セッション処理の強化
このリリース以降、Storebrowseのセッション処理は以下の機能強化により改善され、高可用性環境でのユーザーエクスペリエンスと重要なリソース管理を最適化し、効率を向上させます。
-
Storebrowseは仮想アプリケーションの起動時に既存のセッションをインテリジェントに無視します - このオプションは、システムによって現在アクティブに切断されているセッションへの再接続を防ぎ、安定性を向上させます。これにより、特にクライアントの更新中に、重要なビジネスアプリケーションへのシームレスでエラーのないアクセスが保証され、複雑な構成の必要性を減らすことで管理が簡素化されます。インテリジェントなセッション処理を有効にするには、管理者は既存のStorebrowseコマンドに
-I trueパラメーターを追加する必要があります。このパラメーターは、現在の構文構造を維持しながら、既存のすべての起動タイプとシームレスに統合されます。コマンド例：
クイック起動：
以前の構文：
.\storebrowse.exe -U {Username} -P {Password} –D {Domain} -q {Launch_URL_of_published_ apps and desktops} <https://cwa-ddc2c.cwa.com/Citrix/Store/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9yLVRTVkRBMTk-/launch/ica> < https://cwa-ddc2c.cwa.com/citrix/store/discovery> <!--NeedCopy-->インテリジェントなセッション処理による強化された構文：
.\storebrowse.exe -U {Username} -P {Password} –D {Domain} -I true -q {Launch_URL_of_published_ apps and desktops} https://cwa-ddc2c.cwa.com/Citrix/Store/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9yLVRTVkRBMTk-/launch/ica> < https://cwa-ddc2c.cwa.com/citrix/store/discovery> <!--NeedCopy--> -
Storebrowse APIによるセッションリスト返却のサポート - このオプションは、アクティブなユーザーセッションへの貴重な可視性を提供し、より状況に応じた効率的なセッション起動を可能にします。この改善された可視性により、アプリケーションアクセス中のユーザーに影響を与えるエラーや遅延が減少し、すべてのユーザーにとってよりスムーズで信頼性の高いエクスペリエンスが保証されます。