Integrare Dormakaba con Shangrilux
Collega i sistemi di controllo accessi Dormakaba (EVOline, Ambiance, Silca) con Shangrilux tramite OSDP v2 e REST API hospitality.
Nota: Dormakaba include i brand storici Dorma, Kaba, Legic, Ilco, Silca. Questa guida copre i sistemi hotel della linea EVOline/Ambiance e i controller OSDP v2. Per sistemi legacy RS-232, contatta il supporto tecnico Dormakaba.
Prerequisiti
- Controller Dormakaba EVOline o Ambiance con firmware 5.x o superiore
- Modulo IP Gateway Dormakaba (art. 97100) per connettività REST
- Credenziali account Dormakaba Partner Portal
- Software Dormakaba Configuration Manager installato (Windows)
- Rete LAN con accesso al controller (IP statico raccomandato)
Architettura del Sistema
I sistemi Dormakaba per hotel usano una topologia a stella: il controller centrale gestisce reader/lock via bus RS-485 (OSDP v2). Il modulo IP Gateway espone un'API REST che Shangrilux usa per emettere credenziali e leggere eventi.
| Componente | Ruolo | Protocollo |
|---|---|---|
| Controller EVOline | Hub centrale, gestisce fino a 128 porte | RS-485 OSDP v2 |
| IP Gateway Dormakaba | Ponte da RS-485 a Ethernet/REST | HTTP/HTTPS + JSON |
| Reader RFID (MIFARE DESFire) | Lettura card ospite | ISO 14443-A |
| Cilindro elettronico Kaba | Accesso camere e aree comuni | Bluetooth (Legic Advant) |
| Kaba EloStar / EloStar Plus | Stanza hotel con display | RS-485 |
Configurazione OSDP v2
Abilita OSDP v2 sul Controller
In Dormakaba Configuration Manager → Controller Settings → Communication → imposta Protocol: OSDP v2. Abilita SC (Secure Channel) per comunicazioni crittografate. Genera e distribuisci le chiavi SCBK ai reader.
Configura IP Gateway REST
Connetti il Gateway IP alla rete LAN. Accedi al pannello web (http://192.168.x.x) → API Settings → REST API → Enable. Genera API Key. Configura TLS se disponibile nel firmware.
Configura in Shangrilux
Admin → Integrazioni → Dormakaba → inserisci IP Gateway, porta API (default 8080), API Key e Site Code (codice sito a 4 cifre assegnato dal controller). Shangrilux verificherà la connessione.
Configura il Card Format
Dormakaba usa formati card proprietari (Legic Advant, MIFARE DESFire). In Shangrilux specifica il formato card emesso: HID 26-bit, HID 37-bit, o Legic UID.
Emissione credenziali ospite
Per ogni prenotazione confermata, Shangrilux chiama l'API Dormakaba per creare una credenziale temporanea:
// POST /api/v1/credentials
{
"type": "mobile_key",
"holder": {
"name": "Mario Rossi",
"reference": "booking_id_abc123"
},
"validity": {
"from": "2026-06-01T14:00:00Z",
"to": "2026-06-05T11:00:00Z"
},
"access_groups": ["hotel_rooms", "pool", "gym"],
"room_numbers": ["101"]
}Mobile Key via Bluetooth
Dormakaba supporta Mobile Key tramite app Kaba Mobile. Shangrilux invia il link di invito all'ospite via email. L'ospite installa l'app, riceve la chiave digitale e apre la porta tramite Bluetooth senza contatto fisico.
Consiglio: Usa i "Time Zones" Dormakaba per limitare l'accesso degli ospiti alle aree comuni solo negli orari di apertura (es. SPA 08:00-22:00). Le Time Zone si configurano nel Controller e vengono associate agli Access Groups.
Attenzione: I sistemi Dormakaba richiedono certificazione installatore per la configurazione iniziale (EloStar, OSDP pairing). L'integrazione API può essere effettuata autonomamente solo dopo che il sistema base è già operativo.