Verwenden von URIs zur Konfiguration von HTML Access-Webclients

Sie können URIs (Uniform Resource Identifier) verwenden, um Web- oder E-Mail-Links für Endbenutzer zu erstellen. Endbenutzer können auf diese Links klicken, um HTML Access zu starten, eine Verbindung zu einem Server herzustellen und einen Remote-Desktop oder eine veröffentlichte Anwendung mit bestimmten Konfigurationsoptionen zu starten.

Diese Links werden durch die Generierung von URIs erstellt, die einige oder alle der folgenden Informationen bereitstellen, sodass die Endbenutzer diese nicht angeben müssen.

• Serveradresse
• Portnummer für den Server
• Active Directory-Benutzername
• RADIUS- oder RSA SecurID-Benutzername, wenn dieser nicht mit dem Active Directory-Benutzernamen identisch ist
• Domänenname
• Anzeigename des Remote-Desktops oder der veröffentlichten Anwendung
• Aktionen, darunter „Durchsuchen“, „Zurücksetzen“, „Abmelden“ und „Sitzung starten“

URI-Spezifikation

Die erforderliche Syntax umfasst eine Pfadkomponente zur Angabe des Servers sowie optional eine Abfrage zur Angabe eines Benutzers, des Remote-Desktops oder der veröffentlichten Anwendung sowie Aktionen oder Konfigurationsoptionen.

Um URIs für den Start von HTML Access zu erstellen, verwenden Sie die folgende Syntax:

https://authority-part[/?query-part]

authority-part

Gibt die Serveradresse und optional eine nicht standardmäßige Portnummer an. Die Servernamen müssen der DNS-Syntax entsprechen.

Verwenden Sie zur Angabe einer Portnummer die folgende Syntax:

server-address:port-number

query-part

Gibt die zu verwendenden Konfigurationsoptionen oder die durchzuführenden Aktionen an. Für die Abfragen muss die Groß- und Kleinschreibung nicht beachtet werden. Verwenden Sie für den Einsatz mehrerer Abfragen das kaufmännische Und-Zeichen (&) zwischen den Abfragen. Sollten die Abfragen miteinander in Konflikt stehen, wird die letzte Abfrage in der Liste verwendet. Verwenden Sie die folgende Syntax:

query1=value1[&query2=value2...]

Beachten Sie beim Erstellen des Abfrageteils die folgenden Richtlinien:

• Wenn Sie nicht mindestens eine der unterstützten Abfragen verwenden, wird die standardmäßige VMware Horizon-Webportalseite angezeigt.
• Für die Abfragekomponente werden einige Sonderzeichen nicht unterstützt; es muss deshalb für diese das URL-Codierungsformat wie folgt angewendet werden: Für das Hashzeichen (#, Doppelkreuz) verwenden Sie %23, für das Prozentzeichen (%) %25, für das Kaufmännische Und (&) den Platzhalter %26, für das At-Zeichen (@) %40 und für den Rückschrägstrich (\) verwenden Sie %5C.

  Weitere Informationen zur URL-Codierung finden Sie unter http://www.w3schools.com/tags/ref_urlencode.asp.

• Für die Abfragekomponente müssen Nicht-ASCII-Zeichen zunächst gemäß UTF-8 [STD63] codiert werden, anschließend muss für jedes Oktett der entsprechenden UTF-8-Sequenz eine Prozentcodierung durchgeführt werden, um diese als URI-Zeichen darzustellen.

  Informationen zur Codierung von ASCII-Zeichen finden Sie in der URL-Codierungsreferenz unter http://www.utf8-chartable.de/.

Unterstützte Abfragen

In diesem Abschnitt werden die Abfragen aufgeführt, die für HTML Access unterstützt werden. Wenn Sie URIs für mehrere Clienttypen generieren, wie z. B. für Desktop-Clients oder mobile Clients, finden Sie weitere Informationen im Handbuch für alle Clientsystemtypen.

action

Tabelle 1. Werte, die mit der Abfrage „action“ verwendet werden können

Wert	Beschreibung
browse	Zeigt eine Liste der verfügbaren Remote-Desktops und veröffentlichten Anwendungen an, die auf dem angegebenen Server gehostet werden. Bei Verwendung dieser Aktion müssen Sie keinen Remote-Desktop bzw. keine veröffentlichte Anwendung angeben.
start-session	Startet den angegebenen Remote-Desktop oder die angegebene veröffentlichte Anwendung. Wenn keine „action“-Abfrage bereitgestellt wird und der Name des Remote-Desktops oder der veröffentlichten Anwendung angegeben wird, ist start-session die Standardaktion.
reset	Fährt den angegebenen Remote-Desktop herunter und startet ihn neu. Nicht gespeicherte Daten gehen verloren. Das Zurücksetzen eines Remote-Desktops entspricht dem Betätigen der Reset-Taste auf einem physischen PC. Diese Aktion ist für eine veröffentlichte Anwendung ungültig.
logoff	Meldet den Benutzer vom Gastbetriebssystem auf dem Remote-Desktop ab. Diese Aktion ist für eine veröffentlichte Anwendung ungültig.
restart	Fährt den primären Remote-Desktop herunter und startet diesen neu, wenn der Benutzer die Anforderung für den Neustart bestätigt. Diese Aktion ist für eine veröffentlichte Anwendung ungültig.

applicationId

Der Anzeigename der veröffentlichten Anwendung. Dieser Anzeigename ist der Name, der in Horizon Console beim Erstellen des Anwendungspools angegeben wurde. Weist der Anzeigename ein Leerzeichen auf, verwendet der Browser %20 zur Darstellung des Leerzeichens.

args

Gibt Befehlszeilenargumente zum Hinzufügen an, wenn eine veröffentlichte Anwendung gestartet wird. Verwenden Sie die Syntax args= Wert, wobei Wert eine Zeichenfolge sein muss. Verwenden Sie für die folgenden Zeichen die Prozentkodierung:

• Für einen Doppelpunkt (:) verwenden Sie %3A.
• Für einen umgekehrten Schrägstrich (\) verwenden Sie %5C.
• Für ein Leerzeichen ( ) verwenden Sie %20.
• Für ein doppeltes Anführungszeichen (") verwenden Sie %22

Um beispielsweise den Dateinamen "My new file.txt" für die Notepad++-Anwendung anzugeben, verwenden Sie %22My%20new%20file.txt%22.

desktopId

Der Anzeigename des Remote-Desktops. Der Anzeigename ist der Name, der in Horizon Console beim Erstellen des Desktop-Pools angegeben wurde. Weist der Anzeigename ein Leerzeichen auf, verwendet der Browser %20 zur Darstellung des Leerzeichens.

domainName

Der NETBIOS-Domänenname, der mit dem Benutzer verknüpft ist, der eine Verbindung zum Remote-Desktop bzw. zur veröffentlichten Anwendung herstellt. Beispielsweise ist es sinnvoller, MeineFirma als MeineFirma.com zu verwenden.

tokenUserName

Der RSA- oder RADIUS-Benutzername. Verwenden Sie diese Abfrage nur, wenn der RSA- oder RADIUS-Benutzername nicht mit dem Active Directory-Benutzernamen identisch ist. Wenn Sie diese Abfrage nicht angeben und die RSA- oder RADIUS-Authentifizierung erforderlich ist, wird der Windows-Benutzername verwendet.

userName

Der Active Directory-Benutzer, der eine Verbindung zum Remote-Desktop oder zur veröffentlichten Anwendung herstellt. Für den Benutzernamen sind folgende Formate zulässig:

• Benutzername
• Domänenname%5CBenutzername
• Benutzerprinzipalname (User Principal Name, UPN) in der Form Benutzername@Domänenname

unauthenticatedAccessEnabled

Wenn für diese Option True festgelegt ist, ist die Funktion für den nicht authentifizierten Zugriff standardmäßig aktiviert. HTML Access wird gestartet, und ein Benutzerkonto für anonyme Benutzer wird angezeigt. Ein Beispiel für die Syntax ist etwa unauthenticatedAccessEnabled=true.

unauthenticatedAccessAccount

Damit wird das Konto festgelegt, das verwendet werden soll, wenn die Funktion für den nicht authentifizierten Zugriff aktiviert ist. Wenn der nicht authentifizierte Zugriff deaktiviert ist, wird diese Abfrage ignoriert. Die entsprechende Syntax lautet beispielsweise bei Verwendung des Benutzerkontos anonymous1 dann unauthenticatedAccessAccount=anonymous1.

webviewMode

Wenn diese Option auf true festgelegt ist, wird die Remotesitzung im Webview-Modus gestartet. Im Webview-Modus ist die Sidebar HTML Access ausgeblendet. Im Webview-Modus sind in bestimmten mobilen Apps von Drittanbietern folgende Funktionen verfügbar:

• Senden von Ereignissen von der Bildschirmtastatur an den Remote-Desktop
• Verwenden der Benutzeroberfläche der mobilen Anwendung, um in HTML Access zwischen dem nativen Touch-Modus und dem Trackpad-Touch-Modus zu wechseln.

URI-Syntaxbeispiele

Nach jedem der folgenden URI-Beispiel finden Sie eine Beschreibung, was der Endbenutzer nach Anklicken des URI-Links sieht. Bei Abfragen wird nicht zwischen Groß-/Kleinschreibung unterschieden. Sie können z. B. sowohl domainName als auch domainname verwenden.

1. https://horizon.mycompany.com/?domainName=finance&userName=fred

   HTML Access startet und stellt eine Verbindung zum horizon.mycompany.com-Server her. Im Anmeldefeld wird das Textfeld Benutzername mit dem Namen fred und das Textfeld Domäne mit finance gefüllt. Der Benutzer muss das Kennwort eingeben.

2. https://horizon.mycompany.com/?userName=finance%5Cfred

   HTML Access startet und stellt eine Verbindung zum horizon.mycompany.com-Server her. Im Anmeldefeld ist im Textfeld Benutzername der Name finance\fred enthalten. Der Benutzer muss das Kennwort eingeben.

3. https://horizon.mycompany.com/?userName=fred@finance

   HTML Access startet und stellt eine Verbindung zum horizon.mycompany.com-Server her. Im Anmeldefeld ist im Textfeld Benutzername der Name fred@finance enthalten. Der Benutzer muss das Kennwort eingeben.

4. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=start-session

   HTML Access startet und stellt eine Verbindung zum horizon.mycompany.com-Server her. Das Anmeldefeld fordert den Benutzer zur Eingabe von Benutzernamen, Domänennamen und Kennwort auf. Nach einer erfolgreichen Anmeldung stellt der Client eine Verbindung zum Remote-Desktop her, dessen Anzeigename Primary Desktop lautet. Der Benutzer wird dann beim Gastbetriebssystem angemeldet.

5. https://horizon.mycompany.com/?applicationId=Notepad&action=start-session

   HTML Access startet und stellt eine Verbindung zum horizon.mycompany.com-Server her. Das Anmeldefeld fordert den Benutzer zur Eingabe von Benutzernamen, Domänennamen und Kennwort auf. Nach der erfolgreichen Anmeldung wird die Notepad-Anwendung gestartet.

6. https://horizon.mycompany.com:7555/?desktopId=Primary%20Desktop

   Dieser URI hat die gleiche Wirkung wie im vorherigen Beispiel, außer dass er für den Server den nicht standardmäßigen Port 7555 verwendet. Der Standardport lautet 443. Da ein Remote-Desktop-Bezeichner bereitgestellt wird, wird der Remote-Desktop gestartet, obwohl die Aktion start-session nicht im URI enthalten ist.

7. https://horizon.mycompany.com/?applicationId=Primary%20Application&desktopId=Primary%20Desktop

   Dieser URI gibt sowohl eine veröffentlichte Anwendung als auch einen Remote-Desktop an. Wenn Sie sowohl eine veröffentlichte Anwendung als auch einen Remote-Desktop angeben, wird nur der Remote-Desktop gestartet.

8. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=reset

   HTML Access startet und stellt eine Verbindung zum horizon.mycompany.com-Server her. Das Anmeldefeld fordert den Benutzer zur Eingabe von Benutzernamen, Domänennamen und Kennwort auf. Nach einer erfolgreichen Anmeldung zeigt der Client ein Dialogfeld an, in dem der Benutzer aufgefordert wird, das Zurücksetzen für „Primary Desktop“ zu bestätigen.

   Hinweis: Diese Aktion ist nur verfügbar, wenn ein Administrator den Endbenutzern das Zurücksetzen ihrer Maschinen erlaubt hat.

9. https://horizon.mycompany.com/?My%20Notepad++?args=%22My%20new%20file.txt%22

   Öffnet My Notepad++ auf dem Server horizon.mycompany.com und übergibt das Argument my_new_file.txt an den Befehl zum Starten der Anwendung. Der Dateiname ist in doppelte Anführungszeichen gesetzt, da er Leerzeichen enthält.

10. https://horizon.mycompany.com/?Notepad++%2012?args=a.txt%20b.txt

    Öffnet Notepad++ 12 auf dem Server horizon.mycompany.com und übergibt das Argument a.text b.txt an den Befehl zum Starten der Anwendung. Da dieses Argument nicht in doppelte Anführungszeichen gesetzt ist, trennt ein Leerzeichen die Dateinamen und die beiden Dateien werden gesondert in Notepad++ geöffnet.

    Hinweis: Anwendungen können sich in der Umsetzung von Befehlszeilenargumenten unterscheiden. Wenn Sie beispielsweise das Argument a.txt b.txt an WordPad übergeben, öffnet WordPad nur eine Datei, a.txt.

11. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=restart

    HTML Access startet und stellt eine Verbindung zum horizon.mycompany.com-Server her. Das Anmeldefeld fordert den Benutzer zur Eingabe von Benutzernamen, Domänennamen und Kennwort auf. Nach einer erfolgreichen Anmeldung zeigt der Client ein Dialogfeld an, in dem der Benutzer aufgefordert wird, den Neustart für „Primary Desktop“ zu bestätigen.

    Hinweis: Diese Aktion ist nur verfügbar, wenn ein Administrator den Endbenutzern den Neustart ihrer Maschinen erlaubt hat.

12. https://horizon.mycompany.com/?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous_user1

    HTML Access wird gestartet und stellt eine Verbindung mit dem Server horizon.mycompany.com mithilfe des Kontos anonymous_user1 her.

Beispiel für HTML-Code

Sie können URIs verwenden, um Hypertext-Links und Schaltflächen zu erstellen, die in E-Mails oder auf Webseiten eingebunden werden können. Die folgenden Beispiele veranschaulichen, wie Sie den URI aus dem ersten Beispiel verwenden, um einen Hypertext-Link mit dem Text Test Link und eine Schaltfläche mit dem Text TestButton zu codieren.

<html>
<body>

<a href="https://horizon.mycompany.com/?domainName=finance&userName=fred">Test Link</a><br>

<form><input type="button" value="TestButton" onClick="window.location.href=
'https://horizon.mycompany.com/?domainName=finance&userName=fred'"></form> <br>

</body>
</html>