# Configuración de vLanzadera en Apache en el Cloud de Velneo

## Apache

La configuración se establece en el fichero /apache2/001-default-ssl.conf del servidor cloud.&#x20;

Podremos editarlo conectándonos con el servidor cloud vía [sftp](https://doc.velneo.com/34/velneo-cloud/explorador-de-archivos-cloud-sftp).

Lo primero que tenemos que asegurarnos es que la línea:

&#x20;`Include /etc/apache2/conf-available/vlanzadera.conf`&#x20;

esté presente al final de nuestro fichero de configuración de Apache. Si no lo está, añadirlo antes de la etiqueta \</VIRTUALHOST>.

Debe quedar algo como sigue:

```
Include /etc/apache2/conf-available/vlanzadera.conf
</VirtualHost>
```

Ahora tenemos que crear el *location* para la aplicación que hemos instalado en el punto anterior. Dentro de la sección *VirtualHost*, debemos tener algo similar a esto:

```
<Location /auth>
setHandler velneo
#VelneoMode SERVER
Vrl vatps://user:pass@localhost:6900/VLANZADERA_APP
</Location>
```

### A tener en cuenta en la configuración de la instancia en Apache

El location tiene que llamarse obligatoriamente /auth.

Si tenemos más de un location declarado en Apache, el de la lanzadera debe ser el último.

El nombre de la aplicación debe ser el identificador de la instancia del proyecto de aplicación de vLanzadera:

![](https://1845363548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfBO7upD4GdyQGlN4VFZf%2Fuploads%2FVqpcWAsK3j8CnZHCGgaC%2Fimage.png?alt=media\&token=496b6a43-8736-4e06-a6d1-2c625d931a28)

El puerto a usar puede ser el indicado u otro, en función de los servicios contratados. Si tienes dudas puedes consultarlo con el personal de soporte de Velneo.&#x20;

La línea *VelneoMode* está comentada intencionadamente, porque esta aplicación **NO FUNCIONA** en ese modo.

El usuario debe ser un [usuario](https://doc.velneo.com/34/velneo-vadmin/gestion-de-usuarios#usuarios) declarado en ese servidor y que tenga privilegios de [supervisor](https://doc.velneo.com/34/velneo-vadmin/gestion-de-usuarios#supervisor).

Puedes añadir dentro de la directiva *Directory* del *Virtual host* una redirección para que la vLanzadera se sirva desde la raíz de nuestro sitio. Debería quedar algo similar a esto:

```
<Directory /home/${USERNAME}/apache2/html/>
        Options FollowSymLinks
        AllowOverride All
        Require all granted

        # Para la redirección de la lanzadera de /* a /auth/*
        RewriteEngine On
        RewriteRule ^/?$ /auth?%{QUERY_STRING} [NC,L]
</Directory>
```

{% hint style="success" %}
Si en el servidor se reinicia alguna solución que está configurada en el fichero de configuración de Apache, debemos reiniciar Apache después.
{% endhint %}

Una vez realizados dichos cambios, reinicia el servicio de Apache desde tu [panel de Velneo Cloud](https://doc.velneo.com/34/velneo-cloud/panel-de-control-vserver-cloud).

## vServer

La lanzadera utiliza [JWT](https://jwt.io/introduction) para intercambiar información con el servidor. Para garantizar y securizar el intercambio de información entre la lanzadera y Velneo vServer, es necesario especificar una clave JWT en el registro de Velneo vServer.

Para ello, en Velneo Cloud es tan sencillo como conectarse por [sftp](https://doc.velneo.com/34/velneo-cloud/explorador-de-archivos-cloud-sftp) y editar el fichero `.config/Velneo/vServer.conf`.&#x20;

Si no la tenemos ya, añadir una línea que contenga la propiedad:

`jwtKey=TU_CLAVE_JWT_DE_32`

La clave JWT debe tener una longitud mínima de 32 caracteres.

De forma opcional, se puede configurar un parámetro de tiempo de validez del token.&#x20;

`jwtExpiredSeconds=NUMERICO_SEGUNDOS`

Por seguridad el servidor solo aceptará el token generado por la lanzadera durante los siguientes jwtExpiredSeconds segundos más 60 segundos de cortesía por si hay desviación de la hora entre el cliente y el servidor.

Si no se configura el parámetro tendrá un valor por defecto de 60 segundos.

{% hint style="danger" %}
Por temas de seguridad, la clave JWT solo debe ser conocida por el administrador.
{% endhint %}
