Salto KS-koppeling: introductie en functionele achtergrond
Wat is Salto KS?
Salto KS (Keys-as-a-Service) is het cloudgebaseerde toegangscontrolesysteem van Salto Systems. Fysieke sloten worden beheerd via de cloud en aangestuurd via een IQ online gateway — een apparaat dat de sloten op locatie met het Salto KS-platform verbindt. i-Reserve koppelt met de Salto KS-API om een reservering op afstand toegang te geven tot het juiste slot.
Hoe de koppeling werkt
- Een i-Reserve-object (product) is in de mapping gekoppeld aan een specifiek slot in de Salto-installatie.
- Zodra een reservering de ingestelde status heeft bereikt, mag het slot geopend worden. Bij de open-actie stuurt i-Reserve een open-commando naar het gemapte slot.
- De IQ online gateway ontvangt het commando en opent het fysieke slot.
- Optioneel legt i-Reserve het tijdstip van openen vast in een reserveringsveld en/of zet de reservering automatisch op een check-in-status.
De koppeling werkt dus via een open-actie per slot, niet via het oude “bezoek aanmaken / intrekken”-model. De reserveringsstatus bepaalt alleen vanaf wanneer openen is toegestaan.
De IQ-opzet en de PIN (belangrijk)
Het open-commando wordt niet met een vaste sleutel verstuurd, maar met een tijdgebonden OTP (one-time password). Die OTP wordt berekend uit drie dingen: het IQ-secret, de actieve IQ-PIN en het huidige tijdstip. Daarom moet de IQ-gateway eerst worden geactiveerd met een PIN voordat de koppeling sloten kan openen.
- IQ-secret — een geheime sleutel die bij de IQ-gateway hoort (eenmalig opgehaald uit het platform).
- IQ-PIN — een 4-cijferige code die op de IQ-gateway actief is. i-Reserve haalt de huidige PIN op (GET PIN) en zet er desgewenst een nieuwe (Set PIN). Na een geslaagde activatie toont i-Reserve “IQ is activated”.
- OTP — bij elk open-commando rekent i-Reserve een nieuwe, kortlevende code uit op basis van secret + PIN + tijd. Zonder geactiveerde IQ-PIN kan i-Reserve geen geldig commando ondertekenen en gaat de deur niet open.
Omdat de PIN deel uitmaakt van de OTP, geldt: verander je de IQ-PIN buiten i-Reserve om, dan moet je de koppeling opnieuw activeren (opnieuw GET PIN / Set PIN).
Authenticatie
De koppeling gebruikt OAuth 2.0 (password grant): je vult het Salto KS-account in (gebruikersnaam + wachtwoord). De onderliggende client-credentials van de koppeling worden op platformniveau door i-Reserve beheerd. Je kiest een omgeving (acceptance of production); elke omgeving heeft zijn eigen platform-URL’s. Het access-token wordt automatisch ververst.
Site en mapping
Een installatie heet in Salto een Site. Je vult de leesbare Site UID in (bijv. NL6254340082); i-Reserve zet die om naar het interne Site-id. In de mapping koppel je per i-Reserve-object (product) een slot uit de keuzelijst (opgehaald uit de Site). Een object zonder eigen mapping kan op een standaardslot vallen.
Tijden en tijdzones
Het tijdvenster waarbinnen openen mag, hangt samen met de reserveringstijden en de instelling tijd vooraf (minuten dat openen al mag vóór de starttijd). De koppeling rekent met UTC; zorg dat de server de juiste tijdzone als standaard heeft.
Beperkingen / aandachtspunten
- De IQ-gateway moet online zijn; zonder verbinding bereikt het commando het slot niet.
- De koppeling moet met een geactiveerde IQ-PIN zijn opgezet (anders geen geldige OTP).
- Acceptance en production zijn gescheiden omgevingen met eigen account, site en IQ; test eerst in acceptance.
- De reserveringsstatus opent niet zelf het slot — hij bepaalt alleen vanaf wanneer de open-actie is toegestaan.
