Vous pouvez utiliser des URI (Uniform Resource Identifiers) pour créer des liens Web ou d'e-mails pour les utilisateurs finaux. Les utilisateurs finaux peuvent cliquer sur ces liens pour démarrer HTML Access, se connecter à un serveur et démarrer un poste de travail distant ou une application publiée avec des options de configuration spécifiques.

Vous pouvez créer ces liens en construisant des URI qui fournissent une partie ou l'intégralité des informations suivantes, afin que les utilisateurs finaux n'aient pas à les fournir.

  • Adresse du serveur
  • Numéro de port du serveur
  • Nom d'utilisateur Active Directory
  • Nom d'utilisateur RADIUS ou RSA SecurID, s'il est différent du nom d'utilisateur Active Directory
  • Nom de domaine
  • Nom d'affichage du poste de travail distant ou de l'application publiée
  • Actions incluant la navigation, la réinitialisation, la fermeture et le démarrage d'une session

Spécification d'URI

La syntaxe requise inclut une partie de chemin d'accès visant à spécifier le serveur et, éventuellement, une requête pour spécifier un utilisateur, un poste de travail distant ou une application publiée et des actions ou options de configuration.

Pour créer des URI pour le démarrage de HTML Access, utilisez la syntaxe suivante : 

https://authority-part[/?query-part]
authority-part
Spécifie l'adresse du serveur et, en option, un numéro de port non défini par défaut. Les noms de serveur doivent être conformes à la syntaxe DNS.

Pour spécifier un numéro de port, utilisez la syntaxe suivante : 

server-address:port-number
query-part
Spécifie les options de configuration à utiliser ou les actions à effectuer. Les requêtes ne sont pas sensibles à la casse. Pour utiliser plusieurs requêtes, utilisez une esperluette (&) entre les requêtes. En cas de conflit entre des requêtes, la dernière requête de la liste est utilisée. Utilisez la syntaxe suivante : 
query1=value1[&query2=value2...]

Respectez les instructions suivantes lors de la création d'une partie de requête :

  • Si vous n'utilisez pas au moins l'une des requêtes prises en charge, la page par défaut du portail Web de VMware Horizon s'affiche.
  • Dans la partie de requête, certains caractères spéciaux ne sont pas pris en charge, et vous devez les entrer au format de codage d'URL suivant : pour le symbole dièse (#) utilisez %23, pour le signe de pourcentage (%) utilisez %25, pour l'esperluette (&) utilisez %26, pour l'arobase (@) utilisez %40 et pour la barre oblique inverse (\) utilisez %5C.

    Pour en savoir plus sur le codage d'URL, consultez http://www.w3schools.com/tags/ref_urlencode.asp.

  • Dans la partie de requête, les caractères non ASCII doivent d'abord être encodés en UTF-8 [STD63], puis chaque octet de la séquence UTF-8 correspondante doit être codé en pourcentage pour être représenté en tant que caractères URI.

    Pour plus d'informations sur l'encodage de caractères ASCII, consultez la référence d'encodage d'URL sur http://www.utf8-chartable.de/.

Requêtes prises en charge

Cette rubrique répertorie les requêtes prises en charge pour HTML Access. Si vous créez des URI pour plusieurs types de clients, tels que des clients de postes de travail et des clients mobiles, reportez-vous au document du guide pour chaque type de système client.

action
Tableau 1. Valeurs pouvant être utilisées avec la requête d'action
Valeur Description
browse Affiche la liste des postes de travail distants et applications publiées disponibles hébergés sur le serveur spécifié. Vous ne devez pas spécifier un poste de travail distant ou une application publiée lors de l'utilisation de cette action.
start-session Démarre l'application publiée ou le poste de travail distant spécifié. Si aucune requête d'action n'est fournie et que le nom du poste de travail distant ou de l'application publiée est fourni, start-session est l'action par défaut.
reset Éteint puis redémarre le poste de travail distant spécifié. Les données non enregistrées sont perdues. La réinitialisation d'un poste de travail distant équivaut à appuyer sur le bouton Réinitialiser d'un ordinateur physique. Cette action n'est pas valide pour une application publiée.
logoff Déconnecte l'utilisateur du système d'exploitation invité sur le poste de travail distant. Cette action n'est pas valide pour une application publiée.
restart Arrête et redémarre le poste de travail distant principal lorsque l'utilisateur confirme la demande d'opération de redémarrage. Cette action n'est pas valide pour une application publiée.
applicationId
Nom d'affichage de l'application publiée. Le nom complet est celui spécifié dans Horizon Console lors de la création du pool d'applications. Si le nom d'affichage contient un espace, le navigateur utilise %20 pour représenter l'espace.
args
Spécifie les arguments de ligne de commande à ajouter lors du démarrage d'une application publiée. Utilisez la syntaxe args= value, où value est une chaîne. Utilisez l'encodage avec pourcentage pour les caractères suivants :
  • Pour un deux-points (:), utilisez %3A
  • Pour une barre oblique inversée (\), utilisez %5C
  • Pour un espace ( ), utilisez %20
  • Pour un guillemet double ("), utilisez %22

Par exemple, pour spécifier le nom de fichier "My new file.txt" pour l'application Notepad++, utilisez %22My%20new%20file.txt%22.

desktopId
Nom d'affichage du poste de travail distant. Le nom d'affichage est celui qui est spécifié dans Horizon Console lors de la création du pool de postes de travail. Si le nom d'affichage contient un espace, le navigateur utilise %20 pour représenter l'espace.
domainName
Nom de domaine NETBIOS associé à l'utilisateur qui se connecte au poste de travail distant ou à l'application publiée. Utilisez par exemple monentreprise plutôt que monentreprise.com.
tokenUserName
Nom d'utilisateur RSA ou RADIUS. N'utilisez cette requête que si le nom d'utilisateur RSA ou RADIUS est différent du nom d'utilisateur Active Directory. Si vous ne spécifiez pas cette requête et que l'authentification RSA ou RADIUS est nécessaire, le nom d'utilisateur Windows est utilisé.
userName
Utilisateur Active Directory qui se connecte au poste de travail distant ou à l'application publiée. Le nom d'utilisateur peut utiliser l'un des formats suivants :
  • userName
  • domainName%5CuserName
  • nom d'utilisateur principal (UPN), c'est-à-dire userName@domainName
unauthenticatedAccessEnabled
Lorsque cette option est définie sur true, la fonctionnalité Accès non authentifié est activée par défaut. HTML Access démarre, et un compte d'utilisateur anonyme s'affiche. Exemple de syntaxe : unauthenticatedAccessEnabled=true.
unauthenticatedAccessAccount
Définit le compte à utiliser si la fonctionnalité Accès non authentifié est activée. Si la fonctionnalité Accès non authentifié est désactivée, cette requête est ignorée. Exemple de syntaxe utilisant le compte d'utilisateur anonymous1 : unauthenticatedAccessAccount=anonymous1
webviewMode
Lorsque cette option est définie sur true, la session distante démarre en mode d'affichage Web. La barre latérale d' HTML Access est masquée en mode d'affichage Web. Ce mode permet également à certaines applications mobiles tierces d'effectuer les opérations suivantes :
  • Envoyer des événements du clavier logiciel au poste de travail distant
  • Utiliser l'interface de l'application mobile pour basculer entre le mode tactile natif et le mode tactile du pavé tactile dans HTML Access

Exemples de syntaxe URI

Chacun des exemples d'URI suivants est suivi d'une description de ce que l'utilisateur final voit après avoir cliqué sur le lien URI. Les requêtes ne sont pas sensibles à la casse, par exemple, vous pouvez utiliser domainName ou domainname. 

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

    HTML Access démarre et se connecte au serveur horizon.mycompany.com. Dans la boîte de dialogue de connexion, la zone de texte Nom d'utilisateur contient le nom fred et la zone de texte Domaine contient finance. L'utilisateur doit fournir uniquement un mot de passe. 

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

    HTML Access démarre et se connecte au serveur horizon.mycompany.com. Dans la boîte de dialogue de connexion, la zone de texte Nom d'utilisateur contient le nom finance\fred. L'utilisateur doit fournir uniquement un mot de passe. 

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

    HTML Access démarre et se connecte au serveur horizon.mycompany.com. Dans la boîte de dialogue de connexion, la zone de texte Nom d'utilisateur contient le nom fred@finance. L'utilisateur doit fournir uniquement un mot de passe. 

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

    HTML Access démarre et se connecte au serveur horizon.mycompany.com. La boîte de dialogue de connexion invite l'utilisateur à fournir un nom d'utilisateur, un nom de domaine et un mot de passe. Après l'ouverture de session, le client se connecte au poste de travail distant dont le nom d'affichage est Poste de travail principal et l'utilisateur est connecté au système d'exploitation client. 

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

    HTML Access démarre et se connecte au serveur horizon.mycompany.com. La boîte de dialogue de connexion invite l'utilisateur à fournir un nom d'utilisateur, un nom de domaine et un mot de passe. Après l'ouverture de session, l'application Bloc-notes s'ouvre. 

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

    Cet URI a le même effet que l'exemple précédent, sauf qu'il utilise le port non défini par défaut 7555 pour le serveur. Le port par défaut est 443. Comme un identifiant de poste de travail distant est fourni, le poste de travail distant s'ouvre même si l'action start-session n'est pas incluse dans l'URI. 

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

    Cet URI spécifie une application publiée et un poste de travail distant. Lorsque vous spécifiez une application publiée et un poste de travail distant, seul le poste de travail distant démarre.

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

    HTML Access démarre et se connecte au serveur horizon.mycompany.com. La boîte de dialogue de connexion invite l'utilisateur à fournir un nom d'utilisateur, un nom de domaine et un mot de passe. Après l'ouverture de session, le client affiche une boîte de dialogue qui invite l'utilisateur à confirmer l'opération de réinitialisation pour Poste de travail principal.

    Note : Cette action n'est disponible que si un administrateur a autorisé les utilisateurs finaux à réinitialiser leurs machines. 
  9. https://horizon.mycompany.com/?My%20Notepad++?args=%22My%20new%20file.txt%22

    Ouvre My Notepad++ sur le serveur horizon.mycompany.com et transmet l'argument My new file.txt dans la commande de lancement d'application. Le nom de fichier est entre guillemets, car il contient des espaces. 

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

    Ouvre Notepad++ 12 sur le serveur horizon.mycompany.com et transmet l'argument a.text b.txt dans la commande de lancement d'application. Comme l'argument n'est pas entre guillemets double, un espace sépare les noms de fichier et les deux fichiers sont ouverts séparément dans Notepad++.

    Note : Les applications peuvent utiliser les arguments de ligne de commande différemment. Par exemple, si vous transmettez l'argument a.txt b.txt à WordPad, WordPad n'ouvre qu'un seul fichier, a.txt. 
  11. https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=restart

    HTML Access démarre et se connecte au serveur horizon.mycompany.com. La boîte de dialogue de connexion invite l'utilisateur à fournir un nom d'utilisateur, un nom de domaine et un mot de passe. Après l'ouverture de session, le client affiche une boîte de dialogue qui invite l'utilisateur à confirmer l'opération de redémarrage pour Poste de travail principal.

    Note : Cette action n'est disponible que si un administrateur a autorisé les utilisateurs finaux à redémarrer leurs machines. 
  12. https://horizon.mycompany.com/?unauthenticatedAccessEnabled=true&unauthenticatedAccessAccount=anonymous_user1

    HTML Access démarre et se connecte au serveur horizon.mycompany.com en utilisant le compte anonymous_user1.

Exemples de code HTML

Vous pouvez utiliser des URI pour faire des liens hypertextes et des boutons à inclure dans des e-mails ou sur des pages Web. Les exemples suivants montrent comment utiliser l'URI du premier exemple d'URI pour coder un lien hypertexte qui lit Test Link et un bouton qui lit TestButton. 

<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>