Storebrowse

Hinweis:

Dieser Artikel gilt nur für lokale Bereitstellungen von Citrix Workspace. Informationen zu Cloud-Bereitstellungen finden Sie in der Dokumentation zu Storebrowse für Workspace.

• Storebrowse ist ein Befehlszeilendienstprogramm, das die Interaktion zwischen Client und Server ermöglicht. Es wird verwendet, um alle Vorgänge innerhalb von StoreFront und mit Citrix Gateway zu authentifizieren.

• Mithilfe des Dienstprogramms Storebrowse können Administratoren die folgenden Vorgänge automatisieren:

• Einen Store hinzufügen.
• Die veröffentlichten Apps und Desktops eines konfigurierten Stores auflisten.
• Eine ICA®-Datei durch manuelle Auswahl beliebiger veröffentlichter virtueller Apps und Desktops generieren.
• Eine ICA-Datei über die Storebrowse-Befehlszeile generieren.
• Die veröffentlichte Anwendung starten.

Das Dienstprogramm Storebrowse ist Teil der Komponente Authmanager. Nach Abschluss der Installation der Citrix Workspace-App befindet sich das Dienstprogramm Storebrowse im Installationsordner von AuthManager.

Um zu bestätigen, dass das Dienstprogramm Storebrowse zusammen mit der Komponente Authmanager installiert ist, überprüfen Sie den folgenden Registrierungspfad:

Wenn die Citrix Workspace-App von Administratoren installiert wird:

| | | | — |—|

• Auf einem 32-Bit-Computer

  [HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\AuthManager\Install]

• Auf einem 64-Bit-Computer

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

Wenn die Citrix Workspace-App von Benutzern (Nicht-Administratoren) installiert wird:

Anforderungen

• Citrix Workspace-App Version 1808 für Windows oder höher.
• Mindestens 530 MB freier Speicherplatz.

• 2 GB RAM.

• Kompatibilitätsmatrix

Das Dienstprogramm Storebrowse ist mit den folgenden Betriebssystemen kompatibel:

• Windows Server 2022

• Windows Server 2016

• Windows Server 2008 R2, 64-Bit-Edition

  Windows Server 2008 R2, 64-Bit-Edition

• Verbindungen

Das Dienstprogramm Storebrowse unterstützt die folgenden Verbindungstypen:

• HTTP-Store
• HTTPS-Store
• Citrix Gateway 11.0 und höher

Hinweis:

Bei einem HTTP-Store akzeptiert das Dienstprogramm Storebrowse keine Anmeldeinformationen über die Befehlszeile.

Authentifizierungsmethoden

StoreFront-Server

StoreFront unterstützt verschiedene Authentifizierungsmethoden für den Zugriff auf Stores, jedoch sind nicht alle empfohlen. Aus Sicherheitsgründen sind einige der Authentifizierungsmethoden standardmäßig deaktiviert, wenn ein Store erstellt wird.

• Benutzername und Kennwort: Geben Sie die Anmeldeinformationen ein, um den Zugriff auf Stores zu authentifizieren. Standardmäßig ist die explizite Authentifizierung aktiviert, wenn Sie Ihren ersten Store erstellen.
• Domänen-Pass-Through: Nach der Authentifizierung an den in die Domäne eingebundenen Windows-Computern werden Sie automatisch bei den Stores angemeldet. Um diese Option zu verwenden, aktivieren Sie die Pass-Through-Authentifizierung bei der Installation der Citrix Workspace-App. Weitere Informationen zur Domänen-Pass-Through-Authentifizierung finden Sie unter Konfigurieren der Pass-Through-Authentifizierung.
• HTTP Basic: Diese Methode wird von Drittanbieter-Clientintegrationen und Webportalen verwendet, bei denen eine externe Benutzeroberfläche zur Erfassung eines domänenqualifizierten Benutzernamens und Kennworts verwendet wurde. StoreFront verwendet die Basic Authentication-Funktion in IIS, um die Anmeldeinformationen an den StoreFront-Server zu übertragen. StoreFront verwendet dann entweder die Domain Services oder die Broker XML Service-Authentifizierung, um die Anmeldeinformationen zu validieren und die Gruppeninformationen abzurufen. Informationen zum Aktivieren der HTTP Basic-Authentifizierung finden Sie unter HTTP Basic in der Dokumentation Authentifizierungsmethoden verwalten.

Das Dienstprogramm Storebrowse unterstützt Authentifizierungsmethoden in einer der folgenden Weisen:

• Verwendung des AuthManager, der im Dienstprogramm Storebrowse integriert ist. Hinweis: Aktivieren Sie die HTTP Basic-Authentifizierungsmethode auf dem StoreFront, wenn Sie mit dem Dienstprogramm Storebrowse arbeiten. Diese Methode gilt, wenn der Benutzer die Anmeldeinformationen über die Storebrowse-Befehle bereitstellt.
• Verwenden Sie den Authmanager, der in der Citrix Workspace-App für Windows enthalten ist. Sie können diese Methode verwenden, wenn Sie die Domänen-Pass-Through-Authentifizierung verwenden. Weitere Informationen finden Sie in der Dokumentation zur Domänen-Pass-Through-Authentifizierung.

Veröffentlichten Desktop oder Anwendung starten

Sie können eine Ressource jetzt direkt aus dem Store starten, ohne eine ICA-Datei verwenden zu müssen.

Hinweis:

Sie können SaaS-Apps oder veröffentlichte Inhalte nicht mit Storebrowse-Befehlen öffnen.

Befehlsverwendung

Der folgende Abschnitt enthält detaillierte Informationen zu den Befehlen, die Sie mit dem Dienstprogramm Storebrowse verwenden können.

Einen Store hinzufügen

-a, --addstore

Beschreibung:

Fügt einen neuen Store hinzu. Gibt die vollständige URL des Stores zurück. Wenn die Rückgabe fehlschlägt, wird ein Fehler gemeldet.

Hinweis:

Die Konfiguration mehrerer Stores wird vom Dienstprogramm Storebrowse unterstützt.

Befehlsbeispiel für StoreFront:

Befehl:

storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of StoreFront*

Beispiel:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a [https://my.firstexamplestore.net](https://my.firstexamplestore.net)

Befehlsbeispiel für Citrix Gateway:

Befehl:

storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*

Beispiel:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a <https://mysecondexample.com>

Das Obige funktioniert, wenn der mit dem Gateway konfigurierte StoreFront einen einzelnen Store hat.

Wenn der mit dem Gateway konfigurierte StoreFront mehrere Stores hat, muss der folgende Befehl verwendet werden:

Befehl: storebrowse.exe –U *username* -P *password* -D *domain* -a *URL of CitrixGateway*?StoreName

• Beispiel: .\storebrowse.exe –U {Username} –P {Password} –D {Domain} –a https://mysecondexample.com?Store

• Hilfe

• /?

Beschreibung:

Enthält Details zur Verwendung des Dienstprogramms Storebrowse.

Store auflisten

(-l), --liststore

Beschreibung:

Listet die vom Benutzer hinzugefügten Stores auf.

Befehlsbeispiel für StoreFront:

.\storebrowse.exe –l

Befehlsbeispiel für Citrix Gateway:

.\storebrowse.exe –l

Auflisten

(-M 0x2000 -E)

Beschreibung:

Listet Ressourcen auf.

Befehlsbeispiel für StoreFront:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.firstexamplestore.net/Citrix/Store/discovery>

Befehlsbeispiel für Citrix Gateway:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –M 0x2000 –E <https://my.secondexample.net>

Schnellstart

-q, --quicklaunch

Beschreibung:

Generiert die ICA-Datei für veröffentlichte Apps und Desktops mithilfe des Dienstprogramms Storebrowse. Die Option quicklaunch erfordert eine Start-URL als Eingabe zusammen mit der Store-URL. Die Start-URL kann entweder der StoreFront-Server oder die Citrix Gateway-URL sein. Die ICA-Datei wird im Verzeichnis %LocalAppData%\Citrix\Storebrowse\cache generiert.

Sie können die Start-URL für alle veröffentlichten Apps und Desktops abrufen, indem Sie den folgenden Befehl ausführen:

.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery

Eine typische Start-URL sieht wie folgt aus:

'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica

Befehlsbeispiel für 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>

Befehlsbeispiel für Citrix Gateway:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –q {Launch_URL_of_published_ apps and desktops} <https://my.secondexmaplestore.com>

Starten

• -L, --launch

• Beschreibung:

• Generiert die erforderliche ICA-Datei für veröffentlichte Apps und Desktops mithilfe des Dienstprogramms Storebrowse. Die Startoption erfordert den Namen der Ressource zusammen mit der Store-URL. Der Name kann entweder der StoreFront-Server oder die Citrix Gateway-URL sein. Die ICA-Datei wird im Verzeichnis %LocalAppData%\Citrix\Storebrowse\cache generiert.

• Führen Sie den folgenden Befehl aus, um den Anzeigenamen der veröffentlichten Apps und Desktops abzurufen:

• .\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery

• Dieser Befehl führt zu folgender Ausgabe:

• 'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica

Befehlsbeispiel für StoreFront:

.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –L “{Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery>

Befehlsbeispiel für Citrix Gateway:

<.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –L {Resource_Name} https://my.secondexamplestore.com>

Sitzungsstart

-S, --sessionlaunch

Beschreibung:

Mit diesem Befehl können Sie einen Store hinzufügen, die veröffentlichten Ressourcen überprüfen und starten. Diese Option akzeptiert die folgenden Parameter:

• Benutzername
• Kennwort
• Domäne
• Name der zu startenden Ressource
• Store-URL

Wenn der Benutzer jedoch keine Anmeldeinformationen angibt, fordert der AuthManager zur Eingabe der Anmeldeinformationen auf, und die Ressource wird dann gestartet.

Sie können den Namen der Ressource von veröffentlichten Apps und Desktops abrufen, indem Sie den folgenden Befehl ausführen:

.\storebrowse –M 0X2000 –E https://myfirstexamplestore.net/Citrix/Second/discovery

Dieser Befehl führt zu folgender Ausgabe:

'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica

Der Name, der in der vorherigen Ausgabe fett gedruckt ist, wird als Eingabeparameter für die Option -S verwendet.

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –S “{Friendly_Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery >

Befehlsbeispiel auf Citrix Gateway:

.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –S {Friendly_Resource_Name} <https://my.secondexamplestore.com>

Dateipfad

-f, --dateipfad

Beschreibung:

Generiert die ICA-Datei im benutzerdefinierten Pfad für die veröffentlichten Apps und Desktops.

Die Startoption erfordert einen Ordnernamen und den Namen der Ressource als Eingabe zusammen mit der Store-URL. Die Store-URL kann entweder der StoreFront-Server oder die Citrix Gateway-URL sein.

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {Store}

Befehlsbeispiel auf dem Citrix Gateway:

.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {NSG_URL}

Authentifizierungsverfolgung

-t, --authentifizierungsverfolgung

Beschreibung:

Generiert Protokolle für die Komponente AuthManager. Protokolle werden nur generiert, wenn das Dienstprogramm Storebrowse einen integrierten AuthManager verwendet. Protokolle werden im Verzeichnis localappdata%\Citrix\Storebrowse\logs generiert.

Hinweis:

Diese Option darf nicht der letzte Parameter in der Befehlszeile des Benutzers sein.

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {StoreURL}

Befehlsbeispiel auf Citrix Gateway:

.\storebrowse.exe –t –U {UserName} –P {Password} –D {Domain} –a {NSG_URL}

Einen Store löschen

-d, --storelöschen

Beschreibung:

Löscht einen vorhandenen StoreFront- oder Citrix Gateway-Store.

Befehlsbeispiel auf StoreFront:

.\storebrowse.exe –d https://my.firstexamplestore.net/Citrix/Store/discovery

Befehlsbeispiel auf Citrix Gateway:

.\storebrowse.exe –d https://my.secondexmaplestore.com

Storebrowse-Befehlsstatus verfolgen

Ab Version 2305.1 können Sie den Ausführungsstatus eines Storebrowse-Befehls in einer Datei verfolgen. Um den Erfolgsstatus zu verfolgen, geben Sie einen eindeutigen Dateinamen mit dem Befehl -f launch an. Dieser Befehl generiert eine Datei mit dem von Ihnen angegebenen Namen. Der Fehlerstatus ist in der Datei ica.error enthalten, die automatisch erstellt wird.

Hinweis:

Stellen Sie sicher, dass Sie dem Dateinamen mit dem Befehl -f launch die Erweiterung .ica hinzufügen. Andernfalls wird die Datei nicht generiert.

Die Dateien zur Verfolgung von Erfolg und Misserfolg befinden sich unter %LOCALAPPDATA%\citrix\selfservice\cache und können bei Bedarf überwacht werden.

Diese Verbesserung ist standardmäßig aktiviert.

Im Folgenden finden Sie ein Beispiel für die Verwendung des Startbefehls mit der Option -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-->

Single Sign-On-Unterstützung mit Citrix Gateway

Single Sign-On ermöglicht Ihnen die Authentifizierung an einer Domäne und die Nutzung der von dieser Domäne bereitgestellten Citrix Virtual Apps and Desktops™ und Citrix DaaS (ehemals Citrix Virtual Apps and Desktops Service). Sie können sich anmelden, ohne sich bei jeder App oder jedem Desktop erneut authentifizieren zu müssen. Wenn Sie einen Store hinzufügen, werden Ihre Anmeldeinformationen zusammen mit den Einstellungen für Citrix Virtual Apps and Desktops, Citrix DaaS und das Startmenü über den Citrix Gateway-Server geleitet.

Diese Funktion wird ab Citrix Gateway Version 11 unterstützt.

Voraussetzungen:

Informationen zu den Voraussetzungen für die Konfiguration von Single Sign-On für Citrix Gateway finden Sie unter Domänen-Pass-Through-Authentifizierung konfigurieren.

Die Single Sign-On-Funktion mit Citrix Gateway kann mithilfe der administrativen Vorlage für Gruppenrichtlinienobjekte (GPO) aktiviert werden.

1. Öffnen Sie die administrative Vorlage für Gruppenrichtlinienobjekte (GPO) der Citrix Workspace-App, indem Sie gpedit.msc ausführen.
2. Navigieren Sie unter dem Knoten Computerkonfiguration zu Administrative Vorlagen > Citrix Komponenten > Citrix Workspace > Benutzerauthentifizierung > Single Sign-On für Citrix Gateway.
3. Verwenden Sie die Umschaltoptionen, um die Single Sign-On-Option zu aktivieren oder zu deaktivieren.
4. Klicken Sie auf Übernehmen und OK.
5. Starten Sie die Citrix Workspace-App-Sitzung neu, damit die Änderungen wirksam werden.

Einschränkungen:

• Aktivieren Sie die Methode HTTP Basic Authentication auf dem StoreFront-Server für Anmeldeinformationsinjektionsvorgänge mit dem Dienstprogramm Storebrowse.
• Wenn Sie einen HTTP-Store haben und versuchen, sich mit dem Dienstprogramm mit dem Store zu verbinden, um die veröffentlichten virtuellen Apps und Desktops zu überprüfen oder zu starten, wird die Anmeldeinformationsinjektion über die Befehlszeilenoption nicht unterstützt. Als Workaround verwenden Sie das externe AuthManager-Modul, wenn Sie keine Anmeldeinformationen über die Befehlszeile bereitstellen.
• Das Dienstprogramm Storebrowse unterstützt derzeit nur einen einzelnen Store, der das Citrix Gateway auf dem StoreFront-Server konfiguriert hat.
• Die Anmeldeinformationsinjektion im Dienstprogramm Storebrowse funktioniert nur, wenn das Citrix Gateway mit Ein-Faktor-Authentifizierung konfiguriert ist.
• Die Befehlszeilenoptionen Username (-U), Password (-P) und Domain (-D) des Dienstprogramms Storebrowse sind Groß-/Kleinschreibung-sensitiv und müssen nur in Großbuchstaben angegeben werden.

Um SSON für Drittanbieteranwendungen zu aktivieren, die ICOSDK verwenden, erstellen Sie die folgende Registrierung:

• Registrierungsschlüssel: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson
• Registrierungswert: vollständiger Pfad der Drittanbieteranwendungen
• Registrierungstyp: reg_multi_sz

Beispiel:

• Registrierungsschlüssel: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\NonIEAppsWithSson
• Registrierungswert: C:\temp1\abc.exe;C:\temp2\xyz.exe
• Registrierungstyp: reg_multi_sz

Hinweis:

• Sie können mehrere Drittanbieteranwendungen durch Semikolon getrennt angeben.
• Diese Funktion wird ab Version 2107 unterstützt.