À propos
Aegis for Ajax est une intégration non officielle qui connecte Ajax Security Systems à Home Assistant via le cloud Ajax. Elle fonctionne avec l’app Ajax principale et avec les apps en marque partagée, en utilisant le même protocole d’app et les identifiants habituels du compte plutôt qu’une clé d’API d’entreprise. Elle ajoute des panneaux d’alarme avec mode nuit, armement par groupe et protection par code PIN facultative, ainsi que des capteurs binaires, des capteurs, des interrupteurs, des boutons, des événements, des mises à jour du micrologiciel et une vue en direct via le cloud pour les caméras vidéo. Les informations réseau du hub, comme l’état du Wi-Fi, de l’Ethernet et du réseau cellulaire, sont exposées sous forme de capteurs. Les actions couvrent l’armement forcé, le désarmement du mode nuit uniquement, un bouton panique, les réglages de Photo on Demand et la gestion des sessions du compte. Les notifications push via des identifiants FCM transmettent les événements en temps réel, et des avis de correction signalent les problèmes qui les concernent. La configuration se fait dans l’interface, avec prise en charge des codes à deux facteurs.
Résumé automatique du README et du code de bvis/aegis-hass, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Utilise le cloud du fournisseur Nécessite une connexion internet et un compte chez le fournisseur.
Détection automatique Home Assistant la repère sur le réseau et propose de l’ajouter.
Déclencheurs d’appareil Ses appareils peuvent lancer des automatisations directement.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Lumières
- Vannes
- Caméras
- Serrures
- Alarmes
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Connexion Aegis for Ajax
- Adresse e-mailL'e-mail avec lequel vous vous connectez à l'app Ajax.
- Mot de passeLe mot de passe de votre compte Ajax. Home Assistant n'en garde qu'un hash.
- Libellé de l'application (nom de l'app co-branded)L'app à laquelle appartient votre compte : Ajax ou une app co-branded. Voir le README en cas de doute.
Authentification à deux facteurs
- Code TOTPLe code à 6 chiffres de votre app d'authentification.
Également demandé lors d’une nouvelle connexion au compte et lors d’une modification de la connexion.
Sélectionner les espaces
- EspacesLes espaces (hubs) à ajouter à Home Assistant. Choisissez-en au moins un.
Réauthentifier Aegis for Ajax
- Mot de passeLe mot de passe de votre compte Ajax. Home Assistant n'en garde qu'un hash.
Reconfigurer Aegis for Ajax
- E-mailL'e-mail avec lequel vous vous connectez à l'app Ajax.
- Mot de passeLe mot de passe de votre compte Ajax. Home Assistant n'en garde qu'un hash.
- Label de l'applicationL'app à laquelle appartient votre compte : Ajax ou une app co-branded. Voir le README en cas de doute.
Après la mise en place
- Intervalle d'interrogation de secours (secondes, 60-300)
- Armement forcé (ignorer capteurs ouverts et dysfonctionnements)
- Afficher le bouton « Armer à la maison »Ajoute un mode Armer à la maison au panneau d'alarme. Il reproduit le mode Nuit et n'est nécessaire que pour Amazon Alexa ou Nabu Casa Cloud. Désactivez-le pour masquer le bouton en double si vous ne les utilisez pas.
- Afficher les délais de sortie / d'entrée comme états du panneauLorsque cette option est active, le panneau d'alarme affiche "arming" pendant que la centrale exécute le "Délai de sortie" d'un détecteur et "pending" pendant un "Délai d'entrée", tous deux pilotés par les signaux de la centrale elle-même, pas par une minuterie de notre part. Les détecteurs sans délai (alarme instantanée) sont déjà actifs pendant "arming". Les automatisations qui attendent "armed_away" se déclencheront à la fin du délai de sortie. L'état brut de la centrale reste dans l'attribut "hub_state".
- Vue en direct via le cloud pour les caméras vidéo (expérimental)Ajoute une caméra de vue en direct pour chaque caméra vidéo Ajax, diffusée via le cloud Ajax comme le fait l'application hors du domicile, ce qui fonctionne aussi lorsque Home Assistant n'est pas sur le réseau de la caméra. Expérimental : peut ne pas encore fonctionner avec toutes les caméras. Chaque visionnage ouvre une session vidéo ; rien ne tourne tant que personne ne regarde.
- Exiger un code PIN pour armer/désarmer
- Code PIN
- ID de projet FCM (pour les notifications push)
- ID d'application FCM
- Clé API FCM
- ID d'expéditeur FCM
- Supprimer les identifiants FCM (efface les quatre champs)
- Je n'utilise pas les notifications pushActivez si vous fonctionnez volontairement sans push. Masque le rappel récurrent « FCM non configuré » et la carte de réparation. Les événements en temps réel (sonnette, armement/désarmement, alarme, mouvement) n'atteindront Home Assistant qu'une fois FCM configuré.
- Rétention des photos (jours)
- Max photos par appareil (0 = illimité)
Textes issus du code de bvis/aegis-hass. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesConnexion télésurveillance, Réseau cellulaire connecté, Couvercle ouvert, Contact externe ouvert, Alerte contact externe, Perçage du boîtier détecté, Anti-masquage, Dysfonctionnement, Interférence, Relais bloqué, Toujours actif, Bris de verre et 15 autres
- BoutonsPrendre une photo, Actualiser le hub, Restaurer après alarme, Tester le son
- CamérasVue en direct
- ÉvénementsÉvénement de sécurité, Sonnette, Bouton
- NombresDurée de l'alarme
- SélecteursVolume de la sirène
- CapteursSociété de télésurveillance, Intensité du signal, Type de réseau mobile, Niveau de signal Wi-Fi, État de la carte SIM, IMEI, Type de connexion, SSID Wi-Fi, Adresse IP Wi-Fi, Adresse IP Ethernet, Passerelle Ethernet, DNS Ethernet et 8 autres
- InterrupteursCanal 1, Canal 2, Contournement, Armer en mode nuit, Carillon
- Mises à jourMicrologiciel
Actions
- Armement forceArmer le systeme en ignorant les capteurs ouverts et les alarmes actives.Champs : Entité, Code PIN de l’alarme
- Mode nuit forceActiver le mode nuit en ignorant les capteurs ouverts et les alarmes actives.Champs : Entité, Code PIN de l’alarme
- Désarmer le mode nuitQuitte le mode nuit en laissant armés les groupes armés indépendamment (mode absent). Contrairement à un désarmement complet, seuls les groupes en mode nuit sont désactivés — l'opération native Ajax « désarmer le mode nuit ».Champs : Entité
- Appuyer sur le bouton panique (SOS)Déclenche le bouton SOS / panique Ajax sur un espace. Appelle le même endpoint que le bouton SOS rouge de l'application officielle et envoie une alarme panique au centre de télésurveillance (CRA), ce qui, dans la plupart des contrats, déclenche une intervention policière immédiate sans fenêtre de vérification. À n'utiliser qu'en cas d'urgence réelle. Le champ confirm doit être à true sinon l'appel est rejeté.Champs : Confirmer la panique, Entité, Latitude, Longitude
- Définir le mode Photo à la demandeActive ou désactive le mode Photo à la demande sur un hub. Deux canaux indépendants peuvent être commutés séparément : les demandes des utilisateurs (si les utilisateurs du hub peuvent demander des photos depuis l'application Ajax) et les scénarios (si les scénarios / automatisations peuvent déclencher des captures). Laissez un champ vide pour conserver sa valeur actuelle. Au moins l'un des deux est requis.Champs : Demandes des utilisateurs, Scénarios, Entité
- Actualiser les images des caméras d’alarmeImporte les photos d’alarme récentes dans des albums locaux sans prendre de nouvelle photo. Les nouvelles alarmes push sont importées automatiquement. Le rattrapage manuel est limité à une fois toutes les cinq minutes par espace, avec une requête d’historique et au maximum dix flux multimédias ; les albums locaux déjà complets sont ignorés.Champs : Entity
- Lister les sessions du compteRenvoie à la demande les sessions actives du compte Ajax pour une inspection manuelle. Ce service appelle un point de terminaison interne d'Ajax qui peut limiter les requêtes fréquentes ; ne l'interrogez pas périodiquement dans des automatisations. La session Aegis actuellement active est marquée is_current lorsqu'elle peut être identifiée.Champs : ID de l'entrée de configuration
- Fermer une session du compteDéconnecte immédiatement l'autre appareil sélectionné du compte Ajax. Obtenez son ID de session via list_client_sessions. L'intégration ne ferme jamais sa propre session.Champs : ID de session, Confirmer la fermeture, ID de l'entrée de configuration
- Fermer toutes les autres sessions du compteDéconnecte immédiatement tous les autres appareils du compte Ajax. Cela déconnecte les autres applications Ajax mobiles et de bureau actives. L'intégration ne ferme jamais sa propre session.Champs : Confirmer la fermeture, ID de l'entrée de configuration
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
- État du systèmeAjoute son état aux informations système de Home Assistant.
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Capteurs reseau du hub degrades, Notifications push interrompues — le même message coupe la connexion à chaque fois, Ajax rejette cette version d'Aegis for Ajax, Notifications push desactivees - identifiants FCM rejetes, Notifications push non configurees — evenements temps reel desactives, Les notifications push n'arrivent pas, Saisissez à nouveau le PIN de l'alarme
Extrait du README
Disclaimer: This is an unofficial third-party integration and is not affiliated with, endorsed by, or supported by Ajax Systems. Use at your own risk. This integration communicates with Ajax Systems servers using the same protocol as the official mobile app. Ajax Systems may change their API at any time, which could break this integration without notice.
Aegis is a Home Assistant custom integration for Ajax Security Systems — works with any co-branded Ajax app (Protegim, ADT, G4S, and many more).
- Alarm Control Panel: Arm away, disarm, night mode, group arming with PIN code support. When the space is in group / zone mode, per-group panels are created and react to FCM push events instantly —…
- Force Arm Services: aegis_ajax.force_arm and aegis_ajax.force_arm_night to arm ignoring open sensors
- Binary Sensors: Door open/close, motion detection, smoke, steam (FireProtect 2 chamber discriminator), leak, tamper, CO, heat, glass break, vibration, tilt (DoorProtect Plus accelerometer), CRA…
- Hub Network: Real-time hub network data — ethernet/wifi/gsm connection status, Wi-Fi SSID and signal strength, IP addressing, cellular signal strength and network type, power supply status
- Sensors: Battery level, temperature, humidity, CO2, signal strength, GSM type (2G/3G/4G), Wi-Fi signal level, Wi-Fi SSID, Wi-Fi IP, IMEI, Ethernet IP/gateway/DNS, cellular signal/network, connection…
S’affiche dans Vulpo :
carte Lumière, carte Bascule rapide, carte Serrure, carte Panneau d’alarme, Apple Watch, centre de contrôle.Informations
- Installations
- 817 partagent leurs statistiques
- Étoiles GitHub
- 136
- Connexion
- Utilise le cloud du fournisseur
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v1.28.0,
- Catégorie
- Sécurité et protection, Systèmes d’alarme
- Type
- Intégration de la Marketplace
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
aegis_ajax- Problèmes
- Signaler un problème
