Wolwebapp es un aplicación que posibilita el encendido remoto de ordenadores, monitorizar el estado de los mismos y la gestión de usuarios y sus permisos, todo ello desde un interfaz web.
Para configurar la instalación del servicio tan solo es necesario descargar el fichero install.sh y ejecutarlo en una shell de Linux, siguiendo estos pasos:
wget https://raw.githubusercontent.com/DAT-ETSIT/wolwebapp/main/install.sh
chmod +x install.sh
sudo ./install.shA continuación se detalla el funcionamiento del mismo:
Comprueba que estén instaladas las dependencias necesarias y en caso de que haya alguna que no, la instala. Las dependencias necesarias son: git python3 python3-pip python3-venv openssl wakeonlan.
Una vez instaladas las dependencias, clona el repositorio wolwebapp y cambia el directorio de trabajo al generado con la clonación.
En caso de no proporcionar un certificado propio (ver apartado Argumentos), el terminal solicitará algunos parámetros para generarlo de forma automática.
Con el certificado ya introducido o generado, se crea un entorno virtual de python para la aplicación en el que se instalan las librerías necesarias para la misma. Estas se encuentran en el fichero requirements.txt.
Entre los comentarios que van apareciendo en el terminal el script solicita un nombre "identificativo del servidor", este nombre es el que aparecerá en las cabeceras de los correos que se envían de forma automática. También hay que introducir manualmente el correo y la contraseña del primer administrador de la aplicación (esta contraseña se podrá modificar más adelante en la propia aplicación).
Finalmente se configura el envío de mensajes por correo electrónico y se levanta el servicio. Este servicio se utiliza para el envío de las credenciales temporales para el alta o modificación de usuarios sin que el administrador pueda conocerlas.
Los argumentos que pueden utilizarse a la hora de instalar
-h Mostrar ayuda
-b BIND_ADDRESS - Dirección de la interfaz de reden la que escuchará el servidor (por defecto 0.0.0.0).
-p PORT - Puerto empleado por la aplicación. Si se inicia en modo 'standalone' se emplean 80 y 443 por defecto, si se configura para emplear junto con un proxy inverso, se emplea el 3000.
-w PARENT_PATH - Directorio donde se instalará la aplicación (por
defecto /srv).
-m SERVER_MODE - Si se especifica 'standalone', se instalará el servicio en los puertos 80 y 443 y se empleará el certificado SSL indicado. Si no es especifica o el valor es distinto, el servidor tan solo estará disponble en el puerto especificado y solo en modo http.
-c CERT_PATH - Ruta del certificado SSL.
-k KEY_PATH - Clave del certificado SSL.