# Intégration externe - Tailscale

**URL:** <https://community.gladysassistant.com/t/integration-externe-tailscale/11223>\
**Category:** Développement\
**Tags:** integration-externe\
**Created:** [Octobre 14, 2026, 6:35 UTC](https://community.gladysassistant.com/t/integration-externe-tailscale/11223 "2026-10-14T18:35:00Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![prohand](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/prohand/32/15713_2.png) [@prohand](https://community.gladysassistant.com/u/prohand)\
**Post date:** [Octobre 14, 2026, 6:35 UTC](https://community.gladysassistant.com/t/integration-externe-tailscale/11223/1 "2026-10-14T18:35:00Z")

</div>

Bonjour à tous,

Je vous présente une nouvelle intégration externe pour Gladys : **Tailscale**.

 ![image](https://gladys-assistant-community.b-cdn.net/uploads/default/original/3X/0/b/0b23e006f4a9da3079379a6f6c6843893370d477.png)

## À quoi ça sert ?

Si vous utilisez Tailscale pour joindre votre Gladys, votre NAS ou vos serveurs à distance, cette intégration affiche l’état de votre réseau (votre « tailnet ») directement dans Gladys.

Chaque machine du tailnet devient un appareil Gladys avec :

- **En ligne** : la machine est connectée au tailnet, ou pas ;
- **Mise à jour disponible** : une version plus récente de Tailscale existe pour elle ;
- **Expiration de la clé** : le nombre de jours avant qu’elle doive se reconnecter ;
- **Expiration désactivée** : un interrupteur, comme le menu « Disable key expiry » de la console Tailscale.

## Scènes (Gladys 5.1 et plus)

Déclencheurs :

- machine en ligne ou hors ligne ;
- nouvelle machine dans le tailnet (approuvée ou en attente d’approbation) ;
- mise à jour Tailscale disponible ;
- clé bientôt expirée (délai réglable, 14 jours par défaut).

Actions :

- actualiser le tailnet ;
- lire l’état d’une machine (en ligne, IP, version, jours avant expiration…) ;
- activer ou désactiver l’expiration de la clé d’une machine.

Exemple : _quand mon NAS passe hors ligne, m’envoyer un message « {{triggerEvent.data.device\_name}} est hors ligne »_.

## Widget

Un widget **Réseau Tailscale** pour le tableau de bord : nombre de machines en ligne et hors ligne, état de l’API, et la liste des machines qui demandent votre attention (hors ligne, clé qui expire, mise à jour, en attente d’approbation). Un bouton « Actualiser » et un lien vers la console d’admin.

## Comment ça marche

- L’intégration passe par l’ **API Tailscale, dans le cloud** : rien à installer sur vos machines, et Gladys n’a pas besoin d’être dans le tailnet.
- Connexion par **jeton d’accès API** , ou mieux par **client OAuth** avec le droit `devices:core` : il n’expire jamais.
- Une seule requête par lecture, toutes les 60 secondes par défaut (réglable).
- Les jetons et secrets ne sont jamais écrits dans les logs.
- Disponible en français, anglais, allemand et espagnol.

## Installation

1. Il faut Gladys **5.1 ou plus récent**.
2. Installez **Tailscale** depuis le catalogue des intégrations de Gladys.
3. Créez un client OAuth dans la console Tailscale : [Settings → OAuth clients](https://login.tailscale.com/admin/settings/oauth), avec le droit **Devices → Core** (Read suffit pour surveiller, Write en plus pour changer l’expiration des clés depuis Gladys).
4. Collez l’ID et le secret dans l’onglet **Configuration** , puis cliquez sur **Tester la connexion**.
5. Ajoutez vos machines depuis l’onglet **Découverte**.

La documentation complète est ici : [docs/fr.md](https://github.com/prohand/gladys-tailscale/blob/main/docs/fr.md)

## Liens

- Code source : [GitHub - prohand/gladys-tailscale: Gladys external integration to view tailscale devices in Gladys · GitHub](https://github.com/prohand/gladys-tailscale)
- Signaler un bug ou proposer une idée : [Issues · prohand/gladys-tailscale · GitHub](https://github.com/prohand/gladys-tailscale/issues)

C’est la première version (1.0.0) : vos retours sont les bienvenus, ici ou sur GitHub !

_Intégration communautaire, non affiliée à Tailscale Inc._