[Intégration] Synology SRM Plus : tout ce que sait votre routeur Synology dans Home Assistant (RT2600ac, appel à testeurs)

Home Assistant - Tutoriels & Partages Intégration
1

Bonjour à tous,

Je partage une intégration personnalisée pour les routeurs Synology (SRM), que j'ai développée et testée sur un RT2600ac (SRM 1.3.2).

Pourquoi une intégration de plus ?

L'intégration native synology_srm ne fait qu'une chose : lister les appareils connectés. Moi, je voulais le routeur lui-même : sa santé, son vrai débit, son Wi-Fi, ses ports, la sécurité, le contrôle parental. Elle cohabite avec l'intégration native (domaine différent) et se configure entièrement depuis l'interface (pas de YAML).

Elle est en lecture seule : aucune action n'est envoyée au routeur (pas de blocage, pas de réglage modifié).

Ce qu'elle remonte

  • Routeur : état, durée de fonctionnement, firmware, débit réel (le trafic accéléré par le matériel est compté, contrairement aux compteurs d'interface), CPU, mémoire, ports WAN/LAN (état et vitesse), utilisation du disque USB.
  • Clients : un capteur par connexion (Wi-Fi 2,4G, Wi-Fi 5G, filaire) dont les attributs listent chaque appareil (IP, signal, débit négocié, SSID, type, trafic…), les clients hors ligne avec leur dernière connexion, et en option des entités de présence pour les clients de votre choix.
  • Wi-Fi : canal, débit, signal moyen et nombre de clients par bande.
  • Sécurité : menaces détectées (Threat Prevention), nouveaux appareils, sessions d'administration, IP bloquées par le blocage automatique, redirections de ports, et des alertes si l'interface d'administration est joignable depuis Internet ou si quelqu'un s'est connecté de l'extérieur.
  • Contrôle d'accès : liste de blocage système Wi-Fi, filtres MAC personnalisés, appareils bloqués.
  • Safe Access (contrôle parental) : par profil, ses appareils, le temps sur internet (24 h), l'état et les plages « bloqué en ce moment ».

Cinq cartes prêtes à l'emploi

Routeur, clients, protection contre les menaces, contrôle d'accès, Safe Access. Elles se chargent toutes seules (pas de ressource à ajouter), suivent la langue de Home Assistant et se placent avec une seule ligne de YAML, par exemple type: custom:synology-srm-router-card.

(Captures avec des données d'exemple neutres.)

Carte routeur
Carte routeur, détails
Carte clients
Protection contre les menaces
Contrôle d'accès
Safe Access

Installation

  1. HACS → ⋮ → Dépôts personnalisés → ajouter https://github.com/infernalK/ha-synology-srm-plus, catégorie Intégration.
  2. Installer Synology SRM Plus, redémarrer Home Assistant.
  3. Paramètres → Appareils et services → Ajouter une intégration → Synology SRM Plus, avec un compte administrateur du routeur (un compte dédié est préférable) et le port 8001.

Une demande d'ajout à la liste officielle de HACS est en cours (hacs/default#12363).

Mes limites, et pourquoi je cherche des testeurs

Je n'ai qu'un seul routeur. Les modèles et les versions de SRM n'exposent pas les mêmes API : l'intégration lit la liste de ce que votre routeur propose et ne crée que les entités correspondantes, sans erreur pour le reste. Mais je ne peux pas garantir ce que je n'ai pas vu, par exemple sur un RT6600ax, un WRX560, un MR2200ac, en mode routeur (le mien est en mode bridge) ou en mesh.

Si vous avez un routeur Synology, un retour même rapide m'aide :

  • Quelles entités apparaissent, lesquelles manquent ou affichent des valeurs bizarres ?
  • Joignez le fichier de diagnostic (Paramètres → Appareils et services → Synology SRM Plus → ⋮ → Télécharger les diagnostics). Il liste les API de votre routeur et les données brutes, avec adresses, noms et identifiants masqués.
  • Facultatif : le service synology_srm_plus.explore_api cartographie ce que votre routeur sait faire (en lecture seule, quelques minutes, journal masqué).

Quelques réserves connues : certaines unités ne sont pas documentées par Synology (le sens de rx/tx du débit du routeur, l'échelle du signal Wi-Fi), et la dernière connexion d'un appareil hors ligne n'est connue qu'à partir de l'installation (le routeur ne la donne pas).

Confidentialité

L'API de SRM transmet le compte et le mot de passe dans l'URL. L'intégration les masque dans ses propres messages et dans les journaux de urllib3, ne journalise pas la trace d'une connexion échouée, et masque adresses, adresses MAC, noms et secrets dans le fichier de diagnostic. Tout est lu en local, rien ne sort de chez vous.

Liens

Je suis preneuse de tous les retours, bons ou mauvais. Merci d'avance !

2

Bonsoir @MissK1980
Merci pour cette intégration, il y beaucoup de paramètres remontés depuis le routeur (RT 2600ac pour mon cas). Je n'utilise pas Safe Access. J'utilise le serveur DNS Synology, implanté dans le routeur.
S'agissant du WiFi je dispose d'un répéteur MR2200ac mais je ne le vois pas dans les cartes. Ce serait bien d'avoir un diagnostique de fonctionnement de cet appareil.
Je tiens à jour dans le routeur une liste d'IP indésirables par un script exécuté 2 fois par jour. C'est bien d'avoir le nombre d'IP bloquées dans la carte Contrôle d'Accès, toutefois avoir un début de la liste des IP bloquées ne m'est pas vraiment utile sur la carte. Est-il possible de supprimer ce début de listing?
Merci encore pour ces cartes.
Audio

3

Bonjour @Audio, et merci pour votre retour !

Safe Access. Vous avez raison, c'était inutile si vous ne l'utilisez pas. J'ai ajouté une option « Utiliser Safe Access (contrôle parental) » dans Configurer sur l'intégration. Quand elle est décochée, l'intégration ne fait plus les appels Safe Access et supprime les entités correspondantes. Elle sera disponible dans la prochaine version.

Liste des IP bloquées. Je vais ajouter une option pour ne plus afficher la liste dans la carte Contrôle d'accès. Le compteur restera affiché. Pour bien régler cela, pouvez-vous me dire :

  • environ combien d'IP contient votre liste (dizaines, centaines, milliers) ?
  • si vous préférez masquer la liste entièrement ou n'en garder que les premières.

Répéteur MR2200ac. Je ne sais pas encore si le MR2200ac est visible via l'API du routeur. Cela dépend de la façon dont il est relié :

  • S'il est déclaré comme point Wi-Fi du maillage dans SRM (Centre réseau / Wi-Fi Connect), ses informations sont normalement déjà lues. Il me manquerait seulement de l'afficher dans une carte.
  • S'il est en mode répéteur ou pont sans maillage, il n'apparaît probablement pas dans l'API, et je ne pourrai rien faire sans trouver un autre point d'accès.

Pour trancher, pourriez-vous :

  1. Me dire dans quel mode il est configuré dans SRM.
  2. Chercher dans Outils de développement → États de Home Assistant les entités contenant node_status, uptime_1 ou model_1, et me dire si elles existent.
  3. Joindre le fichier de diagnostic de l'intégration (Paramètres → Appareils et services → Synology SRM Plus → ⋮ → Télécharger les diagnostics). Les adresses et identifiants y sont masqués, mais relisez-le avant de le poster.

Avec ces éléments, je pourrai savoir si une carte « nœuds » est faisable. Merci encore !

4

Bonjour MissK1980,

C'est très bien de laisser le choix d'utiliser ou non Safe Access lors de la configuration. Moi je ne l'utilise pas mais d'autres oui.
Liste des IP bloquées: je tiens un compte du résultat des scripts depuis le mois de mars, la moyenne journalière oscille entre 55000 et 80000. Vu le nombre mieux vaut à mon avis masquer toute la liste et ne garder que le nombre d'IP bloquées comme s'est actuellement indiqué.
Répéteur MR 2200ac: il apparait bien dans ma page WiFi Connect > Point d'accès Wi-Fi et je l'ai identifié dans le fichier configuration json sous l'entrée suivante:
"mesh_node": "MR2200ac-N07ZE0".
Il est configuré en répéteur du routeur. Je ne peux joindre le fichier de diagnostique le forum n'accepte que les images en téléversement.
Je n'ai pas trouvé les entités node_status, uptime_1 ou model_1 dans les Etats du routeur en page Paramètres > Outils de HA.

A bientôt