Quand j’avais rédigé le premier guide pour connecter l’alarme Ajax à Home Assistant, il fallait jongler entre SIA, Jeedom, MQTT, topics à la chaîne… Le résultat fonctionnait parfaitement, mais il fallait aimer les usines à gaz. Aujourd’hui, changement complet de décor : des développeurs ont mis au point une intégration native Ajax Home Assistant, installable via HACS, qui discute directement avec l’API Cloud officielle Ajax. Armement, désarmement, notifications, capteurs, relais… tout remonte dans Home Assistant, en temps (presque) réel !

Installé chez moi depuis quelques jours maintenant, je vous propose de découvrir un peu plus en détail ce plugin tant attendu…

Rappel rapide sur les anciennes méthodes

Jusqu’ici, pour parler d’Ajax Home Assistant, il y avait deux approches.

La première passait par l’intégration SIA Alarm Systems de Home Assistant. L’alarme Ajax était configurée comme si Home Assistant était un centre de télésurveillance. On récupérait l’état du système, quelques infos incendie / inondation, et c’était tout. Impossible de piloter l’alarme, aucun détail sur chaque capteur. C’était surtout utile pour déclencher quelques scénarios à partir de l’état global de l’alarme, comme par exemple passer le chauffe en mode éco quand on activait l’alarme en partant de chez soi.

La seconde méthode, détaillée dans mon précédent guide, consistait à utiliser le plugin Ajax sur Jeedom, puis à republier toutes les infos dans Home Assistant via MQTT. Beaucoup plus complet, avec remontée de quasiment tous les capteurs Ajax, mais au prix d’un second serveur domotique, d’un broker MQTT, d’un mapping de dizaines de topics… Bref, très puissant, mais clairement pas à la portée de tout le monde.

Le nouveau plugin change complètement le jeu : Ajax Home Assistant devient un couple beaucoup plus simple à mettre en place.

Ce que permet le nouveau plugin Ajax Home Assistant

L’intégration ajax-hass est un composant personnalisé Home Assistant qui se connecte directement au Cloud Ajax via l’API officielle et un flux gRPC, exactement comme l’application mobile Ajax. Concrètement, votre Hub Ajax devient un “citoyen de première classe” dans Home Assistant, avec un vrai panneau d’alarme et des entités pour les capteurs, sirènes, relais, prises, etc.

Vous obtenez notamment un contrôle complet de la sécurité. Le panneau d’alarme Home Assistant permet l’armement total, le désarmement, le mode nuit, l’armement partiel par groupe, et même l’armement forcé quand certains capteurs restent ouverts. Un service dédié gère le bouton panique, que l’on peut placer sur un tableau de bord ou sur une télécommande virtuelle.

Côté remontée d’informations, le plugin expose les évènements d’armement / désarmement avec le nom de l’utilisateur Ajax, les notifications d’alarme, les détections de mouvement, les ouvertures de portes et fenêtres, les alarmes incendie ou inondation, ainsi que des capteurs “techniques” comme le niveau de batterie, la qualité de signal, la température ou l’état de la connexion. C’est très complet.

L’intégration gère plusieurs hubs Ajax dans le même Home Assistant si besoin, et l’interface est déjà traduite en français. Côté périmètre d’équipements, le développeur teste en priorité le Hub 2 Plus et les MotionCam, mais la conception repose sur l’API officielle Ajax et la communauté a déjà validé un bon nombre de claviers, sirènes, contacts d’ouverture, détecteurs incendie, etc.

On se retrouve donc avec un vrai tandem Ajax Home Assistant, capable de piloter et d’observer finement le système d’alarme, sans passer par des détours.

Préparer son installation Ajax et Home Assistant

Avant de se lancer, mieux vaut vérifier quelques prérequis.

Votre système Ajax doit être opérationnel, avec un Hub configuré dans l’application officielle, tous les détecteurs correctement ajoutés et nommés, et si possible les groupes déjà définis (rez-de-chaussée, étage, garage, etc.). Plus la configuration Ajax est propre, plus la partie Home Assistant sera agréable à exploiter.

Côté domotique, il faut un Home Assistant à jour, avec HACS déjà installé et fonctionnel, car le plugin Ajax Home Assistant est distribué comme intégration personnalisée. Vérifiez également que votre instance Home Assistant a un accès internet sortant vers les serveurs Ajax, puisque la communication passe par le Cloud via HTTPS et gRPC.

Enfin, assurez-vous que votre installation Home Assistant est correctement sécurisée : mot de passe robuste, accès distant protégé (reverse proxy, authentification, certificat TLS), et sauvegardes régulières. Intégrer son système d’alarme dans sa domotique, c’est très pratique, mais cela implique d’être un peu plus rigoureux sur la sécurité globale de l’infrastructure.

Installer l’intégration Ajax via HACS

Passons au concret. HACS est déjà en place sur votre Home Assistant ? Parfait, on peut attaquer l’installation du plugin Ajax Home Assistant.

La première étape consiste à déclarer le dépôt GitHub du plugin dans HACS. Dans l’interface de Home Assistant, ouvrez HACS, puis la section dédiée aux intégrations. Dans le coin supérieur droit, un bouton avec trois petits points donne accès au menu avancé. En choisissant l’entrée “Dépôts personnalisés”, vous pourrez ajouter un nouveau dépôt.

Dans le champ URL, saisissez l’adresse du dépôt https://github.com/foXaCe/ajax-hass, et sélectionnez “Integration” comme catégorie. Validez, puis fermez la fenêtre. La prochaine fois que vous chercherez une intégration dans HACS, “Ajax Security System” apparaîtra dans la liste.

Toujours dans HACS, lancez une recherche sur “Ajax Security System”, ouvrez la fiche correspondante, puis installez-la.

HACS va télécharger le composant ajax-hass et le placer dans le dossier custom_components/ajax de votre installation Home Assistant.

Une fois l’installation terminée, un redémarrage de Home Assistant est nécessaire pour charger la nouvelle intégration.

Ajouter l’intégration Ajax Home Assistant dans Home Assistant

Une fois Home Assistant redémarré, on peut passer à la configuration. Tout se fait depuis l’interface, sans YAML obligatoire, ce qui fait plaisir !

Ouvrez le menu “Paramètres”, puis “Appareils et services”. En bas de la page, utilisez le bouton “Ajouter une intégration”. Dans la boîte de recherche, tapez “Ajax”. Vous devriez voir apparaître “Ajax Security System” avec l’icône correspondante. Sélectionnez-la pour lancer l’assistant de configuration.

L’intégration vous demande alors les identifiants de votre compte Ajax, à savoir l’adresse e-mail et le mot de passe utilisés dans l’application officielle. Le plugin n’a pas besoin d’adresse IP locale du hub, ni de ports exotiques, tout passe par le Cloud Ajax.

Vient ensuite un réglage très pratique : le filtre de notifications. Vous pouvez choisir de ne remonter aucune notification dans Home Assistant, uniquement les alarmes d’intrusion, les événements de sécurité (armement / désarmement, alertes techniques), ou absolument tout, y compris les événements de capteurs au fil de l’eau. Si l’on prévoit de créer beaucoup d’automatisations Ajax Home Assistant, il est souvent intéressant de partir au moins sur les événements de sécurité, puis d’ajuster.

Validez, patientez quelques secondes : l’intégration contacte le Cloud Ajax, et récupère la liste de vos hubs. Ici j’ai par exemple 3 systèmes Ajax différents: je peux tous les ajouter ou sélectionner uniquement celui qui m’intéresse, comme ici « Maison » uniquement.

On valide. Le système récupère alors les groupes et tous les périphériques du ou des hubs sélectionnés, puis crée les entités correspondantes dans Home Assistant. On peut ensuite leur affecter une pièce si on le souhaite:

Ce que l’on retrouve dans Home Assistant après l’intégration

Une fois l’intégration Ajax Home Assistant en place, un petit tour dans “Appareils et services” permet de visualiser le résultat. Chaque Hub Ajax apparaît comme un appareil, avec un panneau d’alarme principal et un ensemble de capteurs et actionneurs.

Le panneau d’alarme, exposé sous forme d’entité alarm_control_panel, permet d’armer la totalité de la maison, de basculer en mode nuit, de désarmer, et d’utiliser l’armement partiel par groupe si vous l’avez configuré dans l’application Ajax. Cette entité devient le point central de vos scénarios de sécurité.

Les détecteurs de mouvement sont exposés comme des binary_sensor classiques, qui passent à l’état “on” en cas de détection et retournent à “off” au bout du délai de repos. Les contacts de portes et fenêtres remontent également sous forme de capteurs binaires, parfaits pour lancer des scénarios du type coupure du chauffage si une fenêtre reste ouverte trop longtemps.

Les détecteurs de fumée, de monoxyde ou d’inondation deviennent eux aussi des entités directement exploitables.

Les prises et relais Ajax remontent en tant qu’interrupteurs ou actionneurs, avec la possibilité de les piloter depuis Home Assistant. On peut par exemple commander des relais Ajax pour couper l’alimentation d’un appareil en cas d’incident.

Pour les plus pointilleux, toute une série de capteurs “techniques” apparaît aussi : niveau de batterie, force du signal radio, température, état de la connexion, etc. Ce sont de bonnes bases pour créer un tableau de bord “santé du système Ajax” dans Home Assistant.

Exemples de scénarios Ajax Home Assistant en situation

Une fois que tout est remonté dans Home Assistant, la partie la plus intéressante commence : les automatisations. La force de cette intégration Ajax Home Assistant, c’est justement la réactivité des remontées d’événements et la possibilité de piloter l’alarme.

Un premier scénario très utile consiste à armer automatiquement l’alarme quand tout le monde quitte la maison. On utilise la présence des personnes via l’application mobile Home Assistant ou un autre système de présence, et on lance un armement total dès que la dernière personne passe à “not_home”.

Un exemple minimaliste en YAML peut ressembler à quelque chose comme :

automation:
  - alias: "Armer Ajax quand tout le monde part"
    trigger:
      - platform: state
        entity_id: group.famille
        to: "not_home"
    action:
      - service: alarm_control_panel.alarm_arm_away
        target:
          entity_id: alarm_control_panel.ajax_alarm_home

On peut imaginer l’inverse au retour : désarmement automatique quand une première personne arrive, accompagné d’un allumage doux de quelques lumières et de la désactivation de certains scénarios de présence simulée.

Un autre cas d’usage fréquent touche au chauffage. Les capteurs d’ouverture Ajax remontés dans Home Assistant permettent de couper un chauffage électrique ou une climatisation dès qu’une fenêtre reste ouverte plus de cinq minutes, puis de réactiver le système lorsque la fenêtre est refermée. Plus besoin de multiplier les capteurs Zigbee ou Z-Wave pour travailler proprement sur les ouvertures.

Les détecteurs de mouvement Ajax peuvent aussi participer à la gestion de l’éclairage. On peut décider que, de nuit uniquement, le passage devant un détecteur dans le couloir déclenche une veilleuse ou un ruban LED au pied du lit, à faible intensité, pendant quelques minutes. L’alarme n’est pas déclenchée, mais on réutilise l’infrastructure pour du confort. Ça fait partie des petits plaisirs de la domotique bien intégrée.

Enfin, le bouton panique Ajax exposé comme entité “button” peut être placé sur un tableau de bord réservé aux adultes, voire caché derrière une carte protégée par mot de passe, et utilisé pour déclencher une alerte générale : sirènes, éclairage extérieur à 100 %, envoi de notification sur smartphone, voire appel automatique à un proche via un service tiers. Dans ce genre de scénario, mieux vaut évidemment tester en conditions réelles mais en prévenant tout le monde avant…

Sécurité et bonnes pratiques avec Ajax Home Assistant

Intégrer Ajax à Home Assistant via ce plugin veut dire que Home Assistant devient une pièce de plus dans la chaîne de sécurité. Le développeur a soigné la partie confidentialité : les identifiants sont stockés dans le système chiffré de Home Assistant, le mot de passe est haché avant envoi aux serveurs Ajax, les communications passent par TLS, et aucune donnée n’est envoyée vers des services tiers. L’intégration est open source et auditable, ce qui est rassurant pour un système de sécurité.

Il faut tout de même garder quelques réflexes. Un Home Assistant exposé n’importe comment sur internet devient une porte d’entrée vers votre système d’alarme. Il est donc crucial de verrouiller l’accès extérieur, de maintenir à jour Home Assistant comme l’intégration Ajax, et d’éviter de multiplier les comptes administrateurs. L’armement forcé, notamment, doit être utilisé avec parcimonie, car il permet d’armer le système même en présence de capteurs ouverts ou en défaut.

Dernier point : ce plugin repose sur le Cloud Ajax. Si votre connexion internet tombe ou si les serveurs Ajax sont inaccessibles, le hub continuera à protéger la maison, mais la liaison temps réel avec Home Assistant sera interrompue.

En pratique, pourquoi adopter ce plugin Ajax Home Assistant

Pour résumer, on passe d’une intégration « bricolée », dépendante d’un second système domotique, à un plugin Ajax Home Assistant dédié, maintenu, et très profond dans la gestion des équipements. L’installation se fait via HACS, la configuration uniquement depuis l’interface, et l’on obtient un contrôle complet de l’alarme, avec des remontées d’événements quasi instantanées.

Dans la vie de tous les jours, cela veut dire des scénarios plus intelligents, une vraie cohérence entre sécurité et confort, et moins de duplication de capteurs dans toute la maison. Pour les installateurs, c’est aussi un argument de poids à présenter aux clients déjà équipés en Ajax, qui rêvent d’un pilotage global de leur maison avec Home Assistant.

Et le plus agréable dans l’histoire, c’est que pour une fois, “plus complet” ne rime pas avec “plus compliqué”.