Generatore di walled garden
Genera regole per domini consentiti pre-autenticazione, whitelist ACL e script CLI per controller per 9 piattaforme hardware wireless enterprise.
Configura e valida walled garden per portali captive
1. Seleziona le integrazioni di servizi
2. Aggiungi domini personalizzati della struttura
Includi endpoint API personalizzati, host CDN della struttura o asset web richiesti dalla pagina iniziale.
3. Scegli il controller hardware e il formato di esportazione
Seleziona il controller wireless aziendale di destinazione per formattare le regole esatte della whitelist da CLI o dashboard.
# ==================================================================
# Cisco Meraki Dashboard - Walled Garden Allowed Domain List
# Location: Wireless > Configure > Access control > Splash page
# ==================================================================
*.aadcdn.msauth.net
*.aadcdn.msftauth.net
*.account.live.com
*.accounts.google.co.uk
*.accounts.google.com
*.accounts.youtube.com
*.api.purple.ai
*.apis.google.com
*.app.purple.ai
*.appleid.apple.com
*.appleid.cdn-apple.com
*.assets.purple.ai
*.auth.gfx.ms
*.auth.purple.ai
*.captive.purple.ai
*.cdnjs.cloudflare.com
*.challenges.cloudflare.com
*.fonts.googleapis.com
*.fonts.gstatic.com
*.googleusercontent.com
*.gsa.apple.com
*.gstatic.com
*.idmsa.apple.com
*.login.live.com
*.login.microsoftonline.com
*.logincdn.msauth.net
*.onboarding.purple.ai
*.portal.purple.ai
*.purple.ai
*.ssl.gstatic.com
*.static.cloudflareinsights.com
*.www.purple.aiNote importanti sul bypass del CNA Apple e sul rilevamento del portale captive
L'inserimento nella whitelist degli hostname di probe Apple (captive.apple.com) elimina la sovrapposizione automatica del browser Captive Network Assistant sui dispositivi Apple. Sebbene ciò consenta un'autenticazione senza interruzioni per gli utenti che ritornano in ambienti aziendali, impedisce l'apertura automatica della pagina di benvenuto sui dispositivi degli ospiti. Per le reti di visitatori standard, lasciare la probe CNA Apple non selezionata per garantire la visualizzazione immediata della richiesta di accesso.
Come funzionano i walled garden pre-autenticazione
Nelle implementazioni di WiFi per ospiti enterprise, un walled garden (elenco di controllo degli accessi pre-autenticazione) definisce le destinazioni di rete specifiche che un dispositivo non autenticato può raggiungere prima di completare l'onboarding sulla splash page. Quando un ospite si connette a un SSID per ospiti aperto o sicuro, il controller LAN wireless (WLC) o l'access point gestito in cloud inserisce il client in uno stato pre-autenticazione limitato.
Tutto il traffico web standard viene intercettato e reindirizzato all'URL di login del portale captive. Tuttavia, per le moderne splash page che offrono social login (OAuth 2.0), fatturazione con carta di credito (Stripe, PayPal), tipografia personalizzata (Google Fonts) o risorse CDN esterne, il browser del client deve scambiare dati con server di terze parti prima di ricevere la piena autorizzazione a Internet. Se uno qualsiasi di questi endpoint viene omesso dalla whitelist del walled garden nel controller, il processo di login fallisce in modo invisibile, causando finestre modali vuote o pulsanti di pagamento non funzionanti.
Matrice di confronto dei walled garden per controller wireless enterprise
| Piattaforma hardware | Meccanismo | Formato wildcard | Interfaccia di configurazione | Snooping DNS dinamico |
|---|---|---|---|---|
| Cisco Meraki MR | DNS snooping a livello di AP | *.domain.com | Dashboard Web UI / REST API | Automatico per MAC client |
| Cisco Catalyst 9800 | Parameter-Map IOS-XE | redirect-passthrough domain | CLI / Profilo WebAuth WebUI | Supportato tramite FQDN snooping |
| Aruba AOS 8 / 10 | Alias netdestination | name *.domain.com | CLI / UI di Aruba Central | Motore DPI integrato |
| Ubiquiti UniFi | Tabella di autorizzazione del gateway | *.domain.com | Impostazioni Hotspot di UniFi Network | Integrato in dnsmasq / UDM |
| Fortinet FortiGate | Oggetti indirizzo FQDN | set fqdn *.domain.com | CLI FortiOS / Captive Exempt List | Tabella di risoluzione DNS FortiGuard |
| Juniper Mist | Hostname AP inviati dal cloud | *.domain.com | Mist AI Portal / Mist API | Accelerazione hardware AP Edge |
| Ruckus SmartZone | Tabella Walled Garden WISPr | *.domain.com | WebUI SmartZone / ZoneDirector | Filtro proxy DNS a livello di AP |
Meccanica dei probe del portale captive Apple CNA e Android
Quando i dispositivi mobili si associano a un SSID non crittografato o per ospiti, il sistema operativo avvia un controllo di connettività automatico in background per determinare se il dispositivo ha un accesso a Internet illimitato o è bloccato dietro un portale captive:
- Apple iOS e macOS: invia una richiesta HTTP GET a
http://captive.apple.com/hotspot-detect.html. Se il server restituisce qualsiasi elemento diverso dall'esatto testo HTML contenente<HTML><HEAD><TITLE>Success</TITLE></HEAD><BODY>Success</BODY></HTML>, il sistema operativo apre immediatamente il browser modale Captive Network Assistant (CNA). - Google Android: invia una richiesta HTTP 204 a
http://connectivitycheck.gstatic.com/generate_204. Se l'access point intercetta la connessione e restituisce un reindirizzamento HTTP 302 o una splash page HTML, Android mostra una notifica 'Accedi alla rete WiFi' nella barra di sistema. - Microsoft Windows: contatta il Network Connectivity Status Indicator (NCSI) all'indirizzo
http://www.msftconnecttest.com/connecttest.txt, attendendosi un 200 OK con la stringaMicrosoft Connect Test.
Raccomandazione di best practice: non inserire in whitelist i domini di probe Apple o Android a meno che non si stia intenzionalmente implementando un flusso di onboarding headless senza interruzioni (come Passpoint / Hotspot 2.0). L'inserimento in whitelist di questi probe inganna il sistema operativo facendogli credere di avere una connessione Internet attiva, sopprimendo la splash screen e costringendo gli ospiti ad aprire manualmente un browser web per individuare il portale.
Proteggere i walled garden da DNS tunneling e abusi
Sebbene i walled garden siano essenziali per l'autenticazione dei visitatori, le whitelist configurate in modo errato possono esporre le reti per ospiti a vulnerabilità di sicurezza:
Limita sempre il traffico DNS non autenticato a resolver DNS aziendali affidabili o a proxy forwarder interni del controller. Consentire un DNS ricorsivo aperto nella rete pre-autenticazione permette ai malintenzionati di incanalare traffico TCP/UDP arbitrario su query DNS (Iodine / DNScat).
Evita, se possibile, ampie whitelist di wildcard di primo livello come *.amazonaws.com o *.cloudfront.net. Specifica gli hostname esatti dei bucket delle risorse (ad es. myvenue-assets.s3.amazonaws.com) per impedire la navigazione non autorizzata nello storage cloud non autenticato.
Configura le ACL della sessione pre-autenticazione per consentire solo la porta TCP 443 in uscita (HTTPS) per OAuth e processori di pagamento di terze parti, chiudendo la porta 80 non crittografata per prevenire l'hijacking della sessione man-in-the-middle sulla VLAN per ospiti.
Come configurare un walled garden pre-autenticazione per portali captive WiFi per ospiti
Istruzioni passo passo per ingegneri di rete su come generare, validare e applicare whitelist di domini consentiti tra controller LAN wireless enterprise prima dell'autenticazione dell'utente.
Seleziona le integrazioni di autenticazione richieste
Seleziona i provider di identità esterni (Google OAuth, Microsoft Entra ID, Apple ID), i gestori dei pagamenti (Stripe, PayPal), le CDN e i repository di font richiesti dalla pagina splash del portale captive.
Aggiungi domini personalizzati della struttura ed endpoint API
Inserisci eventuali FQDN personalizzati della struttura, host API dell'app mobile del cliente o asset di branding ospitati nel validatore di domini personalizzati.
Seleziona il controller wireless hardware di destinazione
Scegli il vendor hardware di destinazione (Cisco Meraki, Cisco Catalyst 9800, Aruba OS, Ubiquiti UniFi, Fortinet FortiGate, Ruckus SmartZone, Juniper Mist, Extreme Networks o Cambium cnMaestro).
Applica i comandi di configurazione generati al controller wireless
Copia lo script CLI formattato o le voci della whitelist della dashboard e applicali alla WLAN per ospiti di destinazione o al ruolo utente di pre-autenticazione.
Domande frequenti su walled garden e portali captive
Cos'è un walled garden nelle reti WiFi per ospiti e con portale captive?
Un walled garden (chiamato anche whitelist di domini consentiti o lista di controllo degli accessi di pre-autenticazione) è un ambiente di navigazione limitato imposto dagli access point wireless o dai controller LAN wireless. Prima che un visitatore non autenticato effettui l'accesso tramite la splash page del portale captive, tutto il traffico internet generale viene bloccato. Il walled garden inserisce esplicitamente in whitelist specifici nomi di dominio completamente qualificati (FQDN) e intervalli IP, come i server di hosting del portale captive, gli identity provider OAuth, i gestori dei pagamenti e i font web, consentendo alla splash page e agli script di autenticazione di funzionare senza concedere l'accesso completo alla rete.
Come funziona il DNS snooping sugli access point enterprise per i walled garden?
I moderni access point enterprise (come Cisco Meraki, Aruba e Juniper Mist) utilizzano il DNS snooping dinamico anziché liste di controllo degli accessi basate su IP statici. Quando un client non autenticato invia una query DNS per un dominio presente nella whitelist del walled garden (ad es. accounts.google.com), l'access point intercetta la risposta DNS dal resolver a monte. L'AP analizza i record A o AAAA restituiti e installa temporaneamente regole dinamiche di autorizzazione del firewall a Livello 3 per tali indirizzi IP specifici associati all'indirizzo MAC del client, facendole scadere allo scadere del TTL del DNS.
Perché l'inserimento in whitelist del CNA di Apple interrompe il popup automatico della splash page?
I dispositivi Apple rilevano le reti captive inviando una sonda HTTP a captive.apple.com al momento della connessione a un SSID. Se il dispositivo riceve la risposta 'Success' prevista, presuppone che sia disponibile un accesso a internet completo e non apre l'overlay del browser Captive Network Assistant (CNA). L'inserimento in whitelist di captive.apple.com consente a questa sonda di passare senza essere intercettata, ingannando iOS e macOS e facendo credere loro che il dispositivo disponga di connettività completa, sopprimendo così la richiesta automatica di login modale.
Quali domini devono essere inseriti in whitelist per il social login tramite Google, Apple e Microsoft?
Per l'autenticazione Google, inserire in whitelist accounts.google.com, ssl.gstatic.com, apis.google.com e gstatic.com. Per Microsoft Entra ID / 365, inserire in whitelist login.microsoftonline.com, login.live.com, aadcdn.msftauth.net e aadcdn.msauth.net. Per Sign in with Apple, inserire in whitelist appleid.apple.com e appleid.cdn-apple.com. Poiché i provider OAuth utilizzano di frequente reti di distribuzione dei contenuti (CDN) e sottodomini, si raccomanda l'uso di caratteri jolly (*.domain.com) sui controller che lo supportano.
Quali sono le cause dei loop di reindirizzamento e delle schermate bianche nel portale captive?
I loop di reindirizzamento e le schermate bianche si verificano in genere a causa di tre problemi: 1) Asset CDN o JavaScript mancanti nel walled garden (ad es. fonts.gstatic.com o js.stripe.com bloccati prima del caricamento), 2) Reindirizzamento HTTPS rigido in cui il controller tenta di intercettare una richiesta HTTPS senza un certificato SSL valido sul gateway, oppure 3) Domini di callback OAuth mancanti in cui l'identity provider tenta il reindirizzamento verso l'host del portale ma viene bloccato dalle regole del firewall di pre-autenticazione.
In che modo Purple semplifica la gestione dei walled garden nelle reti multivendor?
Purple gestisce un'infrastruttura cloud Anycast ad alta disponibilità con architetture di dominio a origine singola consolidate. Centralizzando l'hosting del portale captive, i motori di autenticazione e le integrazioni CRM dietro endpoint FQDN unificati (come onboarding.purple.ai), Purple riduce al minimo il numero di regole sui domini esterni richieste sui controller wireless, riducendo gli errori di configurazione ed eliminando le disconnessioni nella fase di pre-autenticazione.
Strumenti correlati di diagnosi di rete e WiFi
Stai implementando il WiFi per ospiti enterprise su reti multi-vendor?
Elimina la complessa manutenzione del walled garden, gli avvisi SSL e i timeout del portale. Purple si integra in modo nativo con Cisco Meraki, Catalyst 9800, Aruba, UniFi, Fortinet, Mist e Ruckus per offrire portali captive ad alta disponibilità, onboarding Passpoint e analisi comportamentali degli ospiti.
Book a 20-min demoNetforge Network Multi-Tool
Run offline network health checks, path analysis, and latency diagnostic scans directly from your desktop.
Download Multi-Tool