Storebrowse

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

• Storebrowseユーティリティを使用すると、管理者は次の操作を自動化できます。

• ストアの追加
• 構成済みストアからの公開済みアプリとデスクトップのリスト表示
• 公開済み仮想アプリとデスクトップを手動で選択してICA®ファイルを生成
• Storebrowseコマンドラインを使用してICAファイルを生成
• 公開済みアプリケーションの起動

Storebrowseユーティリティは、Authmanagerコンポーネントの一部です。Citrix Workspaceアプリのインストールが完了すると、StorebrowseユーティリティはAuthManagerインストールフォルダーにあります。

StorebrowseユーティリティがAuthmanagerコンポーネントとともにインストールされていることを確認するには、次のレジストリパスを確認します。

Citrix Workspaceアプリが管理者によってインストールされている場合:

• 64ビットマシン

  [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install]

• Citrix Workspaceアプリがユーザー（管理者以外）によってインストールされている場合:

要件

• Windows向けCitrix Workspaceアプリバージョン1808以降
• 530 MB以上の空きディスク容量
• 2 GBの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以降

注：

HTTPストアでは、Storebrowseユーティリティはコマンドラインを使用して資格情報を受け入れません。

認証方法

StoreFrontサーバー

StoreFrontはストアにアクセスするためのさまざまな認証方法をサポートしていますが、すべてが推奨されるわけではありません。セキュリティ上の理由から、ストアの作成時には一部の認証方法がデフォルトで無効になっています。

• ユーザー名とパスワード: ストアにアクセスするために認証情報を入力します。デフォルトでは、最初のストアを作成するときに明示的認証が有効になります。
• ドメインパススルー: ドメイン参加済みWindowsコンピューターで認証後、ストアに自動的にサインインします。このオプションを使用するには、Citrix Workspaceアプリのインストール時にパススルー認証を有効にします。ドメインパススルーの詳細については、「パススルー認証の構成」を参照してください。
• HTTP Basic: StorebrowseユーティリティがStoreFrontサーバーと通信できるように、HTTP Basic認証を有効にします。このオプションは、StoreFrontサーバーではデフォルトで無効になっています。HTTP Basic認証方法を有効にします。

Storebrowseユーティリティは、次のいずれかの方法で認証方法をサポートしています。

• Storebrowseユーティリティに組み込まれているAuthManagerを使用。注：Storebrowseユーティリティを使用する場合は、StoreFrontでHTTP Basic認証方法を有効にします。これは、ユーザーが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ファイルを生成します。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 Gatewayサーバーを介して、Citrix Virtual Apps and DesktopsおよびCitrix DaaS、およびスタートメニュー設定とともに渡されます。

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

前提条件:

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

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

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

注:

• 複数のサードパーティアプリケーションをセミコロンで区切って指定できます。