Integration von BAS-IP IP-Türsprechanlagen in bestehende Gebäudesysteme

An einem einzigen Standort arbeitet das Managementteam möglicherweise in einer Immobilienverwaltungsplattform, das Sicherheitsteam in einem Zugangskontrollsystem und die Bewohner in einer separaten mobilen App. Wenn das Türzugangs- (Intercom-) System ein weiterer isolierter Teil des Gebäudes bleibt, müssen dieselben Benutzer, Zugriffsrechte und Ereignisse an mehreren Stellen verwaltet werden. BAS-IP kann in die bestehende digitale Infrastruktur des Gebäudes integriert werden. Die Immobilienverwaltungsplattform kann die operative Hauptschnittstelle für das Personal bleiben, während die bestehende Bewohner-App um Intercom-, Video- und Türöffnungsfunktionen erweitert werden kann. Es gibt vier Hauptansätze: Interoperabilität durch Standardprotokolle, BAS-IP Link API, BAS-IP Mobile SDK und BAS-IP Device API. Die richtige Wahl hängt davon ab, was integriert werden muss und wie das bestehende System funktioniert.

Was ist BAS-IP Link?

BAS-IP Link ist eine Softwareplattform zur Verwaltung verbundener BAS-IP-Geräte, Standorte und Wohnungen, Benutzer, Zugangsdaten, Anrufe und Gerätekonfigurationen. Es ist in zwei Bereitstellungsmodellen verfügbar: Link Self-Hosted, installiert auf der eigenen Serverinfrastruktur des Kunden, und Link Cloud, bereitgestellt als BAS-IP-Cloud-Dienst. Einige Integrationen funktionieren über Link, während andere direkt mit der BAS-IP-Ausrüstung kommunizieren.

Interoperabilität durch Standardprotokolle

Nicht jede Integration erfordert Softwareentwicklung. BAS-IP-Geräte unterstützen Standardprotokolle, die bereits in Telefonie-, CCTV- und Zugangskontrollsystemen weit verbreitet sind:

• SIP — die Türstation registriert sich als SIP-Client an der PBX des Kunden, sodass Anrufe an vorhandene Mobilteile und Softphones zugestellt werden können;
• RTSP — das Panel kann als Videoquelle neben den anderen CCTV-Kameras vor Ort zu einem VMS oder NVR hinzugefügt werden;
• Wiegand — der im Panel integrierte Leser kann eine Berechtigungskennung an ein Zugangskontrollsystem eines Drittanbieters weiterleiten.

Diese Szenarien werden an beiden Enden konfiguriert und erfordern keine Entwicklung gegen eine BAS-IP API oder SDK. Hinweis: Für SIP-Integrationen sollte die Kompatibilität von Audio- und Videocodecs zwischen dem Drittanbietersystem und den spezifischen BAS-IP-Geräten im Voraus geprüft werden. Beispielsweise unterstützen BAS-IP-Geräte Szenarien mit PCMA für Audio und H.264 für Video. Die aktuell unterstützte Codec-Auswahl sollte immer für das jeweilige Modell und die Firmware-Version überprüft werden. Standardprotokolle können einen Anruf, einen Videostream oder eine Berechtigungskennung übertragen, verstehen aber nicht, wer der Benutzer ist, zu welcher Wohnung er gehört oder welche Zugriffsrechte er haben sollte. Wenn die Integration mit den Daten selbst arbeiten muss — Benutzer erstellen, Zugriff gewähren oder entziehen oder Ereignisse abrufen — ist eine API oder ein SDK erforderlich.

BAS-IP Link API: Integration mit einer Immobilienverwaltungs- oder serverseitigen Plattform

Die Link API wurde für Fälle entwickelt, in denen ein Drittanbietersystem programmgesteuert mit BAS-IP Link interagieren muss: beispielsweise eine Immobilienverwaltungsplattform, ein Zugangskontrollsystem oder eine andere Unternehmensplattform, die am Standort bereits im Einsatz ist. Ein einfaches Beispiel ist der Einzug eines Bewohners. Ein Mitarbeiter erstellt das Profil des Bewohners in der bestehenden Plattform: Name, Wohnung und Kontaktdaten. Ohne Integration muss derselbe Benutzer dann ein zweites Mal manuell im Intercom-System erstellt werden. Mit der Link API können die Daten automatisch übertragen werden. Der Benutzer wird im richtigen Standort und in der richtigen Wohnung innerhalb von BAS-IP Link erstellt, von wo aus die Informationen auf die angeschlossene BAS-IP-Infrastruktur angewendet werden können. Dies ist nur ein möglicher Anwendungsfall. Über die Link API kann ein Drittanbietersystem arbeiten mit:

• Benutzern und Standortstruktur;
• Zugriffsrechten;
• dauerhaften Zugangsdaten, einschließlich Karten, Anhängern, PIN-Codes, QR-Codes, Face ID, UKEY und Kfz-Kennzeichen;
• temporären Zugangsdaten mit festgelegter Gültigkeitsdauer;
• Gästezugang und Besuchern;
• Nachrichten an Bewohner;
• virtuellen Nummern und Anrufweiterleitung;
• Remote-Gerätekonfiguration;
• Ereignissen und Protokollen.

Die genutzte genaue Funktionalität hängt von den Anforderungen des Projekts ab. Mit dieser Architektur kann die bestehende Plattform des Kunden die tägliche operative Schnittstelle für sein Personal bleiben. Aktueller Status: Serverseitige Integrationen von Drittanbietern über die Link API sind derzeit auf BAS-IP Link Self-Hosted implementiert. Die Unterstützung für BAS-IP Link Cloud befindet sich in Entwicklung und wird über ein API-Gateway bereitgestellt. Wenn das Projekt die Nutzung von Link Cloud vorsieht, sollten der erforderliche Anwendungsfall und die verfügbaren Optionen vor Beginn der Entwicklung mit BAS-IP besprochen werden.

BAS-IP Mobile SDK: Intercom-Funktionalität in Ihrer eigenen mobilen App

Das zweite häufige Szenario ist ein Unternehmen, das bereits über eine eigene mobile App für Bewohner, Mieter oder Mitarbeiter verfügt. Diese App verarbeitet möglicherweise bereits Wartungsanfragen, Zahlungen, Buchungen von Einrichtungen und Benachrichtigungen. Die Einführung einer separaten App, die nur für den Türzugang gedacht ist, kann daher unnötig sein. Das BAS-IP Mobile SDK fügt der bestehenden Anwendung über BAS-IP Link wichtige Intercom-, Türzugangs- und Zugriffsfunktionen hinzu, darunter:

• Benutzerauthentifizierung;
• ein- und ausgehende Audio- und Videoanrufe;
• Live-Videovorschau von der Türstation vor Annahme eines Anrufs;
• Push-Benachrichtigungen;
• Türöffnung;
• Anrufhistorie;
• BLE-basierter mobiler Zugriff über die UKEY-Komponente;
• den Aufzug zur Etage des Bewohners rufen.

Sowohl iOS als auch Android werden unterstützt. Der Bewohner kann einen Anruf von der Türstation direkt in der App entgegennehmen, die er bereits nutzt, eine Live-Vorschau des Besuchers vor der Annahme sehen und die Tür öffnen. Das Entwicklungsteam muss die Intercom-Anrufebene nicht von Grund auf neu erstellen. Die SIP-Kommunikation und Interaktion mit BAS-IP Link werden bereits von den bereitgestellten Komponenten übernommen; die Rolle des Partners besteht darin, diese Komponenten in seine eigene Anwendung zu integrieren. Das Mobile SDK repliziert nicht jede in der BAS-IP Link-Anwendung verfügbare Funktion. Es bietet eine definierte Reihe fertiger Funktionen. Wenn eine erforderliche Funktion nicht im SDK enthalten ist — beispielsweise das Generieren von Gast-QR-Codes —, kann der Partner diese in seiner eigenen App mithilfe direkter Link-API-Aufrufe implementieren. Aktueller Status: Mobile SDK-Integrationen werden auf BAS-IP Link Self-Hosted implementiert. Projekte, die BAS-IP Link Cloud erfordern, sollten geplant werden, nachdem das Cloud-API-Gateway verfügbar ist.

BAS-IP Device API: Direkte Integration mit der Ausrüstung

Nicht jede Integration erfordert BAS-IP Link. BAS-IP Türstationen, Innenstationen und andere unterstützte Geräte, einschließlich des Aufzugsmoduls, verfügen über eigene lokale APIs. Ein Drittanbietersystem kann daher direkt mit der Ausrüstung kommunizieren. Die Unterscheidung ist unkompliziert:

• Device API verbindet Ihr System direkt mit bestimmten BAS-IP-Geräten.
• Link API verbindet Ihr System mit BAS-IP Link, das wiederum die verbundene BAS-IP-Ausrüstung verwaltet.

Die direkte Geräteintegration eignet sich gut für ein lokales Projekt mit einer begrenzten und bekannten Auswahl an Gerätemodellen. Die Integration über Link ist in der Regel besser geeignet, wenn die Lösung verschiedene Modelle, eine größere Anzahl von Geräten oder mehrere Standorte abdeckt, da Link die Abhängigkeit der Integration von den Besonderheiten einzelner Gerätemodelle und Firmware-Versionen verringert. Der Zugriff auf die Device API ist unkomplizierter: Die Dokumentation ist öffentlich zugänglich und es ist keine Geheimhaltungsvereinbarung (NDA) erforderlich. Entwickler können sich über das BAS-IP-Entwicklerportal unter developers.bas-ip.com registrieren und ihre E-Mail-Adresse bestätigen.

Webhooks

Android-basierte BAS-IP-Türstationen unterstützen auch Webhooks. Dadurch kann ein Drittanbietersystem Ereignisse in Echtzeit empfangen, einschließlich Türöffnung, gewährter oder verweigerter Zugriff, Geräteaktualisierungen und andere im Geräteprotokoll erfasste Ereignisse. Dies ist nützlich in Smart-Building-Szenarien, in denen ein anderes System sofort auf ein Zugriffsereignis oder eine Türöffnung reagieren muss. Webhooks werden direkt an der Türstation über die Gerätekonfiguration konfiguriert. Sie werden nicht auf Linux-basierten Panels, Innenstationen oder auf Ebene von BAS-IP Link unterstützt.

Welchen Integrationsansatz sollten Sie wählen?

Sie müssen sich nicht unbedingt im Voraus für die Integrationsmethode entscheiden. In den meisten Fällen wird der richtige Ansatz klar, sobald das bestehende System und der erforderliche Anwendungsfall beschrieben wurden.

Was bringt die Integration vor Ort?

• Schnellere Ersteinrichtung: Benutzerdaten und zugehörige Parameter können aus dem System übertragen werden, in dem sie bereits gepflegt werden.
• Weniger doppelte Dateneingabe: Dieselben Informationen müssen nicht wiederholt in verschiedenen Schnittstellen eingegeben werden.
• Einheitliche operative Daten: Intercom-, Türzugangs- und Zugriffsereignisse können mit anderen Standortinformationen zusammengeführt werden.
• Vertraute Arbeitsabläufe: Das Personal kann weiterhin in den Systemen arbeiten, die es bereits kennt, während die Bewohner eine einzige Anwendung nutzen können.

Je größer der Standort, die Benutzerbasis und die Anzahl der verbundenen Systeme, desto deutlicher wird der Nutzen.

Wie funktioniert ein Integrationsprojekt?

Die Organisation beginnt mit der Beschreibung ihres bestehenden Systems und des erforderlichen Anwendungsfalls. Zum Beispiel: „Wir haben bereits eine Bewohner-App und möchten, dass die Bewohner darin Intercom-Anrufe entgegennehmen.“ BAS-IP hilft dabei, die geeignete Integrationsmethode zu ermitteln und das erwartete Ergebnis abzustimmen. Für die Link API und das Mobile SDK werden technische Materialien bereitgestellt, sobald das Projekt genehmigt und eine NDA unterzeichnet wurde. Für jeden Partner wird ein separates Projekt mit den erforderlichen Spezifikationen erstellt. Die Device API-Dokumentation ist öffentlich zugänglich. Die Integration selbst wird vom Team des Partners entwickelt. BAS-IP beantwortet technische Fragen zu seinen Produkten, hilft bei der Klärung des Integrationsszenarios und unterstützt, wenn eine auf der Dokumentation basierende Implementierung nicht das erwartete Verhalten aufweist. Wenn ein Projekt Funktionen erfordert, die derzeit nicht im Produkt verfügbar sind, kann diese Anforderung mit dem BAS-IP-Produktteam besprochen werden. Zunächst werden der Umfang der Arbeiten und der Platz im Entwicklungsplan bewertet. Eine solche Bewertung stellt keine Verpflichtung für ein bestimmtes Veröffentlichungsdatum dar. Testumgebung und Hardwarevereinbarungen werden für jedes einzelne Projekt individuell getroffen. Die fertige Lösung wird vom Partner getestet. Nach Abschluss der Entwicklung demonstriert der Partner das Ergebnis gegenüber BAS-IP oder stellt eine Beschreibung der abgeschlossenen Integration zur Verfügung. Für eine typische Integration kann rund ein Monat fokussierte Entwicklungszeit als grober Richtwert angesetzt werden. Die kalendarische Gesamtdauer ist in der Regel länger, abhängig von der Verfügbarkeit des Partnerteams und der Zeit, die benötigt wird, um sich mit dem System vertraut zu machen.

Was kostet die Integration?

BAS-IP erhebt normalerweise keine separate Gebühr für den Zugang zur Integrationsdokumentation und den Tools. BAS-IP-Produkte werden weiterhin unter ihren Standard-Lizenzbedingungen lizenziert. Zusätzliche Produktentwicklungen oder Anfragen zur Änderung der Priorität solcher Arbeiten werden separat vereinbart.

Häufig gestellte Fragen

• Was ist der Unterschied zwischen der Link API und dem Mobile SDK? Die Link API verbindet BAS-IP mit einem serverseitigen System wie einer Immobilienverwaltungsplattform oder einem Zugangskontrollsystem. Das Mobile SDK fügt einer mobilen Anwendung BAS-IP-Intercom- und Türzugangsfunktionen hinzu. Beide können im selben Projekt zusammen verwendet werden.
• Ist BAS-IP Link für jede Integration erforderlich? Nein. Viele BAS-IP-Geräte verfügen über eine eigene lokale API, sodass ein Drittanbietersystem direkt mit der Ausrüstung kommunizieren kann. Link ist in der Regel nützlicher, wenn eine Integration verschiedene Gerätemodelle, eine große Anzahl von Geräten oder mehrere Standorte abdecken muss.
• Ist eine NDA erforderlich? Für die Link API und das Mobile SDK ist eine NDA erforderlich. Die Dokumentation zur Device API ist öffentlich zugänglich.
• Werden Webhooks unterstützt? Ja, bei Android-basierten Türstationen. Ein Drittanbietersystem kann Geräteereignisse in Echtzeit empfangen. Webhooks sind nicht auf Linux-basierten Panels, Innenstationen oder auf Ebene von BAS-IP Link verfügbar.
• Kann eine Drittanbieterplattform in die BAS-IP Link Cloud integriert werden? Serverseitige Integrationen von Drittanbietern über die Link API sind derzeit auf Link Self-Hosted implementiert. Eine gleichwertige Funktionalität für Link Cloud befindet sich in der Entwicklung.
• Wie viele Entwickler werden benötigt? Für die Link API wird normalerweise ein Back-End- oder Full-Stack-Entwickler benötigt. Für das Mobile SDK ist ein Mobile-Entwickler erforderlich. Bei größeren Integrationen kann auch DevOps-Fachwissen erforderlich sein.

Möchten Sie BAS-IP in Ihr System integrieren?

Teilen Sie uns mit, welche Plattform, Anwendung oder Ausrüstung Sie bereits verwenden und was die Integration erreichen soll. Das BAS-IP-Team kann Ihnen helfen, den am besten geeigneten Ansatz zu ermitteln: Interoperabilität von Standardprotokollen, Link API, Mobile SDK, Device API oder eine Kombination aus diesen.