Saltar a contenido

Configurar Drovio Server

Puede configurar Drovio Server desde el panel de administración o desde los archivos de configuración. En ambos casos, los cambios se tienen en cuenta mientras el servidor está en marcha: el archivo de configuración está bajo vigilancia y una modificación surte efecto en unos segundos, sin interrumpir las sesiones en curso.

Tres excepciones exigen un reinicio

  • Los plugins. La sección plugin_management se lee al arrancar y no se recarga en caliente. Añadir, quitar o reconfigurar un plugin solo surte efecto, por tanto, tras un reinicio. Las integraciones como la integración con Slack entran en este caso.
  • El escuchador HTTP. tls, http_port y https_port se leen una sola vez, cuando el servidor se pone a escuchar. Modificarlos después no tiene efecto hasta el reinicio. En Linux, keystore y keystore_password se vuelven a aplicar sobre el escuchador en curso cuando el servidor recibe SIGUSR2. Consulte Activar HTTPS.
  • El SSO. Los clientes SAML y OIDC se construyen al arrancar. Activar o desactivar el SSO surte efecto de inmediato, pero modificar los ajustes de un proveedor exige un reinicio. Consulte SSO.

Todo lo demás se aplica con el servidor en marcha. Consulte Iniciar y detener el servicio para su plataforma.

Desde el panel de administración

El panel de administración está situado localmente en la dirección:

http://localhost:8090/admin

Sustituya localhost por su dirección IP real si accede a él desde otra máquina. Si no lo consigue, consulte Resolución de problemas.

Panel de administración de Drovio Server: inicio de sesión

Crear el primer administrador

Una instancia de servidor nueva no tiene ningún administrador. En su primer arranque, escribe un token de instalación junto a su archivo de configuración, donde solo el administrador del sistema puede leerlo:

/etc/drovio-server/admin-setup.token

C:\ProgramData\Drovio\Drovio Server\admin-setup.token

config/admin-setup.token, junto a docker-compose.yml.

Abra el panel de administración. Mientras no exista ningún administrador, cada página del panel lleva a Create the first administrator. Introduzca el token y luego su dirección de correo electrónico, el nombre que verán los demás administradores y una contraseña. La contraseña necesita al menos 12 caracteres, y una contraseña común se rechaza.

El servidor elimina el token en cuanto se crea el administrador: ya no puede volver a usarse.

En un clúster

Solo un nodo escribe el token. Su registro indica cuál, en una línea que empieza por There is no administrator yet.

Administradores

Los administradores inician sesión con su dirección de correo electrónico. Puede añadir otros administradores en la página Administrators, que también permite cambiar sus contraseñas o eliminarlos. Cada administrador puede cambiar su nombre visible y su contraseña desde Profile, en el menú del avatar.

Cuando el correo está activado, un administrador puede verificar su dirección con un código enviado por correo electrónico, justo después de iniciar sesión.

El servidor envía avisos a los administradores cuya dirección está verificada: pocas licencias por vincular, un número inusual de códigos enviados por correo, un certificado de inicio de sesión único a punto de caducar, y los de las integraciones y plugins.

Cada administrador puede elegir los avisos que desea recibir desde Notifications, en el menú del avatar.

Actualizar desde una versión anterior a 3.7.0

Las versiones anteriores declaraban los administradores en admin.properties, junto al archivo de configuración. En su primer arranque tras la actualización, Drovio Server los transfiere a la base de datos y luego renombra el archivo admin.properties.migrated. Puede eliminarlo sin riesgo una vez que todos los administradores hayan migrado.

Estos administradores aún no tienen dirección de correo electrónico y deben seguir estos pasos:

  1. En la página de inicio de sesión, siga Migrating from admin.properties?. El enlace se muestra mientras quede algún administrador por migrar.
  2. Inicie sesión con el nombre de usuario y la contraseña de admin.properties.
  3. Introduzca su dirección de correo electrónico y el nombre que verán los demás administradores.
  4. Cuando el correo está activado, introduzca el código enviado a esa dirección.
  5. Sustituya la contraseña si no cumple las reglas anteriores, como el antiguo admin / admin predeterminado.

A partir de entonces, inicie sesión con su dirección de correo electrónico.

Una vez conectado, diríjase a la página Settings como se muestra abajo para llegar al panel de configuración.

Panel de administración de Drovio Server: ajustes

Desde ahí puede modificar cualquier ajuste que utilice Drovio Server. Consulte la referencia de configuración para conocer el detalle de cada campo.

Un ajuste que cambiar sin esperar

La URL que designa a este servidor: HTTP server → URL, necesaria para las notificaciones y las invitaciones de usuarios.

Desde los archivos de configuración

Drovio Server se configura mediante un archivo JSON:

Abra /etc/drovio-server/settings.conf.

Abra C:\ProgramData\Drovio\Drovio Server\settings.conf.

La configuración está en formato JSON. Cada campo se describe en la referencia de configuración.

Su secreto JWT

http.jwt_secret firma las sesiones de los usuarios y los tokens en la API. Desde la versión 3.6.7, toda instalación, mediante los instaladores de Windows y Linux o las imágenes Docker, genera un secreto en el primer arranque. No tiene nada que hacer.

Las instalaciones desplegadas con la versión 3.6.6 o anterior llevaban el valor entregado en el paquete. Sustitúyalo por una cadena aleatoria propia, por ejemplo la salida de openssl rand -base64 32. Al hacerlo, los usuarios conectados quedan desconectados.

Para saber más