Externe Integration - Tailscale

Entwicklung
1

Hallo zusammen,

Ich stelle euch eine neue externe Integration für Gladys vor: Tailscale.

image
image800×534 52.9 KB

Wofür ist das gut?

Wenn ihr Tailscale verwendet, um Gladys, euer NAS oder eure Server remote zu verbinden, zeigt diese Integration den Status eures Netzwerks (euer „Tailnet“) direkt in Gladys an.

Jede Maschine im Tailnet wird zu einem Gladys-Gerät mit:

  • Online: Die Maschine ist mit dem Tailnet verbunden oder nicht;
  • Update verfügbar: Eine neuere Version von Tailscale ist für sie verfügbar;
  • Schlüsselablauf: Die Anzahl der Tage, bevor sie sich erneut verbinden muss;
  • Ablauf deaktiviert: Ein Schalter, wie das Menü „Disable key expiry“ in der Tailscale-Konsole.

Szenen (Gladys 5.1 und höher)

Auslöser:

  • Maschine online oder offline;
  • Neue Maschine im Tailnet (genehmigt oder auf Genehmigung wartend);
  • Tailscale-Update verfügbar;
  • Schlüssel bald abgelaufen (einstellbare Frist, standardmäßig 14 Tage).

Aktionen:

  • Tailnet aktualisieren;
  • Status einer Maschine lesen (online, IP, Version, Tage bis zum Ablauf…);
  • Schlüsselablauf einer Maschine aktivieren oder deaktivieren.

Beispiel: Wenn mein NAS offline geht, mir eine Nachricht „{{triggerEvent.data.device_name}} ist offline“ senden.

Widget

Ein Tailscale-Netzwerk-Widget für das Dashboard: Anzahl der online und offline Maschinen, Status der API und die Liste der Maschinen, die eure Aufmerksamkeit erfordern (offline, ablaufender Schlüssel, Update, auf Genehmigung wartend). Ein „Aktualisieren“-Button und ein Link zur Admin-Konsole.

Wie funktioniert das

  • Die Integration erfolgt über die Tailscale-API in der Cloud: Nichts muss auf euren Maschinen installiert werden, und Gladys muss nicht im Tailnet sein.
  • Verbindung per API-Zugriffstoken oder besser per OAuth-Client mit dem Recht devices:core: Es läuft nie ab.
  • Ein einzelner Request pro Lesevorgang, standardmäßig alle 60 Sekunden (einstellbar).
  • Tokens und Geheimnisse werden nie in den Logs geschrieben.
  • Verfügbar auf Französisch, Englisch, Deutsch und Spanisch.

Installation

  1. Ihr benötigt Gladys 5.1 oder neuer.
  2. Installiert Tailscale aus dem Gladys-Integrationskatalog.
  3. Erstellt einen OAuth-Client in der Tailscale-Konsole: Settings → OAuth clients, mit dem Recht Devices → Core (Read reicht zum Überwachen, Write zusätzlich, um den Schlüsselablauf von Gladys aus zu ändern).
  4. Fügt die ID und das Geheimnis im Tab Konfiguration ein und klickt auf Verbindung testen.
  5. Fügt eure Maschinen aus dem Tab Entdeckung hinzu.

Die vollständige Dokumentation findet ihr hier: docs/fr.md

Links

Das ist die erste Version (1.0.0): Euer Feedback ist willkommen, hier oder auf GitHub!

Community-Integration, nicht mit Tailscale Inc. verbunden