Storebrowse
Storebrowse ist ein Befehlszeilenprogramm, das zwischen Client und Server interagiert. Es wird verwendet, um alle Vorgänge innerhalb von StoreFront und mit Citrix Gateway zu authentifizieren.
-
Mithilfe des Storebrowse-Dienstprogramms können Administratoren die folgenden Vorgänge automatisieren:
- Einen Store hinzufügen.
- Die veröffentlichten Apps und Desktops aus einem konfigurierten Store 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 Storebrowse-Dienstprogramm ist Teil der Komponente Authmanager. Nach Abschluss der Installation der Citrix Workspace-App befindet sich das Storebrowse-Dienstprogramm im Installationsordner von AuthManager.
Um zu bestätigen, dass das Storebrowse-Dienstprogramm 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:
| Auf einem 32-Bit-Computer | [HKEY_CURRENT_USER\SOFTWARE\Citrix\AuthManager\Install] |
| Auf einem 64-Bit-Computer | [HKEY_CURRENT_USER\SOFTWARE\WOW6432Node\Citrix\AuthManager\Install] |
Anforderungen
- Citrix Workspace-App Version 1808 für Windows oder höher.
- Mindestens 530 MB freier Festplattenspeicher.
- 2 GB RAM.
Kompatibilitätsmatrix
Das Storebrowse-Dienstprogramm ist mit den folgenden Betriebssystemen kompatibel:
-
Betriebssystem -
Windows 10 32-Bit- und 64-Bit-Editionen Windows 8.1, 32-Bit- und 64-Bit-Editionen Windows 7 SP1, 32-Bit- und 64-Bit-Editionen Windows Thin PC Windows Server 2016 Windows Server 2012 R2, Standard- und Datacenter-Editionen -
Windows Server 2012, Standard- und Datacenter-Editionen -
Windows Server 2008 R2, 64-Bit-Edition -
Windows Server 2008 R2, 64-Bit-Edition -
Verbindungen
Das Storebrowse-Dienstprogramm unterstützt die folgenden Verbindungstypen:
- HTTP-Store
- HTTPS-Store
- Citrix Gateway 11.0 und höher
Hinweis:
Bei einem HTTP-Store akzeptiert das Storebrowse-Dienstprogramm keine Anmeldeinformationen über die Befehlszeile.
Authentifizierungsmethoden
StoreFront-Server
StoreFront unterstützt verschiedene Authentifizierungsmethoden für den Zugriff auf Stores, jedoch werden 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 für den Zugriff auf Stores authentifiziert zu werden. Standardmäßig ist die explizite Authentifizierung aktiviert, wenn Sie Ihren ersten Store erstellen.
- Domain Pass-through: Nach der Authentifizierung an den in die Domäne eingebundenen Windows-Computern werden Sie automatisch bei Stores angemeldet. Um diese Option zu verwenden, aktivieren Sie die Pass-Through-Authentifizierung bei der Installation der Citrix Workspace-App. Weitere Informationen zur Domain Pass-Through-Authentifizierung finden Sie unter Konfigurieren der Pass-Through-Authentifizierung.
- HTTP Basic: Aktivieren Sie die HTTP Basic-Authentifizierung, damit das Storebrowse-Dienstprogramm mit den StoreFront-Servern kommunizieren kann. Diese Option ist auf dem StoreFront-Server standardmäßig deaktiviert. Aktivieren Sie die Authentifizierungsmethode HTTP Basic.
Das Storebrowse-Dienstprogramm unterstützt Authentifizierungsmethoden auf eine der folgenden Arten:
- Verwendung des
AuthManager, der zusammen mit dem Storebrowse-Dienstprogramm integriert ist. Hinweis: Aktivieren Sie die HTTP Basic-Authentifizierungsmethode auf dem StoreFront, wenn Sie mit dem Storebrowse-Dienstprogramm arbeiten. Dies gilt, wenn der Benutzer die Anmeldeinformationen über die Storebrowse-Befehle bereitstellt. - Externer
Authmanager, der in der Citrix Workspace-App für Windows enthalten sein kann.
Single Sign-On mit Citrix Gateway
Zusätzlich zur neu hinzugefügten Citrix Gateway-Unterstützung können Sie jetzt Single Sign-On damit verwenden. Sie können einen Store hinzufügen und die veröffentlichten Ressourcen auflisten, ohne Ihre Benutzeranmeldeinformationen angeben zu müssen.
Weitere Informationen zur Single Sign-On-Unterstützung mit Citrix Gateway finden Sie unter Unterstützung für Single Sign-On mit Citrix Gateway.
Hinweis:
Diese Funktion wird nur auf in die Domäne eingebundenen Computern unterstützt, auf denen Citrix Gateway mit der Single Sign-On-Authentifizierung konfiguriert ist.
Veröffentlichten Desktop oder Anwendung starten
Sie können jetzt eine Ressource direkt aus dem Store starten, ohne eine ICA-Datei verwenden zu müssen.
Befehlsverwendung
Der folgende Abschnitt enthält detaillierte Informationen zu den Befehlen, die Sie mit dem Storebrowse-Dienstprogramm verwenden können.
-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 Multi-Store-Konfiguration wird vom Storebrowse-Dienstprogramm 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>
/?
Beschreibung:
Bietet Details zur Verwendung des Storebrowse-Dienstprogramms.
(-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
(-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>
-q, --quicklaunch
Beschreibung:
Generiert die ICA-Datei für veröffentlichte Apps und Desktops mithilfe des Storebrowse-Dienstprogramms. 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 lautet wie folgt:
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
-
Befehlsbeispiel auf 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 auf Citrix Gateway:
.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –q {Launch_URL_of_published_ apps and desktops} <https://my.secondexmaplestore.com>
-L, --launch
- Beschreibung:
Generiert die erforderliche ICA-Datei für veröffentlichte Apps und Desktops mithilfe des Storebrowse-Dienstprogramms. 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 der folgenden Ausgabe:
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
Befehlsbeispiel auf StoreFront:
.\storebrowse.exe -U {Username} –P {Password} –D {Domain} –L “{Resource_Name} <https://my.firstexamplestore.net/Citrix/Store/discovery>
Befehlsbeispiel auf Citrix Gateway:
<.\storebrowse.exe –U {Username} –P {Password} –D {Domain} –L {Resource_Name} https://my.secondexamplestore.com>
-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 der 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 der folgenden Ausgabe:
'Controller.Calculator' 'Calculator' '\' '' http://abc-sf.xyz.com/Citrix/Stress/resources/v2/Q29udHJvbGxlci5DYWxjdWxhdG9y/launch/ica
Der in der vorherigen Ausgabe fettgedruckte Name 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>
-f, --filefolder
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 Citrix Gateway:
.\storebrowse.exe –f “C:\Temp\Launch.ica” –L “Resource_Name” {NSG_URL}
-t, --traceauthentication
Beschreibung:
Generiert Protokolle für die AuthManager-Komponente. Protokolle werden nur generiert, wenn das Storebrowse-Dienstprogramm 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}
-d, --deletestore
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
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 der 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 über den Citrix Gateway-Server zusammen mit den Citrix Virtual Apps and Desktops und Citrix DaaS sowie den Startmenüeinstellungen weitergeleitet.
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 Gruppenrichtlinienobjekt-Vorlage (GPO) aktiviert werden.
- Öffnen Sie die administrative GPO-Vorlage der Citrix Workspace-App, indem Sie gpedit.msc ausführen.
- Navigieren Sie unter dem Knoten Computerkonfiguration zu Administrative Vorlagen > Citrix-Komponente > Citrix Workspace > Benutzerauthentifizierung > Single Sign-On für Citrix Gateway.
- Verwenden Sie die Umschaltoptionen, um die Single Sign-On-Option zu aktivieren oder zu deaktivieren.
- Klicken Sie auf Übernehmen und OK.
- Starten Sie die Citrix Workspace-App-Sitzung neu, damit die Änderungen wirksam werden.
Einschränkungen:
- Aktivieren Sie die Authentifizierungsmethode HTTP-Standardauthentifizierung auf dem StoreFront-Server für Anmeldeinformations-Injection-Vorgänge mit dem Storebrowse-Dienstprogramm.
- Wenn Sie einen HTTP-Store haben und versuchen, über das Dienstprogramm eine Verbindung zum Store herzustellen, um die veröffentlichten virtuellen Apps und Desktops zu überprüfen oder zu starten, wird die Anmeldeinformations-Injection über die Befehlszeilenoption nicht unterstützt. Als Problemumgehung verwenden Sie das externe
AuthManager-Modul, wenn Sie keine Anmeldeinformationen über die Befehlszeile bereitstellen. - Das Storebrowse-Dienstprogramm unterstützt derzeit nur einen einzelnen Store, der auf dem StoreFront-Server für Citrix Gateway konfiguriert ist.
- Die Anmeldeinformations-Injection im Storebrowse-Dienstprogramm funktioniert nur, wenn Citrix Gateway mit Ein-Faktor-Authentifizierung konfiguriert ist.
- Die Befehlszeilenoptionen
Username (-U),Password (-P) undDomain (-D)des Storebrowse-Dienstprogramms beachten die Groß-/Kleinschreibung und müssen ausschließlich 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.