Aller au contenu principal

Accès distant Tailscale

Tailscale offre un accès distant sécurisé à l'interface web de Jasper par Internet, sans aucune redirection de port ni modification du pare-feu sur le site. Lorsqu'il est activé, Jasper rejoint un réseau privé chiffré (un tailnet) et reçoit une adresse IP Tailscale privée dans la plage 100.x.y.z. Tout ordinateur ou appareil mobile connecté au même tailnet peut alors atteindre l'interface web de Jasper à cette adresse.

Prérequis​

  • Jasper dispose d'un accès Internet.
  • Une clé d'authentification Tailscale provenant de la console d'administration du tailnet. Une clé réutilisable et éphémère qui autorise l'étiquette tag:jasper est recommandée.

Inscrire Jasper​

Formulaire de configuration de l'accès à distance Tailscale

  1. Connectez-vous à l'interface web de Jasper en tant qu'administrateur.
  2. Ouvrez Système > Réseau, puis cliquez sur Accès à distance Tailscale.
  3. Cochez Activer et collez la clé d'authentification.
  4. Laissez l'étiquette d'appareil à sa valeur par défaut (tag:jasper), sauf si votre tailnet utilise une autre étiquette. Le champ Nom d'hôte du tailnet, en lecture seule, affiche le nom que Jasper utilisera sur le tailnet.
  5. Cliquez sur Enregistrer.

En quelques secondes, le panneau État affiche l'adresse IP Tailscale attribuée, et Jasper apparaît dans la console d'administration Tailscale sous son nom d'hôte. Depuis un appareil connecté au même tailnet, ouvrez un navigateur web et accédez à cette adresse, par exemple http://100.x.y.z/.

État et actions​

Panneau d'état Tailscale

Le panneau État affiche l'état courant (Connecté, Activé, non connecté, Désactivé ou Déconnecté - clé d'authentification requise), l'adresse IP Tailscale attribuée, le nom d'hôte du tailnet, les appareils du tailnet et les éventuels avertissements de santé. Cliquez sur Actualiser pour le recharger.

Les boutons d'action apparaissent selon l'état courant :

  • Déconnecter coupe la connexion mais conserve l'identité enregistrée de Jasper.
  • Connecter rétablit le tunnel après une déconnexion, en réutilisant l'identité enregistrée. Aucune clé d'authentification n'est requise.
  • Retirer l'appareil déconnecte Jasper du tailnet et arrête le service. L'état affiche alors Déconnecté - clé d'authentification requise et Connecter est masqué : la réinscription exige une nouvelle clé d'authentification et Enregistrer. Utilisez-le pour mettre Jasper hors service ou le déplacer vers un autre tailnet, et retirez aussi le nœud de la console d'administration Tailscale.
  • Décocher Activer et enregistrer coupe la connexion. Pour la rétablir, cochez Activer et enregistrez en laissant la clé vide : Jasper réutilise son identité enregistrée.

Si Jasper ne se connecte pas :

  • Vérifiez que Jasper dispose d'un accès Internet fonctionnel.
  • Vérifiez que la clé d'authentification est toujours valide et n'a pas expiré ni été révoquée.
  • Vérifiez que tag:jasper (ou l'étiquette saisie) est défini dans la politique ACL du tailnet.

Routage de sous-réseau (optionnel, avancé)​

attention

Le routage de sous-réseau n'est pas activé par défaut. Activez-le uniquement lorsque vous devez atteindre d'autres hôtes du réseau local du site à travers Jasper. Pour un simple accès distant à l'interface web de Jasper, laissez-le désactivé.

Lorsqu'il est activé, Jasper annonce son ou ses réseaux locaux au tailnet afin que d'autres appareils Tailscale puissent atteindre les hôtes situés derrière lui.

Pour l'activer :

  1. Sur la page Système > Réseau, cliquez sur Accès à distance Tailscale, puis cochez Routeur de sous-réseau.
  2. Vérifiez le champ Sous-réseaux annoncés. Il est prérempli avec le réseau local détecté (par exemple 192.168.1.0/24) ; modifiez-le ou ajoutez d'autres sous-réseaux séparés par des virgules.
  3. Cliquez sur Enregistrer.

Les routes annoncées doivent également être approuvées dans la console d'administration Tailscale avant que d'autres appareils puissent les utiliser.

Accès BACnet​

Le routage de sous-réseau ne transmet que le trafic unicast : les diffusions (broadcasts) ne traversent pas le tailnet. La découverte BACnet/IP (Who-Is / I-Am) repose sur des diffusions locales : un client BACnet distant peut donc joindre les équipements du sous-réseau annoncé en unicast, mais une découverte simple ne trouve aucun équipement.

Pour découvrir et parcourir les équipements BACnet à distance, enregistrez le client distant comme équipement étranger (foreign device) auprès d'un BBMD (BACnet Broadcast Management Device) présent sur le réseau BACnet/IP du site. Le BBMD relaie alors les diffusions au client distant en unicast, qui transite par la route de sous-réseau.

Serveur de connexion (optionnel, avancé)​

attention

Laissez cette option désactivée sauf si le site exécute son propre serveur de contrôle. La plupart des déploiements utilisent le serveur de coordination de Tailscale et n'en ont pas besoin.

Par défaut, Jasper rejoint le serveur de coordination officiel de Tailscale. Sous Options avancées, l'URL du Serveur de connexion peut pointer Jasper vers un serveur de contrôle auto-hébergé (tel que Headscale) à la place.

  • Saisissez l'URL complète, par exemple https://headscale.example.com. Les protocoles http et https sont tous deux acceptés.
  • Laissez le champ vide pour utiliser le serveur officiel de Tailscale.
  • La clé d'authentification doit être émise par ce même serveur de contrôle.
  • Changer le serveur de connexion déconnecte Jasper et le réinscrit auprès du nouveau serveur ; fournissez donc une clé d'authentification valide lors du changement.