Collegare Captive Portal alla console UniFi

Per autorizzare gli ospiti, Captive Portal deve poter parlare con la tua console UniFi. Servono tre cose: una chiave API, un port forwarding verso la console e i dati della sede nel pannello.

1. Crea la chiave API in UniFi Network

1. In UniFi Network apri Integrations dalla barra laterale.

2. Premi Create New API Key.

3. Dai un nome riconoscibile, ad esempio captive-portal, e in Expiry scegli Never Expires.

4. Premi Create e copia la chiave: ti servirà tra poco nel pannello di Captive Portal.

UniFi Network → Integrations → Create New API Key

2. Configura il port forwarding verso la console

Il nostro server raggiunge la console via HTTPS. Sul router o firewall della sede crea un port forwarding:

3. Collega la sede in Captive Portal

1. Nel pannello apri Sedi e scegli la sede, oppure creane una nuova.

2. Nella sezione Controller UniFi imposta Modalità su UniFi reale.

3. In Host / IP inserisci l’indirizzo pubblico della sede con la porta esterna, ad esempio https://203.0.113.10:20443.

4. In API key incolla la chiave creata in UniFi.

5. Se la console usa il suo certificato autofirmato (è il caso più comune con un indirizzo IP), togli la spunta da Verifica certificato TLS.

6. Premi Salva.

Sezione Controller UniFi della sede

Esegui il test e scegli il Site

1. Nel riquadro Test connessione premi Esegui test.

2. Se la connessione riesce, vedi l’elenco dei Site UniFi della console: clicca quello giusto per compilare il campo Site.

3. In Nome sito UniFi (URL) lascia default, a meno che il tuo site UniFi abbia un altro nome breve.

4. Premi Salva.

Se il test non riesce

Quando il test riesce, passa alla configurazione dell’hotspot: Configurare l’hotspot UniFi per Captive Portal.