Salto KS-Verbindung: Einführung und funktionaler Hintergrund

Was ist Salto KS?

Salto KS (Keys-as-a-Service) ist das cloudbasierte Zugangskontrollsystem von Salto Systems. Physische Schlösser werden über die Cloud verwaltet und über ein IQ online gateway angesteuert — ein Gerät, das die Schlösser vor Ort mit der Salto KS-Plattform verbindet. i-Reserve verbindet sich mit der Salto KS-API, um einer Reservierung aus der Ferne Zugang zum richtigen Schloss zu geben.

Wie die Verbindung funktioniert

1. Ein i-Reserve-Objekt (Produkt) ist im Mapping mit einem bestimmten Schloss in der Salto-Installation verbunden.
2. Sobald eine Reservierung den eingestellten Status erreicht hat, darf das Schloss geöffnet werden. Bei der Öffnungsaktion sendet i-Reserve einen Öffnungsbefehl an das gemappte Schloss.
3. Das IQ online gateway empfängt den Befehl und öffnet das physische Schloss.
4. Optional erfasst i-Reserve den Zeitpunkt des Öffnens in einem Reservierungsfeld und/oder setzt die Reservierung automatisch auf einen Check-in-Status.

Die Verbindung arbeitet also über eine Öffnungsaktion pro Schloss, nicht über das alte “Besuch erstellen / entziehen”-Modell. Der Reservierungsstatus bestimmt nur, ab wann das Öffnen erlaubt ist.

Der IQ-Aufbau und die PIN (wichtig)

Der Öffnungsbefehl wird nicht mit einem festen Schlüssel gesendet, sondern mit einem zeitgebundenen OTP (One-Time-Password). Dieses OTP wird aus drei Dingen berechnet: dem IQ-Secret, der aktiven IQ-PIN und dem aktuellen Zeitpunkt. Daher muss das IQ-Gateway zuerst mit einer PIN aktiviert werden, bevor die Verbindung Schlösser öffnen kann.

• IQ-Secret — ein geheimer Schlüssel, der zum IQ-Gateway gehört (einmalig aus der Plattform abgerufen).
• IQ-PIN — ein 4-stelliger Code, der auf dem IQ-Gateway aktiv ist. i-Reserve ruft die aktuelle PIN ab (GET PIN) und setzt bei Bedarf eine neue (Set PIN). Nach erfolgreicher Aktivierung zeigt i-Reserve “IQ is activated” an.
• OTP — bei jedem Öffnungsbefehl berechnet i-Reserve einen neuen, kurzlebigen Code auf Basis von Secret + PIN + Zeit. Ohne aktivierte IQ-PIN kann i-Reserve keinen gültigen Befehl signieren und die Tür öffnet sich nicht.

Da die PIN Teil des OTP ist, gilt: Ändern Sie die IQ-PIN außerhalb von i-Reserve, müssen Sie die Verbindung erneut aktivieren (erneut GET PIN / Set PIN).

Authentifizierung

Die Verbindung verwendet OAuth 2.0 (Password Grant): Sie tragen das Salto KS-Konto ein (Benutzername + Passwort). Die zugrunde liegenden Client-Credentials der Verbindung werden auf Plattformebene von i-Reserve verwaltet. Sie wählen eine Umgebung (Acceptance oder Production); jede Umgebung hat ihre eigenen Plattform-URLs. Das Access-Token wird automatisch aktualisiert.

Site und Mapping

Eine Installation heißt in Salto eine Site. Sie tragen die lesbare Site UID ein (z. B. NL6254340082); i-Reserve wandelt diese in die interne Site-ID um. Im Mapping verbinden Sie pro i-Reserve-Objekt (Produkt) ein Schloss aus der Auswahlliste (aus der Site abgerufen). Ein Objekt ohne eigenes Mapping kann auf ein Standardschloss zurückfallen.

Zeiten und Zeitzonen

Das Zeitfenster, in dem das Öffnen erlaubt ist, hängt mit den Reservierungszeiten und der Einstellung Zeit im Voraus zusammen (Minuten, in denen das Öffnen bereits vor der Startzeit erlaubt ist). Die Verbindung rechnet mit UTC; sorgen Sie dafür, dass der Server die richtige Zeitzone als Standard hat.

Einschränkungen / Hinweise

• Das IQ-Gateway muss online sein; ohne Verbindung erreicht der Befehl das Schloss nicht.
• Die Verbindung muss mit einer aktivierten IQ-PIN eingerichtet sein (sonst kein gültiges OTP).
• Acceptance und Production sind getrennte Umgebungen mit eigenem Konto, eigener Site und eigenem IQ; testen Sie zuerst in Acceptance.
• Der Reservierungsstatus öffnet nicht selbst das Schloss — er bestimmt nur, ab wann die Öffnungsaktion erlaubt ist.