Despliegue de GeoGuardian - TeamSecurityFirst/GeoGuardianWiki GitHub Wiki

Instalación del servidor backend de GeoGuardian

Para instalar el servidor es necesario instalar el paquete geoguardian-server_1.1-0_amd64.deben la máquina deseada mediante el siguiente comando:

$ sudo dpkg -i geoguardian-server_1.1-0_amd64.deb

Una vez instalado se deberán seguir los siguientes pasos:

  • Instalación de redis:

    $ sudo apt install redis
    
  • Configuración de un proxy a utilizar como punto de securización del server. El propio paquete incluye una configuración de ejemplo para Nginx ubicada en /usr/share/doc/geoguardian-server/proxies/.

  • Rellenar los parámetros de configuración correspondientes en el archivo /etc/geoguardian-server/geoguardian-server.conf. Los campos que se encuentran en este archivo son:

    • global

      • base-url: url en la que se espera que el servidor este expuesto.
      • url-prefix: prefijo de la url principal.
      • logfile: ubicación del archivo de log del servidor.
      • user: usuario que corre el servicio geoguardian-uwsgi.
      • timezona: zona horaria a utilizar por la app.
      • secret-key: clave secreta que se debe generar y cubrir la primera vez antes de iniciar el servicio.
      • debug: modo de debug del servidor (dejar a false).
      • environment: identificador del entorno en el que nos encontramos (dev, pre, pro, etc).
    • ssl

      • enabled: ssl habilitado o no.
      • header-name: cabecera a enviar por ssl (no cambiar).
      • header-value: valor de la cabecera anterior (no cambiar).
    • telegram

      • token: token de telegram a utilizar.
    • email

      • port: puerto del host al que conectarse para solicitar el envío del correo.
      • tls: habilitar ssl o no.
      • host: host que envía el correo.
      • host-user: usuario que envia el correo.
      • host-password: contraseña del usuario anterior.
    • firebase

      • apikey: apikey de firebase.

      • authdomain: dominio de autenticación contra firebase.

      • databaseURL: url a la BD de firebase.

      • storageBucket: url al contenedor de almacenamiento de firebase.

      • tables

        • users: tabla de usuarios existente en firebase.
    • osrm

      • base-url: url base del servidor OSRM al que consultar.
    • redis

      • url: ubicación de redis.
    • database

      • engine: motos de BD a utilizar.

      • name: nombre de la BD a utiliar por el server.

      • host: ubicación de la BD.

      • port: puerto para conectarse a la BD.

      • user: usuario con el que conectarse a la BD.

      • password: contraseña del usuario anterior.

      • options

        • sql_mode: configuración específica de la BD (no modificar en caso de utilizar MySQL).
  • Acceder al archivo /etc/geoguardian-server/geoguardian-server.params y seguir los pasos que ahí se mencionan. Principalmente cambiar el valor de ENABLE a 1.

  • Iniciar los servicios correspondientes:

$ sudo systemctl start geoguardian-uwgsgi.service geoguardian-celery.service

Instalación del cliente frontend de GeoGuardian

Para instalar el cliente es necesario instalar el fichero GeoGuardian-v1.0.apk en la un dispositivo Android que ejecute una versión igual o superior a la 4.1 (es decir >= SDK 16).