Integración externa - Tailscale

Desarrollo
1

Hola a todos,

Os presento una nueva integración externa para Gladys: Tailscale.

image
image800×534 52.9 KB

¿Para qué sirve?

Si usas Tailscale para conectar tu Gladys, tu NAS o tus servidores remotos, esta integración muestra el estado de tu red (tu « tailnet ») directamente en Gladys.

Cada máquina del tailnet se convierte en un dispositivo Gladys con:

  • En línea: la máquina está conectada al tailnet o no;
  • Actualización disponible: existe una versión más reciente de Tailscale para ella;
  • Expiración de la clave: el número de días antes de que deba volver a conectarse;
  • Expiración desactivada: un interruptor, como el menú « Disable key expiry » de la consola Tailscale.

Escenas (Gladys 5.1 y superiores)

Disparadores:

  • máquina en línea o fuera de línea;
  • nueva máquina en el tailnet (aprobada o en espera de aprobación);
  • actualización de Tailscale disponible;
  • clave pronto expirada (plazo ajustable, 14 días por defecto).

Acciones:

  • actualizar el tailnet;
  • leer el estado de una máquina (en línea, IP, versión, días antes de la expiración…);
  • activar o desactivar la expiración de la clave de una máquina.

Ejemplo: cuando mi NAS se desconecta, enviarme un mensaje « {{triggerEvent.data.device_name}} está fuera de línea ».

Widget

Un widget Red Tailscale para el tablero: número de máquinas en línea y fuera de línea, estado de la API, y la lista de máquinas que requieren tu atención (fuera de línea, clave que expira, actualización, en espera de aprobación). Un botón « Actualizar » y un enlace a la consola de administración.

¿Cómo funciona?

  • La integración se realiza a través de la API de Tailscale, en la nube: nada que instalar en tus máquinas, y Gladys no necesita estar en el tailnet.
  • Conexión mediante token de acceso API, o mejor mediante cliente OAuth con el permiso devices:core: no expira nunca.
  • Una sola solicitud por lectura, cada 60 segundos por defecto (ajustable).
  • Los tokens y secretos nunca se escriben en los registros.
  • Disponible en francés, inglés, alemán y español.

Instalación

  1. Necesitas Gladys 5.1 o superior.
  2. Instala Tailscale desde el catálogo de integraciones de Gladys.
  3. Crea un cliente OAuth en la consola de Tailscale: Settings → OAuth clients, con el permiso Devices → Core (Read es suficiente para monitorear, Write además para cambiar la expiración de las claves desde Gladys).
  4. Pega el ID y el secreto en la pestaña Configuración, luego haz clic en Probar la conexión.
  5. Añade tus máquinas desde la pestaña Descubrimiento.

La documentación completa está aquí: docs/fr.md

Enlaces

¡Es la primera versión (1.0.0)! Tus comentarios son bienvenidos, aquí o en GitHub.

Integración comunitaria, no afiliada a Tailscale Inc.