配置与验证强制门户围墙花园
1. 选择服务集成
2. 添加自定义场所域名
包含 Splash 页面所需的自定义 API 端点、场所 CDN 主机或 Web 资源。
3. 选择硬件控制器和导出格式
选择目标企业无线控制器,以生成精确的 CLI 或仪表板白名单规则。
# ==================================================================
# 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.ai关于 Apple CNA 绕过与强制门户检测的重要说明
将 Apple 探测主机名列入白名单(captive.apple.com)可抑制 Apple 设备上 Captive Network Assistant 浏览器浮层的自动弹出。虽然这允许企业环境中的回头访客实现无缝身份验证,但它会阻止 Splash Page 在访客设备上自动打开。对于标准的访客网络,请保持取消选中 Apple CNA 探测,以确保立即显示登录提示。
认证前围墙花园的工作原理
在企业级访客 WiFi 部署中,围墙花园(认证前访问控制列表)定义了未经认证的设备在完成 Splash Page 引导接入前允许访问的具体网络目的地。当访客连接到开放或安全的访客 SSID 时,无线局域网控制器 (WLC) 或云管理 AP 会将客户端置于受限的认证前状态。
所有标准 Web 流量都会被拦截并重定向到强制门户登录 URL。然而,对于包含社交登录 (OAuth 2.0)、信用卡计费 (Stripe, PayPal)、自定义字体 (Google Fonts) 或外部 CDN 资源的现代 Splash Page,客户端浏览器必须在获得完整互联网授权之前与第三方服务器交换数据。如果控制器的围墙花园白名单中遗漏了其中任何端点,登录过程就会无声失败,导致弹窗显示空白或结账按钮失效。
企业级无线控制器围墙花园对比矩阵
| 硬件平台 | 机制 | 通配符格式 | 配置界面 | 动态 DNS 窥探 |
|---|---|---|---|---|
| Cisco Meraki MR | AP 级 DNS 窥探 | *.domain.com | Dashboard Web UI / REST API | 按客户端 MAC 自动处理 |
| Cisco Catalyst 9800 | IOS-XE Parameter-Map | redirect-passthrough domain | CLI / WebUI WebAuth 配置文件 | 支持通过 FQDN 窥探 |
| Aruba AOS 8 / 10 | Netdestination 别名 | name *.domain.com | CLI / Aruba Central UI | 内置 DPI 引擎 |
| Ubiquiti UniFi | 网关授权表 | *.domain.com | UniFi Network 热点设置 | 集成到 dnsmasq / UDM |
| Fortinet FortiGate | FQDN 地址对象 | set fqdn *.domain.com | FortiOS CLI / 强制门户豁免列表 | FortiGuard DNS 解析表 |
| Juniper Mist | 云端推送的 AP 主机名 | *.domain.com | Mist AI Portal / Mist API | 边缘 AP 硬件加速 |
| Ruckus SmartZone | WISPr 围墙花园表 | *.domain.com | SmartZone WebUI / ZoneDirector | AP 级 DNS 代理过滤器 |
Apple CNA 与 Android 强制门户探测机制
当移动设备关联未加密或访客 SSID 时,操作系统会自动在后台发起连接检查,以确定设备是拥有无限制的互联网连接,还是处于强制门户之后:
- Apple iOS 和 macOS:向
http://captive.apple.com/hotspot-detect.html发送 HTTP GET 请求。如果服务器返回的内容不是包含<HTML><HEAD><TITLE>Success</TITLE></HEAD><BODY>Success</BODY></HTML>的准确 HTML 文本,操作系统会立即弹出模态 Captive Network Assistant (CNA) 浏览器。 - Google Android:向
http://connectivitycheck.gstatic.com/generate_204发送 HTTP 204 请求。如果 AP 拦截了连接并返回 HTTP 302 重定向或 HTML Splash Page,Android 会在系统通知栏中显示“登录 WiFi 网络”的通知。 - Microsoft Windows:连接位于
http://www.msftconnecttest.com/connecttest.txt的网络连接状态指示器 (NCSI),预期收到包含字符串Microsoft Connect Test的 200 OK。
最佳实践建议:请勿将 Apple 或 Android 探测域名列入白名单,除非您打算实现无感无头引导接入流程(如 Passpoint / Hotspot 2.0)。将这些探测域名列入白名单会误导操作系统,使其认为已连接到互联网,从而抑制 Splash Page 弹窗,并迫使访客手动打开 Web 浏览器来寻找门户。
保护围墙花园免受 DNS 隧道与滥用攻击
虽然围墙花园对于访客认证至关重要,但配置不当的白名单可能会使访客网络面临安全漏洞:
务必将未经认证的 DNS 流量限制在受信任的企业 DNS 解析器或内部控制器代理转发器中。在认证前网络中允许开放的递归 DNS,会导致恶意攻击者利用 DNS 查询隧道化传输任意 TCP/UDP 流量 (Iodine / DNScat)。
尽可能避免使用宽泛的顶级通配符白名单,如 *.amazonaws.com 或 *.cloudfront.net。请指定具体的资源桶主机名(例如 myvenue-assets.s3.amazonaws.com),以防止未经认证地浏览云存储。
配置认证前会话 ACL,仅允许第三方 OAuth 和支付处理程序使用出站 TCP 端口 443 (HTTPS),关闭未加密的端口 80,以防止访客 VLAN 上的中间人会话劫持。
如何为访客 WiFi 强制门户配置认证前围墙花园
网络工程师在用户认证前在企业级无线局域网控制器上生成、验证和应用允许域名白名单的逐步指南。
选择所需的身份验证集成
选择您的强制门户展示页面所需的外部身份提供商(Google OAuth、Microsoft Entra ID、Apple ID)、支付处理程序(Stripe、PayPal)、CDN 和字体库。
添加自定义场馆域名和 API 端点
将任何自定义场馆 FQDN、客户移动应用 API 主机或托管的品牌资产输入到自定义域名验证工具中。
选择目标硬件无线控制器
选择您的目标硬件厂商(Cisco Meraki、Cisco Catalyst 9800、Aruba OS、Ubiquiti UniFi、Fortinet FortiGate、Ruckus SmartZone、Juniper Mist、Extreme Networks 或 Cambium cnMaestro)。
将生成的配置命令应用到无线控制器
复制格式化后的 CLI 脚本或控制面板白名单条目,并将其应用到目标访客 WLAN 或预身份验证用户角色。
关于围墙花园与强制门户的常见问题
在访客 WiFi 和强制门户网络中,什么是围墙花园(walled garden)?
围墙花园(也称为允许域名白名单或认证前访问控制列表)是由无线接入点或无线局域网控制器实施的受限浏览环境。在未经身份验证的访客通过强制门户起始页面登录之前,所有常规互联网流量都会被拦截。围墙花园会明确将特定的完全合格域名(FQDN)和 IP 范围列入白名单 - 例如强制门户托管服务器、OAuth 身份提供商、支付处理程序和网络字体 - 从而使起始页面和身份验证脚本能够正常工作,而无需授予完整的网络访问权限。
对于围墙花园,企业级接入点上的 DNS 窥探是如何工作的?
现代企业级接入点(例如 Cisco Meraki、Aruba 和 Juniper Mist)使用动态 DNS 窥探,而不是静态 IP 访问控制列表。当未身份验证的客户端针对围墙花园白名单中的域名(例如 accounts.google.com)发送 DNS 查询时,接入点会拦截来自上游解析器的 DNS 响应。AP 会检查返回的 A 或 AAAA 记录,并为该客户端的 MAC 地址临时安装针对这些特定 IP 地址的动态 3 层防火墙许可规则,这些规则将在 DNS TTL 到期时失效。
为什么将 Apple CNA 列入白名单会导致自动弹出强制门户起始页面的功能失效?
Apple 设备在连接到 SSID 时会向 captive.apple.com 发送 HTTP 探测,以检测网络是否为强制网络。如果设备接收到预期的“Success”响应,它会认为已获得完整的互联网访问权限,因此不会打开强制网络助手(CNA)浏览器弹窗。将 captive.apple.com 列入白名单会让此探测未经拦截即可通过,从而误导 iOS 和 macOS 认为设备已具有完整连接,进而抑制自动模态登录提示的弹出。
通过 Google、Apple 和 Microsoft 进行社交登录需要将哪些域名列入白名单?
对于 Google 身份验证,需将 accounts.google.com、ssl.gstatic.com、apis.google.com 和 gstatic.com 列入白名单。对于 Microsoft Entra ID / 365,需将 login.microsoftonline.com、login.live.com、aadcdn.msftauth.net 和 aadcdn.msauth.net 列入白名单。对于通过 Apple 登录,需将 appleid.apple.com 和 appleid.cdn-apple.com 列入白名单。由于 OAuth 提供商经常使用内容分发网络和子域名,建议在支持的控制器上使用通配符匹配(*.domain.com)。
导致强制门户重定向循环和白屏的原因是什么?
重定向循环和白屏通常由以下三个问题引起:1) 围墙花园中缺少 CDN 或 JavaScript 资源(例如 fonts.gstatic.com 或 js.stripe.com 在加载前被拦截);2) 严格的 HTTPS 重定向,即控制器在网关上没有有效 SSL 证书的情况下尝试拦截 HTTPS 请求;3) 缺少 OAuth 回调域名,即身份提供商尝试重定向回门户主机,但被认证前防火墙规则拦截。
Purple 如何简化多厂商网络中的围墙花园管理?
Purple 运行具有统一单源域名架构的高可用性 Anycast 云基础设施。通过将强制门户托管、身份验证引擎和 CRM 集成集中在统一的 FQDN 端点(例如 onboarding.purple.ai)之后,Purple 最大限度地减少了无线控制器所需的外部域名规则数量,从而减少配置错误并消除认证前掉线问题。
相关网络诊断与 WiFi 工具
正在跨多厂商网络部署企业访客 WiFi?
消除复杂的围墙花园维护、SSL 警告和门户超时问题。Purple 与 Cisco Meraki、Catalyst 9800、Aruba、UniFi、Fortinet、Mist 和 Ruckus 原生集成,提供高可用性强制门户、Passpoint 引导接入以及访客行为分析。
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