Integrare Assa Abloy Aperio e Vaka con Shangrilux
Collega sistemi Assa Abloy Aperio (wireless) e Vaka Connect con Shangrilux per controllo accessi hotel enterprise.
Nota: Il gruppo Assa Abloy include: Yale, HID Global, Abloy, Mul-T-Lock, Medeco, Sargent, ASSA, Adams Rite. Questa guida copre Aperio (sistema wireless) e Vaka (piattaforma cloud hospitality). Per Yale, consulta la guida dedicata.
Prerequisiti
- Hardware Aperio: Communication Hub (AH40) o online controller ACX/C10 con modulo Aperio
- Firmware ACX aggiornato (versione 3.x o superiore per REST API)
- Licenza Aperio IP Gateway Software
- Per Vaka: account Assa Abloy Hospitality Operations, contratto partner
- Certificato SSL per comunicazioni sicure
Architettura Aperio Wireless
Aperio usa 2,4 GHz wireless proprietario. I lock comunicano con gli hub AH40 (raggio 20-30m), che a loro volta si connettono all'ACX Controller via Ethernet. Il controller espone API REST per Shangrilux.
Configura l'ACX Controller
Accedi all'interfaccia web ACX (https://IP-ACX/acx-web/) → Configuration → REST API → Enable. Crea un account API con ruolo "Integration". Annota API Key e URL base.
Discovery dispositivi Aperio
GET /api/v2/doors → ritorna lista porte con door_id, nome, stato (locked/unlocked/unknown), livello batteria wireless.
Configura in Shangrilux
Admin → Integrazioni → Assa Abloy Aperio → inserisci URL ACX, API Key, Site ID. Seleziona le porte da gestire.
Gestione credenziali MIFARE DESFire
Aperio usa card MIFARE DESFire EV3. Shangrilux genera credenziali tramite HID OEM encoding o direttamente tramite ACX:
// POST /api/v2/credentials — Crea credenziale ospite
{
"type": "card",
"format": "mifare_desfire",
"holder": {
"name": "Ospite Verdi",
"external_id": "booking_xyz789"
},
"access_rules": [
{ "door_id": "door_101", "schedule": "hotel_guest" },
{ "door_id": "door_pool", "schedule": "pool_hours" }
],
"valid_from": "2026-06-01T14:00:00Z",
"valid_until": "2026-06-05T11:00:00Z"
}Mobile Key via HID Mobile Access
Assa Abloy offre HID Mobile Access per chiavi digitali Bluetooth. L'ospite riceve un invito email, installa HID Mobile Access, e apre le porte con lo smartphone o Apple Watch.
Piattaforma Vaka Connect (Hospitality Cloud)
Vaka Connect è la piattaforma cloud Assa Abloy dedicata all'hospitality. Offre PMS integration nativa, mobile key, keyless check-in e reporting avanzato. L'integrazione con Shangrilux avviene tramite webhook bidirezionali.
Attenzione: L'integrazione Aperio richiede che il firmware ACX sia aggiornato. Controller con firmware 2.x non supportano REST API. Contatta il tuo rivenditore Assa Abloy per l'aggiornamento firmware prima di procedere.