微信小程序认证网络准入 · OpenPortal小程序授权实名认证配置

STEP BY STEP / 从平台配置到上线

三段配置，扫码即完成认证

AppID、AppSecret 与服务器域名请按小程序后台的实际配置填写；页末另附微信免认证放行列表。

1配置步骤

AC、核心交换机、Bras、路由等设备，实现微信小程序认证方式网络准入认证配置，通过微信小程序授权实名认证获取用户实名手机号码等信息。

网络设备配置好Portal认证基础上，做一下配置即可实现基于微信小程序认证的网络准入实名认证方案。

2一、微信小程序平台配置

1.在微信小程序后台【开发设置】项目中，找到并复制AppID、AppSecret
2.在服务器域名和业务域名中填写Portal认证服务器的公网域名
3.在版本中上传小程序代码并审批

如下图所示：

3二、认证计费系统中配置如下

在Portal系统后台-【Portal管理】-【微信认证设置】中设置微信小程序的相关配置

如下图所示：

图 4 二、认证计费系统中配置如下 — 图 4 · 二、认证计费系统中配置如下点击放大

微信小程序认证的接入账户组名称配置如下图：

4三、认证步骤

1.PC端，手机打开微信，扫描页面中的二维码
2.移动终端会自动跳转到微信小程序，进行下一步的用户授权步骤
3.在微信小程序中授权并完成认证

5备注：设备免认证放行列表

备注：如果不使用临时放行方案，需要在设备配置如下放行列表。

微信小程序认证同时依赖「微信客户端基础通信」与「小程序运行时」两层域名，任一层缺失都会表现为小程序白屏、扫码无响应或加载到一半失败。认证前必须放行 DNS 与下列域名。另外微信大量使用 HTTPDNS（dns.weixin.qq.com），该域名必须单独放行，只放普通 DNS 不足以让小程序跑起来。

1. 微信客户端基础域名（必须）

域名	用途
`weixin.qq.com`	微信主域（覆盖 long. / short. / dns. 等各子域）
`long.weixin.qq.com`	长连接
`short.weixin.qq.com`	短连接
`szlong.weixin.qq.com`	深圳长连接接入点
`szshort.weixin.qq.com`	深圳短连接接入点
`shlong.weixin.qq.com`	上海长连接接入点
`shshort.weixin.qq.com`	上海短连接接入点
`extshort.weixin.qq.com`	扩展短连接
`minorshort.weixin.qq.com`	小程序短连接
`szminorshort.weixin.qq.com`	小程序深圳短连接
`dns.weixin.qq.com`	微信内置 DNS（HTTPDNS）
`dns.weixin.qq.com.cn`	HTTPDNS 备用域
`login.weixin.qq.com`	登录
`login-ext.weixin.qq.com`	登录扩展
`mp.weixin.qq.com`	公众平台 / 小程序框架页
`open.weixin.qq.com`	开放授权（OAuth）

2. 小程序运行时域名（必须）

域名	用途
`servicewechat.com`	小程序统一网关（wx.login 等原生能力中转，强制 HTTPS / WSS）
`wx.qlogo.cn`	用户头像
`thirdwx.qlogo.cn`	第三方授权头像
`thirdqq.qlogo.cn`	QQ 授权头像
`qpic.cn`	图片资源
`mmbiz.qpic.cn`	图文 / 小程序图片资源
`dldir1.qq.com`	动态配置 / 小程序包下载
`cube.weixinbridge.com`	多维监控上报
`weixinbridge.com`	微信桥接上报
`wxs.qq.com`	小程序 / 游戏资源
`support.weixin.qq.com`	支持 / 配置
`wifi.weixin.qq.com`	微信 WiFi 认证相关
`wxagame.weixin.qq.com`	小游戏（按需）
`tcb.cloud.tencent.com`	小程序云开发（按需）

3. 基础设施

DNS：认证前必须放行（UDP / TCP 53）。
HTTPDNS：dns.weixin.qq.com / dns.weixin.qq.com.cn 必须单独放行。微信客户端大量走内置 HTTPDNS，只放普通 DNS，小程序仍会加载失败。
DHCP：建议同时放行（UDP 67 / 68），否则终端连地址都拿不到。

微信服务器 IP 动态变化，华为官方也提示：仅放行「获取微信服务器 IP」接口返回的地址可能不全，强烈建议按域名放行。另外 HTTPDNS 返回 IP 后终端是直连 IP 的，这部分流量匹配不到域名规则；若小程序仍加载异常，需要额外按解析出的 IP 段放行，或让 AC 代理 DNS。

6华为 AC 免认证放行配置

华为 AC（V200R 系列）通过 free-rule-template 配置免认证规则，模板要绑定到 Portal 服务器模板，再在接口或无线服务模板下引用才生效。

华为 AC · 免认证规则模板左右滑动查看

system-view
free-rule-template name wxapp_auth
free-rule 1 destination ip 114.114.114.114 mask 255.255.255.255
free-rule 2 destination ip 223.5.5.5 mask 255.255.255.255
free-rule 10 destination domain weixin.qq.com
free-rule 11 destination domain mp.weixin.qq.com
free-rule 12 destination domain open.weixin.qq.com
free-rule 13 destination domain long.weixin.qq.com
free-rule 14 destination domain short.weixin.qq.com
free-rule 15 destination domain dns.weixin.qq.com
free-rule 16 destination domain dns.weixin.qq.com.cn
free-rule 17 destination domain login.weixin.qq.com
free-rule 20 destination domain servicewechat.com
free-rule 21 destination domain wx.qlogo.cn
free-rule 22 destination domain thirdwx.qlogo.cn
free-rule 23 destination domain thirdqq.qlogo.cn
free-rule 24 destination domain qpic.cn
free-rule 25 destination domain dldir1.qq.com
free-rule 26 destination domain cube.weixinbridge.com
free-rule 27 destination domain weixinbridge.com
free-rule 28 destination domain wxs.qq.com
free-rule 29 destination domain wifi.weixin.qq.com
quit

华为 AC · 模板绑定与接口引用左右滑动查看

portal-server-template name wxapp_portal
free-rule-template wxapp_auth
quit
interface Vlan-interface100
portal wxapp_portal
quit

域名免认证规则对子域名生效：weixin.qq.com 一条即覆盖 long.weixin.qq.com / short.weixin.qq.com / dns.weixin.qq.com / login.weixin.qq.com 等子域，所以主域一定要配上。
但 servicewechat.com、wx.qlogo.cn、qpic.cn、dldir1.qq.com、wxs.qq.com 都在 weixin.qq.com 之外，必须逐条放行。
AirEngine 9700 / AC6000 配套 AP 场景用透传域写法：passthrough-domain name .weixin.qq.com id 1 ＋ passthrough-domain name .servicewechat.com id 2 ＋ ACL 6000 放行两个透传域＋ free-rule acl 6000；qlogo / qpic / dldir 仍按域名逐条配置。
云管理 Campus 版本不用敲命令，直接在「网络配置 › 站点配置 › 认证点 › 默认放行规则」里加上表中的域名即可。
接口下的引用命令随版本略有差异（部分版本为 portal apply web-server），以设备 ? 提示为准。

7H3C AC 免认证放行配置

H3C AC 在系统视图下用 portal free-rule 逐条配置免认证规则，再在接口或无线服务模板下引用 Portal 认证模板。

H3C AC · 免认证规则左右滑动查看

system-view
portal free-rule 1 destination udp 53
portal free-rule 2 destination tcp 53
portal free-rule 3 destination ip 114.114.114.114 32
portal free-rule 4 destination ip 223.5.5.5 32
portal free-rule 10 destination domain weixin.qq.com
portal free-rule 11 destination domain mp.weixin.qq.com
portal free-rule 12 destination domain open.weixin.qq.com
portal free-rule 13 destination domain long.weixin.qq.com
portal free-rule 14 destination domain short.weixin.qq.com
portal free-rule 15 destination domain dns.weixin.qq.com
portal free-rule 16 destination domain dns.weixin.qq.com.cn
portal free-rule 17 destination domain login.weixin.qq.com
portal free-rule 20 destination domain servicewechat.com
portal free-rule 21 destination domain wx.qlogo.cn
portal free-rule 22 destination domain thirdwx.qlogo.cn
portal free-rule 23 destination domain thirdqq.qlogo.cn
portal free-rule 24 destination domain qpic.cn
portal free-rule 25 destination domain dldir1.qq.com
portal free-rule 26 destination domain cube.weixinbridge.com
portal free-rule 27 destination domain weixinbridge.com
portal free-rule 28 destination domain wxs.qq.com
portal free-rule 29 destination domain wifi.weixin.qq.com
quit

H3C AC · 接口引用左右滑动查看

interface Vlan-interface100
portal apply profile wxapp_portal
quit

旧版 Comware（V5 / V7 早期）命令为 portal free-rule rule-id destination domain domain-name，含义一致。
域名免认证依赖设备侧 DNS 解析，务必先放行 DNS 与 DNS 服务器 IP。
微信 HTTPDNS 返回的 IP 是终端直连的，域名规则匹配不到，这类流量需按 IP 段单独放行。

8放行验证与排障

终端关联 SSID 后不认证，微信能正常收发消息、扫码能打开小程序，说明 free-rule 已生效。
小程序打不开 / 白屏：多为 servicewechat.com、dldir1.qq.com、wxs.qq.com 未放行。
头像 / 图片不显示：多为 wx.qlogo.cn、thirdwx.qlogo.cn、qpic.cn 未放行。
微信本身连不上：检查 weixin.qq.com 主域与 dns.weixin.qq.com（HTTPDNS）是否放行。
扫码后一直转圈或加载到一半失败：HTTPDNS 返回 IP 后终端直连，域名规则匹配不到，需按解析出的 IP 段放行或让 AC 代理 DNS。

本节综合华为官方文档《使用编辑模式部署微信认证》与微信官方社区的小程序放通域名清单整理，小程序相关域名见微信官方说明，以官方文档为准。

示例中的账号、密钥、域名与 IP 地址请按实际环境替换；不同软件版本的配置项名称可能存在差异，以设备与平台实际支持为准。

RELATED CASES / 相关对接案例

华为 AC6605 对接 H3C WX2510H 对接华为 NE40 ME60 BRAS 对接短信认证钉钉认证微信小程序认证企业微信认证飞书认证

微信小程序认证，实名授权准入