> For the complete documentation index, see [llms.txt](https://doc.velneo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.velneo.com/38/velneo/velneo-web.md).

# Velneo Web

Se trata de la versión web de los componentes cliente de la plataforma Velneo. Esto facilita la ejecución de los componentes cliente de Velneo sin tener que instalarlos en los equipos locales.

En esta versión están disponibles para su acceso vía web los siguientes componentes:

* [Velneo vAdmin](/38/velneo-vadmin/velneo-vadmin-web.md).
* [Velneo vDataClient](/38/velneo-vdataclient/velneo-vdataclient-web.md).
* [Velneo vClient](/38/velneo-vclient-web.md).

Los componentes Velneo se han compilado y adaptado a la tecnología [Web assembly](https://developer.mozilla.org/es/docs/WebAssembly), lo que permite ejecutar los componentes de Velneo directamente en un navegador web sin tener que instalar ninguna aplicación, lo que nos facilitará enormemente, por un lado, el poder programar desde cualquier [máquina y navegador compatibles](/38/velneo/velneo-web/plataformas-y-navegadores-compatibles.md) y, por el otro, el despliegue de nuestras aplicaciones a clientes finales.

El diseño de su interfaz está adaptada a web y es distinto al de la versión de escritorio.

Al tratarse de la versión web, hay funcionalidades que no existen o que funcionan de forma diferente que en la versión de escritorio. Estas diferencias se detallan en la documentación de cada componente.

## Conexión con Velneo vServer Web

Existen dos forma de conectarse vía web a un servidor:

1. Conexión directa a virtualhost del [servicio HTTPS](/38/velneo-vserver/servicio-https.md) de Velneo vServer.
2. Vía URL externa.

### Conexión directa a virtualhost del [servicio HTTPS](/38/velneo-vserver/servicio-https.md) de Velneo vServer

Podemos acceder a [Velneo vAdmin Web](/38/velneo-vadmin/velneo-vadmin-web.md), a [Velneo vDataClient Web](/38/velneo-vdataclient/velneo-vdataclient-web.md) y a [Velneo vClient Web](/38/velneo-vclient-web.md) directamente a través del *virtualhost* que se crea por defecto en el servidor para el [servicio HTTPS](/38/velneo-vserver/servicio-https.md). La URL será:

`https://dominio_del_servidor[:puerto]/login`

La página de inicio de sesión se abre siempre con `/login`. La raíz del dominio (`https://dominio_del_servidor[:puerto]/`) muestra lo que se haya configurado en el [virtual host](/38/velneo-vadmin/web.md#las-propiedades-de-un-virtual-host-son-las-siguientes) en Velneo vAdmin; si no se ha configurado nada, devuelve un error 404.

En el caso de un servidor cloud, el dominio y puerto del servidor serán los que se indiquen en la sección [Apache](/38/velneo-cloud/panel-de-control-vserver-cloud/apache.md) del panel de control cloud.

{% hint style="warning" %}
En **Velneo Cloud**, para que la página `/login` sea funcional es necesario añadir en el fichero de configuración de Apache (`/apache2/001-default-ssl.conf`) la siguiente línea:

`#HTTPSERVER`
{% endhint %}

En el caso de un servidor local, será el dominio configurado en el virtualhost por defecto (cuyo puerto es el estándar, el 443).

En la página de *login* aparecen los accesos directos a los tres componentes:

<figure><img src="https://1985084359-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSSuDG1WIgF9xPUK4NaFS%2Fuploads%2FQuoaWqOiwgungDqQJ3uT%2Fimage.png?alt=media&amp;token=0a7b4a6e-1b63-4ff1-ac4b-6b503af7a200" alt=""><figcaption></figcaption></figure>

#### **Administrador (Gestión de aplicaciones y entorno)**

Ejecutará [Velneo vAdmin Web](/38/velneo-vadmin/velneo-vadmin-web.md).

#### Gestor bbdd (Acceso y gestión de datos)

Ejecutará [Velneo vDataClient Web](/38/velneo-vdataclient/velneo-vdataclient-web.md).

#### Conectar (Ejecutar aplicación)

Nos permitirá ejecutar una instancia con [Velneo vClient Web](/38/velneo-vclient-web.md), sin necesidad de conocer ni construir manualmente los parámetros internos de la URL.

Al seleccionarla, se solicitan las credenciales de un usuario del servidor. Tras autenticarse correctamente, se muestra un selector con las instancias web disponibles para ese usuario. Seleccionando una de ellas, se ejecuta Velneo vClient Web con dicha instancia.

{% hint style="warning" %}
El selector de instancias solo se muestra tras una autenticación válida; no se expone públicamente ninguna información sobre las instancias del servidor a usuarios no autenticados.
{% endhint %}

**Pasar parámetros de arranque a la aplicación**

Añadiendo **appArgs** a la dirección de `/login`, lo que se escriba llega a la instancia que se ejecute después con **Conectar**, igual que un parámetro de arranque de Velneo vClient en un acceso directo del escritorio:

`https://dominio_del_servidor[:puerto]/login?appArgs=userParam=estado=2`

El parámetro se puede repetir y se escribe sin la barra inicial. Está explicado en [Velneo vClient Web](/38/velneo-vclient-web.md), junto con los parámetros que no se pueden cambiar desde la dirección.

{% hint style="info" %}
El parámetro se escribe en la URL de `/login`, antes de autenticarte y de elegir la instancia en el selector. Da igual qué instancia selecciones después con **Conectar**: el `appArgs` escrito en la URL le llega a la que sea.
{% endhint %}

#### **Acceso directo a una instancia**

Añadiendo el parámetro **instancia** a la dirección de `/login`, la página solo muestra el botón **Conectar** (se ocultan **Administrador** y **Gestor bbdd**) y, tras autenticarse, ejecuta directamente esa instancia sin pasar por el selector:

`https://dominio_del_servidor[:puerto]/login?instancia=ID_INSTANCIA`

Se puede combinar con **appArgs**:

`https://dominio_del_servidor[:puerto]/login?instancia=ID_INSTANCIA&appArgs=userParam=hola`

**Usuario y contraseña en la dirección**

Si la dirección incluye una VRL con el usuario, la página rellena los campos de usuario y, si se indica, de contraseña, sin lanzar ningún componente:

`https://dominio_del_servidor[:puerto]/login?vatps://usuario[:contraseña]@servidor[/ID_INSTANCIA]`

**Ejecución automática (#run)**

Permite lanzar Velneo vClient Web directamente, sin pasar por el formulario. Los datos se indican en el fragmento de la dirección (detrás de `#`), que el navegador no envía al servidor, por lo que no quedan registrados en los logs de acceso:

`https://dominio_del_servidor[:puerto]/login/?instancia=ID_INSTANCIA#run&vrl=VRL&token=TOKEN`

* **vrl**: VRL codificada para URL con el usuario y la instancia, por ejemplo `vatps://usuario@servidor/ID_INSTANCIA`.
* **token**: token de acceso de un solo uso. Si se indica, no se usa contraseña.

También se puede usar con usuario y contraseña en la VRL:

`https://dominio_del_servidor[:puerto]/login/?vatps://usuario:contraseña@servidor&instancia=ID_INSTANCIA#run`

Antes de lanzar la aplicación, la página limpia la barra de direcciones dejando únicamente `?instancia=ID_INSTANCIA`, de modo que ni el token ni la contraseña quedan visibles. Si falta la instancia o el usuario, se muestra el formulario de inicio de sesión.

**Recordar credenciales**

Si marcamos esta casilla, el navegador recordará el usuario y la contraseña para la próxima vez que accedamos a la página desde ese mismo navegador. El último usuario utilizado se recuerda siempre.

{% hint style="danger" %}
La contraseña se guarda en el almacenamiento local del navegador **sin cifrar**. No marques esta opción en equipos compartidos o públicos.
{% endhint %}

**Teclado**

Pulsando **Intro** en el campo de usuario se pasa al de contraseña. Pulsando **Intro** en el campo de contraseña se lanza **Administrador** o, si la dirección incluye el parámetro **instancia**, **Conectar**.

**Funcionamiento en intranets**

La página `/login` es autosuficiente: todos los ficheros necesarios para lanzar los componentes web se sirven desde el propio Velneo vServer, sin descargar nada de internet. Únicamente la fuente tipográfica se descarga de Google Fonts y, si no hay acceso a internet, se usa una fuente alternativa del sistema.

Los ficheros se sirven comprimidos en formato Brotli, soportado por todos los navegadores compatibles.

### Conexión vía URL externa

{% hint style="warning" %}
web.velneo.com desaparecerá en futuras versiones, incluidas las URL de conexión que se describen a continuación. La página `/login` del [servicio HTTPS](/38/velneo-vserver/servicio-https.md) de Velneo vServer la sustituye.
{% endhint %}

Para conectarnos con un Velneo vServer cloud usaremos la url siguiente:

[https://web.velneo.com](https://web.velneo.com/)

En ella, debemos especificar los siguientes datos:

#### Servidor

VRL de tu servidor cloud. La encontrarás en tu [panel de control cloud](/38/velneo-cloud/panel-de-control-vserver-cloud.md). Ejemplo:

\[vatps\://]c3.velneo.com:37280

En el caso de que tengas contratado el servicio de [Velneo vModApache en cloud](/38/velneo-cloud/velneo-vmodapache-en-cloud.md), especificarás tu subdominio. Ejemplo:

\[vatps\://]misubdominio.velneo.net

O el dominio que tengas redirigido a éste.

El esquema (vatps\://) es opcional.

#### Usuario

Nombre de un usuario de tu Velneo vServer.

#### Contraseña

Contraseña del usuario declarado en el parámetro anterior.

Y tendemos que seleccionar una de las acciones siguientes:

#### Administrar

Si pulsamos este botón se lanzará [Velneo vAdmin Web](/38/velneo-vadmin/velneo-vadmin-web.md).

#### Gestionar BBDD

Si pulsamos este botón se lanzará [Velneo vDataClient Web](/38/velneo-vdataclient/velneo-vdataclient-web.md).

{% hint style="info" %}
En la página de conexión, en función de la vrl introducida se habilitarán los botones de editar y/o administrar automáticamente, teniendo en cuenta si el Velneo vServer al que nos vamos a conectar soporta dicha función.
{% endhint %}

{% hint style="warning" %}
Por este método también podremos conectarnos a servidores locales, pero será requisito indispensable que tengan configurado un certificado SSL válido. No podremos conectarnos si usamos los certificados de pruebas que Velneo incluye por defecto para servidores locales.
{% endhint %}

Via URL externa también podemos **ejecutar aplicaciones en Web**. Ver el punto [Velneo vClient Web](/38/velneo-vclient-web.md).
