Intégrations

Tailscale

Configurer le widget avec OAuth et distinguer widget, accès distant et auth key.

Trois usages différents sont souvent confondus :

UsageIdentifiant nécessaireOù le configurer
Afficher les appareils du tailnet dans le widgetOAuth Client ID + OAuth Client SecretNasDash, connexion d’intégration partagée
Ouvrir NasDash à distance via Tailscaleaucun secret dans NasDashclient Tailscale de chaque machine
Enrôler automatiquement une nouvelle machineauth key Tailscalesur cette machine, pas dans le widget

Créer l'identifiant du widget

  1. Ouvrez la console des clients OAuth.
  2. Créez un client avec seulement les lectures nécessaires, comme devices:core:read.
  3. Copiez immédiatement Client ID et secret.
  4. Enregistrez une connexion Tailscale dans Réglages → Intégrations, avec tailnet, Client ID et secret.
  5. Tous les widgets Tailscale utilisent la dernière connexion Tailscale ou Headscale enregistrée ; enregistrez la connexion souhaitée en dernier. Il n’y a pas de sélecteur par widget.

Le tailnet peut être son nom DNS ou l'identité indiquée par votre console. Les clients OAuth et leurs portées sont expliqués dans la documentation officielle Tailscale.

Ne collez pas une auth key dans le widget

Une clé commençant généralement par tskey-auth- sert à connecter une machine au tailnet. Le widget attend un secret OAuth de client, généralement présenté comme tskey-client-..., ainsi que son Client ID.

Accéder à NasDash par Tailscale

  1. Installez Tailscale sur l'hôte qui exécute NasDash et sur le poste client.
  2. Connectez les deux au même tailnet.
  3. Gardez le port NasDash accessible sur l'IP Tailscale ou utilisez un reverse proxy privé.
  4. Ouvrez http://IP_TAILSCALE:2504.

Cette méthode ne nécessite pas d'activer le widget. Protégez tout de même NasDash avec des mots de passe forts et des ACL Tailscale adaptées.

Rotation

Créez un nouveau client OAuth, remplacez le secret dans NasDash, vérifiez le widget, puis révoquez l'ancien client. Une sauvegarde de /app/data contient la configuration chiffrée ; protégez-la comme un secret.

Headscale

Créez une connexion Headscale dans Paramètres → Intégrations avec l’URL du serveur et sa clé API. Enregistrez-la en dernier pour que tous les widgets Tailscale l’utilisent. L’accès distant à NasDash reste une configuration réseau distincte.