Überblick
Aegis for Ajax ist eine inoffizielle Integration, die Ajax Security Systems über die Ajax-Cloud mit Home Assistant verbindet. Sie funktioniert mit der Haupt-App von Ajax und mit Co-Branding-Apps, nutzt dasselbe App-Protokoll und normale Kontozugangsdaten statt eines Enterprise-API-Schlüssels. Sie fügt Alarmanlagen mit Nachtmodus, Gruppenscharfschaltung und optionalem PIN-Schutz hinzu, dazu Binärsensoren, Sensoren, Schalter, Tasten, Ereignisse, Firmware-Updates und eine Cloud-Live-Ansicht für Videokameras. Netzwerkdetails des Hubs wie der Status von WLAN, Ethernet und Mobilfunk werden als Sensoren bereitgestellt. Die Aktionen umfassen erzwungenes Scharfschalten, das Unscharfschalten nur des Nachtmodus, eine Panik-Taste, Einstellungen für Photo on Demand und die Verwaltung von Kontositzungen. Push-Benachrichtigungen über FCM-Zugangsdaten liefern Ereignisse in Echtzeit, und Reparaturhinweise melden Probleme damit. Die Einrichtung erfolgt in der Benutzeroberfläche und unterstützt Zwei-Faktor-Codes.
Zusammenfassung der README und des Codes von bvis/aegis-hass, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Nutzt die Cloud des Herstellers Braucht eine Internetverbindung und einen Account beim Hersteller.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Geräteauslöser Die Geräte können Automationen direkt starten.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Lichter
- Ventile
- Kameras
- Schlösser
- Alarmanlagen
- Schalter
- Sensoren
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Aegis for Ajax Anmeldung
- E-MailDie E-Mail, mit der du dich in der Ajax-App anmeldest.
- PasswortDas Passwort deines Ajax-Kontos. Home Assistant speichert nur einen Hash davon.
- App-Bezeichnung (Co-Branded App-Name)Die App, zu der dein Konto gehört: Ajax oder eine Co-Branded-App. Im README steht, wie du das herausfindest.
Zwei-Faktor-Authentifizierung
- TOTP-CodeDer 6-stellige Code aus deiner Authenticator-App.
Wird auch beim erneuten Anmelden und beim Ändern der Verbindung abgefragt.
Bereiche auswählen
- BereicheDie Bereiche (Hubs), die zu Home Assistant hinzugefügt werden. Wähle mindestens einen.
Aegis for Ajax neu authentifizieren
- PasswortDas Passwort deines Ajax-Kontos. Home Assistant speichert nur einen Hash davon.
Aegis for Ajax neu konfigurieren
- E-MailDie E-Mail, mit der du dich in der Ajax-App anmeldest.
- PasswortDas Passwort deines Ajax-Kontos. Home Assistant speichert nur einen Hash davon.
- App-LabelDie App, zu der dein Konto gehört: Ajax oder eine Co-Branded-App. Im README steht, wie du das herausfindest.
Nach der Einrichtung
- Ersatz-Abfrageintervall (Sekunden, 60-300)
- Scharfschalten erzwingen (offene Sensoren und Störungen ignorieren)
- Schaltfläche „Zu Hause scharfschalten“ anzeigenFügt dem Alarmfeld einen Modus „Zu Hause scharfschalten“ hinzu. Er entspricht dem Nachtmodus und wird hauptsächlich für Amazon Alexa oder Nabu Casa Cloud benötigt. Deaktivieren, um die doppelte Schaltfläche auszublenden, wenn Sie diese nicht verwenden.
- Ausgangs-/Eingangsverzögerung als Panel-Zustände anzeigenWenn aktiv, zeigt das Alarmpanel "arming", während der Hub die "Verzögerung beim Verlassen" eines Melders ausführt, und "pending", während eine "Verzögerung beim Betreten" läuft — beides anhand der Signale des Hubs selbst, nicht eines eigenen Timers. Melder ohne Verzögerung (Sofortalarm) sind während "arming" bereits aktiv. Automationen, die auf "armed_away" warten, lösen aus, sobald die Ausgangsverzögerung abgelaufen ist. Der Rohzustand des Hubs bleibt im Attribut "hub_state" erhalten.
- Cloud-Liveansicht für Videokameras (experimentell)Fügt für jede Ajax-Videokamera eine Liveansicht-Kamera hinzu, die wie in der App unterwegs über die Ajax-Cloud gestreamt wird. Sie funktioniert daher auch, wenn Home Assistant nicht im Netzwerk der Kamera ist. Experimentell: funktioniert eventuell noch nicht mit jeder Kamera. Jede Ansicht öffnet eine Videositzung; solange niemand zusieht, läuft nichts.
- PIN-Code für Scharf-/Unscharfschalten erforderlich
- PIN-Code
- FCM-Projekt-ID (für Push-Benachrichtigungen)
- FCM-App-ID
- FCM-API-Schlüssel
- FCM-Absender-ID
- FCM-Anmeldedaten löschen (alle vier Felder leeren)
- Ich nutze keine Push-BenachrichtigungenAktivieren, wenn Sie absichtlich ohne Push arbeiten. Blendet die wiederkehrende Erinnerung „FCM nicht konfiguriert“ und die Reparaturkarte aus. Echtzeit-Ereignisse (Türklingel, Scharf-/Unscharfschalten, Alarm, Bewegung) erreichen Home Assistant erst, wenn FCM konfiguriert ist.
- Foto-Aufbewahrung (Tage)
- Max. Fotos pro Gerät (0 = unbegrenzt)
Texte aus dem Code von bvis/aegis-hass. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- BinärsensorenNotruf-Leitstelle verbunden, Mobilfunk verbunden, Gehäusedeckel geöffnet, Externer Kontakt unterbrochen, Externer Kontaktalarm, Gehäusebohrung erkannt, Abdeckungsschutz, Fehlfunktion, Störung, Relais blockiert, Immer aktiv, Glasbruch und 15 weitere
- TastenFoto aufnehmen, Hub aktualisieren, Nach Alarm wiederherstellen, Ton testen
- KamerasLiveansicht
- EreignisseSicherheitsereignis, Türklingel, Taster
- ZahlenAlarmdauer
- AuswahlfelderSirenenlautstärke
- SensorenLeitstellenanbieter, Signalstärke, Mobilfunknetztyp, WLAN-Signalstärke, SIM-Status, IMEI, Verbindungstyp, WLAN-SSID, WLAN-IP-Adresse, Ethernet IP-Adresse, Ethernet-Gateway, Ethernet-DNS und 8 weitere
- SchalterKanal 1, Kanal 2, Überbrückung, Im Nachtmodus scharf schalten, Gong
- UpdatesFirmware
Aktionen
- Erzwungenes ScharfschaltenSystem scharfschalten und offene Sensoren sowie aktive Alarme ignorieren.Felder: Entität, Alarm-PIN
- Erzwungener NachtmodusNachtmodus aktivieren und offene Sensoren sowie aktive Alarme ignorieren.Felder: Entität, Alarm-PIN
- Nachtmodus deaktivierenBeendet den Nachtmodus, während unabhängig (abwesend) scharf geschaltete Gruppen scharf bleiben. Anders als ein vollständiges Unscharfschalten werden nur die Nachtmodus-Gruppen deaktiviert – die native Ajax-Funktion „Nachtmodus deaktivieren".Felder: Entität
- Notfalltaste drücken (SOS)Löst die Ajax-SOS-/Panik-Taste in einem Bereich aus. Ruft denselben Endpunkt auf wie die rote SOS-Taste in der offiziellen App und sendet einen Panik-Alarm an die Notrufzentrale (NSL), was in den meisten Verträgen einen sofortigen Polizeieinsatz auslöst und Verifikationsfenster umgeht. Nur für echte Notfälle verwenden. Das Feld confirm muss true sein, sonst wird der Aufruf abgelehnt.Felder: Panik bestätigen, Entität, Breitengrad, Längengrad
- Foto-auf-Anfrage-Modus festlegenAktiviert oder deaktiviert den Modus „Foto auf Anfrage“ auf einem Hub. Zwei unabhängige Kanäle lassen sich getrennt umschalten: Benutzeranfragen (ob Hub-Benutzer Fotos über die Ajax-App anfordern können) und Szenarien (ob Szenarien / Automatisierungen Aufnahmen auslösen können). Lassen Sie ein Feld leer, um den aktuellen Wert beizubehalten. Mindestens eines der beiden ist erforderlich.Felder: Benutzeranfragen, Szenarien, Entität
- Alarm-Kamerabilder aktualisierenImportiert aktuelle Alarmfotos in lokale Alben, ohne ein neues Foto aufzunehmen. Neue Alarm-Pushes werden automatisch importiert. Der manuelle Nachimport ist auf einmal alle fünf Minuten pro Space begrenzt, mit einer Verlaufsabfrage und höchstens zehn Medienstreams; vollständige lokale Alben werden übersprungen.Felder: Entity
- Kontositzungen auflistenGibt die aktiven Sitzungen des Ajax-Kontos zur manuellen Prüfung auf Abruf zurück. Dieser Dienst ruft einen internen Ajax-Endpunkt auf, der häufige Anfragen begrenzen kann; nicht in Automatisierungen regelmäßig abfragen. Die aktuell aktive Aegis-Sitzung wird als is_current markiert, wenn sie erkannt werden kann.Felder: ID des Konfigurationseintrags
- Kontositzung beendenMeldet das ausgewählte andere Gerät sofort vom Ajax-Konto ab. Die Sitzungs-ID erhalten Sie über list_client_sessions. Die Integration beendet niemals ihre eigene Sitzung.Felder: Sitzungs-ID, Beenden bestätigen, ID des Konfigurationseintrags
- Alle anderen Kontositzungen beendenMeldet alle anderen Geräte sofort vom Ajax-Konto ab. Dadurch werden andere aktive Ajax-Mobil- und Desktop-Apps abgemeldet. Die Integration beendet niemals ihre eigene Sitzung.Felder: Beenden bestätigen, ID des Konfigurationseintrags
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- SystemzustandErgänzt die System-Informationen von Home Assistant um den eigenen Status.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Hub-Netzwerksensoren beeintraechtigt, Push-Benachrichtigungen unterbrochen — dieselbe Nachricht beendet die Verbindung immer wieder, Ajax lehnt diese Version von Aegis for Ajax ab, Push-Benachrichtigungen deaktiviert - FCM-Anmeldedaten abgelehnt, Push-Benachrichtigungen nicht konfiguriert — Echtzeit-Ereignisse deaktiviert, Push-Benachrichtigungen kommen nicht an, Alarm-PIN erneut festlegen
Aus der 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…
Erscheint in Vulpo
Lichtkarte, Schnellumschalterkarte, Schlosskarte, Alarmanlagen-Karte, Apple Watch, Kontrollzentrum.Informationen
- Installationen
- 817 teilen Analysedaten
- GitHub-Sterne
- 136
- Verbindung
- Nutzt die Cloud des Herstellers
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v1.28.0,
- Kategorie
- Sicherheit und Schutz, Alarmanlagen
- Art
- Marketplace-Integration
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
aegis_ajax- Probleme
- Problem melden
