Utilizar URI para configurar clientes web de HTML Access

Puede utilizar identificadores uniformes de recursos (URI) para crear enlaces web o de correo electrónico para los usuarios finales. Los usuarios finales pueden hacer clic en estos vínculos para iniciar HTML Access, conectarse a un servidor, e iniciar una aplicación publicada o un escritorio remoto con opciones de configuración específicas.

Para ello, deberá crear URI que ofrezcan toda la información (o parte de ella) que se indica a continuación para que los usuarios finales no tengan que proporcionarla.

Dirección de servidor
Número de puerto para Connection Server
Nombre de usuario de Active Directory
Nombre de usuario de RSA SecurID o RADIUS (si es distinto al nombre de usuario de Active Directory)
Nombre de dominio
Nombre para mostrar del escritorio remoto o la aplicación publicada
Acciones (como navegar, restablecer e iniciar o cerrar sesión)

Especificación de URI

La sintaxis necesaria incluye una parte de ruta para especificar el servidor y, de forma opcional, una consulta para especificar un usuario, un escritorio remoto o una aplicación publicada, así como opciones de configuración o acciones.

Para crear una URI para iniciar HTML Access, utilice la siguiente sintaxis:

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

authority-part

Especifica la dirección del servidor y, de manera opcional, un número de puerto no predeterminado. Los nombres de servidor deben adaptarse a la sintaxis de DNS.

Para especificar un número de puerto, utilice la siguiente sintaxis:

server-address:port-number

query-part

Especifica las opciones de configuración que se van a utilizar o las acciones que se van a realizar. Las consultas no distinguen entre mayúsculas y minúsculas. Para utilizar varias consultas, utilice el signo et (&) entre ellas. Si se produce un conflicto entre ellas, se utilizará la última consulta de la lista. Utilice la siguiente sintaxis:

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

Tenga en cuenta las siguientes instrucciones al crear la parte de la consulta:

Si no usa al menos una de las consultas admitidas, se mostrará la página del portal web de VMware Horizon predeterminada.
En la parte de la consulta, algunos caracteres especiales no son compatibles y debe usar el formato de codificación URL de la siguiente manera: para el signo almohadilla (#) use %23, para el signo porcentaje (%) use %25, para el signo et (&) use %26, para el signo arroba (@) use %40 y para la barra diagonal inversa (\) use %5C.
Para obtener más información sobre la codificación URL, diríjase a http://www.w3schools.com/tags/ref_urlencode.asp.
En la parte de la consulta, se debe codificar primero los caracteres que no sean ASCII según UTF-8 [STD63]. A continuación, cada octeto de la secuencia UTF-8 correspondiente se debe codificar con porcentaje para representarse como caracteres URI.
Para obtener información sobre la codificación de caracteres ASCII, consulte la referencia de codificación de URL de http://www.utf8-chartable.de/.

Consultas admitidas

En este tema se incluyen las consultas admitidas para HTML Access. Si crea URI para varios tipos de clientes (por ejemplo, clientes móviles y de escritorio), consulte la guía correspondiente a cada tipo de sistema cliente.

action

Tabla 1. Valores que se pueden utilizar con la consulta action
Valor	Descripción
browse	Muestra una lista de las aplicaciones publicadas y los escritorios remotos disponibles y alojados en el servidor especificado. No tendrá que especificar un escritorio remoto ni una aplicación publicada cuando use esta acción.
start-session	Inicia la aplicación publicada o el escritorio remoto especificados. Si no se proporciona ninguna consulta action y se facilita el nombre de la aplicación publicada o del escritorio remoto, start-session es la acción predeterminada.
reset	Apaga y reinicia el escritorio remoto especificado. Se pierden los datos que no se hayan guardado. La acción de reiniciar un escritorio remoto es equivalente a pulsar el botón Reiniciar en un equipo físico. Esta acción no es válida para aplicaciones publicadas.
logoff	Cierra la sesión del usuario en el sistema operativo invitado del escritorio remoto. Esta acción no es válida para aplicaciones publicadas.
restart	Cierra y vuelve a iniciar el escritorio remoto principal una vez que el usuario confirma la solicitud de operación de reinicio. Esta acción no es válida para aplicaciones publicadas.

applicationId

El nombre para mostrar de la aplicación publicada. El nombre para mostrar es el que se especifica en Horizon Console al crear el grupo de aplicaciones. Si el nombre para mostrar contiene un espacio, el navegador usará %20 para representarlo.

args

Especifica los argumentos de la línea de comandos que se agregan cuando se inicia una aplicación publicada. Utilice la sintaxis args= value, en el que value es una cadena. Utilice la codificación con porcentajes para los siguientes caracteres:

Para los dos puntos (:), utilice %3A.
Para una barra diagonal inversa (\), utilice %5C.
Para un espacio ( ), utilice %20.
Para unas comillas dobles ("), use %22.

Por ejemplo, para especificar el nombre de archivo "My new file.txt" para la aplicación Notepad++, utilice %22My%20new%20file.txt%22.

desktopId

El nombre para mostrar del escritorio remoto. El nombre para mostrar es el que se especificó en Horizon Console cuando se creó el grupo de escritorios. Si el nombre para mostrar contiene un espacio, el navegador usará %20 para representarlo.

domainName

El nombre de dominio NETBIOS asociado al usuario que se conecta a la aplicación publicada o al escritorio remoto. Por ejemplo, use mycompany en lugar de mycompany.com.

tokenUserName

El nombre de usuario RSA o RADIUS. Utilice esta consulta solo si el nombre de usuario de RSA o RADIUS es diferente al de Active Directory. Si no especifica esta consulta y se necesita la autenticación RSA o RADIUS, se utilizará el nombre de usuario de Windows.

userName

El usuario de Active Directory que se conecta a la aplicación publicada o al escritorio remoto. El nombre de usuario puede tener uno de los formatos siguientes:

Nombre de usuario
nombre de dominio%5Cnombre de usuario
nombre principal de usuario (UPN), es decir, nombre de usuario@nombre de dominio

unauthenticatedAccessEnabled

Cuando esta opción está establecida como true, la función Acceso sin autenticar está habilitada de forma predeterminada. HTML Access se inicia y aparece una cuenta de usuario anónima. Un ejemplo de sintaxis es unauthenticatedAccessEnabled=true.

unauthenticatedAccessAccount

Establece la cuenta que se debe utilizar si la función Acceso sin autenticar está habilitada. Si la función Acceso sin autenticar está desactivada, esta consulta se ignora. Un ejemplo de sintaxis con la cuenta de usuario anonymous1 es unauthenticatedAccessAccount=anonymous1.

webviewMode

Cuando esta opción está establecida en true, la sesión remota se iniciará en modo webview. En el modo webview, la barra lateral de HTML Access estará oculta. El modo webview también permite que ciertas aplicaciones móviles de terceros hagan lo siguiente:

Enviar eventos del teclado flexible al escritorio remoto
Utilizar la interfaz de la aplicación móvil para cambiar entre el modo táctil nativo y el modo táctil del trackpad en HTML Access

Ejemplos de sintaxis de URI

Cada uno de estos ejemplos de URI aparece con una descripción sobre qué es lo que el usuario final ve después de hacer clic en el vínculo del URI. Las consultas no distinguen entre mayúsculas y minúsculas (por ejemplo, puede utilizar nombreDominio o nombredominio).

```
https://horizon.mycompany.com/?domainName=finance&userName=fred
```
HTML Access se inicia y se conecta al servidor horizon.mycompany.com. En el cuadro de inicio de sesión, el cuadro de texto Nombre de usuario se rellena con el nombre fred y el cuadro de texto Dominio se rellena con finance. El usuario solo debe proporcionar una contraseña.
```
https://horizon.mycompany.com/?userName=finance%5Cfred
```
HTML Access se inicia y se conecta al servidor horizon.mycompany.com. En el cuadro de inicio de sesión, el cuadro de texto Nombre de usuario se rellena con el nombre horizon.mycompany.com. El usuario solo debe proporcionar una contraseña.
```
https://horizon.mycompany.com/?userName=fred@finance
```
HTML Access se inicia y se conecta al servidor horizon.mycompany.com. En el cuadro de inicio de sesión, el cuadro de texto Nombre de usuario se rellena con el nombre fred@finance. El usuario solo debe proporcionar una contraseña.
```
https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=start-session
```
HTML Access se inicia y se conecta al servidor horizon.mycompany.com. El cuadro de inicio de sesión solicita un nombre de usuario, de dominio y una contraseña. Tras iniciar sesión correctamente, el cliente se conecta al escritorio remoto cuyo nombre para mostrar es Escritorio primario, y el usuario inicia sesión en el sistema operativo cliente.
```
https://horizon.mycompany.com/?applicationId=Notepad&action=start-session
```
HTML Access se inicia y se conecta al servidor horizon.mycompany.com. El cuadro de inicio de sesión solicita un nombre de usuario, de dominio y una contraseña. Tras iniciar sesión correctamente, se inicia la aplicación Bloc de notas.
```
https://horizon.mycompany.com:7555/?desktopId=Primary%20Desktop
```
Este URI tiene el mismo efecto que el ejemplo anterior, excepto que usa el puerto no predeterminado 7555 para el servidor. El puerto predeterminado es 443. Dado que se proporciona el identificador del escritorio remoto, el escritorio remoto se inicia aunque la acción start-session no se incluya en el URI.
```
https://horizon.mycompany.com/?applicationId=Primary%20Application&desktopId=Primary%20Desktop
```
Este URI especifica una aplicación publicada y un escritorio remoto. Cuando se especifican una aplicación publicada y un escritorio remoto, solo se inicia el escritorio remoto.
```
https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=reset
```
HTML Access se inicia y se conecta al servidor horizon.mycompany.com. El cuadro de inicio de sesión solicita un nombre de usuario, de dominio y una contraseña. Tras iniciar sesión correctamente, el cliente muestra un cuadro de diálogo que le solicita al usuario que confirme la operación para restablecer el Escritorio primario.

Nota: Esta acción solo está disponible si un administrador permite a los usuarios finales restablecer sus equipos.
```
https://horizon.mycompany.com/?My%20Notepad++?args=%22My%20new%20file.txt%22
```
Abre Notepad++ en el servidor horizon.mycompany.com y envía el argumento My new file.txt al comando que inicia la aplicación. El nombre del archivo aparece entre comillas dobles porque contiene espacios.
```
https://horizon.mycompany.com/?Notepad++%2012?args=a.txt%20b.txt
```
Abre Notepad++ 12 en el servidor horizon.mycompany.com y envía el argumento a.text b.txt al comando que inicia la aplicación. Dado que los argumentos no están entre comillas dobles, un espacio separa los nombres de los archivos y ambos archivos se abren de forma independiente en Notepad++.

Nota: Las aplicaciones pueden utilizar los argumentos de la línea de comandos de forma diferente. Por ejemplo, si envía el argumento a.txt b.txt a WordPad, este último solo abrirá un archivo, a.txt.
```
https://horizon.mycompany.com/?desktopId=Primary%20Desktop&action=restart
```
HTML Access se inicia y se conecta al servidor horizon.mycompany.com. El cuadro de inicio de sesión solicita un nombre de usuario, de dominio y una contraseña. Tras iniciar sesión correctamente, el cliente muestra un cuadro de diálogo que le solicita al usuario que confirme la operación para reiniciar el Escritorio primario.

Nota: Esta acción solo está disponible si un administrador permite a los usuarios finales reiniciar sus equipos.

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

HTML Access se inicia y se conecta al servidor horizon.mycompany.com mediante la cuenta anonymous_user1.

Ejemplos de códigos HTML

Si lo desea, puede utilizar los URI para hacer que los botones y los vínculos de hipertexto se incluyan en correos electrónicos o en páginas web. Los siguientes ejemplos muestran cómo usar el URI en el primer ejemplo de URI para codificar un vínculo de hipertexto que aparece como Test Link y un botón que aparece como 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>