WAF 接入后接口开始 403:域名接入、误拦截排查与回源那几件事
域名 CNAME 切到 WAF 之后,最常见的情形不是"被打挂了",而是三个说不清的症状同时出现:
- 原来返回 200 的接口开始零星 403,日志里看不出谁拦的;
- 上传、回调、健康检查这几类请求整条链路打不通,但浏览器访问首页又是好的;
- 源站日志里客户端 IP 全变成同一批地址,风控和限流瞬间失准。
这三个症状分别对应三件事:WAF 的防护事件没去查、接入顺序没排对、真实 IP 没传下来。这篇按"建域名 → 切流量 → 查事件 → 处置 → 取真实 IP"的顺序,把云模式 WAF 用 Python SDK 跑一遍,并说明每一步里最容易踩的坑。
环境准备
SDK 与凭证按华为云 Python SDK 的通用写法准备,AK/SK 建议用只授予 WAF 权限的 RAM 子账号,不要用主账号 AK。
python3 -m pip install huaweicloudsdkwaf
import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkwaf.v1.region.waf_region import WafRegion
from huaweicloudsdkwaf.v1 import WafClient
client = WafClient.new_builder() \
.with_credentials(BasicCredentials(
os.environ["HUAWEI_AK"],
os.environ["HUAWEI_SK"],
)) \
.with_region(WafRegion.CN_EAST_3) \
.build()
后面的调用都复用这个 client。
先有策略,再有域名
WAF 的域名必须挂在一个防护策略上。控制台新建域名时会让你选策略,走 API 时如果 policyid 不传,域名会挂到默认策略上——这意味着你后来改默认策略,会连带影响所有"当时偷懒没指定"的域名。所以顺序应该是:先确认策略,再建域名。
from huaweicloudsdkwaf.v1 import ListPolicyRequest, CreatePolicyRequest, CreatePolicyRequestBody
# 策略名只能由数字、字母、下划线组成
client.create_policy(CreatePolicyRequest(
body=CreatePolicyRequestBody(name="prod_api_policy"),
))
for p in client.list_policy(ListPolicyRequest(pagesize=100)).items:
print(p.id, p.name, p.level) # level: 1 宽松 / 2 中等 / 3 严格
ListPolicy 的 pagesize 范围是 1 到 100,没有"一次查全部"的取值——这一点和域名列表不一样,后面会再提。
拿到 policy_id 之后建域名:
from huaweicloudsdkwaf.v1 import (
CreateHostRequest, CreateHostRequestBody, CloudWafServer,
)
body = CreateHostRequestBody(
hostname="www.example.com",
policyid="<policy_id>",
server=[
CloudWafServer(
front_protocol="HTTPS", # 客户端到 WAF
back_protocol="HTTP", # WAF 回源到源站
address="192.0.2.10", # 源站地址,占位
port=8080,
type="ipv4",
),
],
certificateid="<cert_id>", # 对外协议为 HTTPS 时必填
certificatename="example-com",
proxy=False,
description="api-gateway",
forward_header_map={"X-Real-Client-IP": "$remote_addr"},
)
resp = client.create_host(CreateHostRequest(body=body))
print(resp.id, resp.access_code, resp.access_status, resp.protect_status)
几个字段的约束值得记住:
hostname只能由字母、数字、-、_、.组成,长度不超过 64;server里front_protocol、back_protocol、address、port、type五项都必须给,缺一个就是 400;- 对外协议是 HTTPS 时,
certificateid和certificatename都必填;HTTP 时不填; forward_header_map是给源站加请求头的开关,Key 不能与 nginx 原生字段重名,Value 支持$remote_addr、$request_id、$scheme、$time_local这类变量。后面取真实 IP 全靠它;lb_algorithm(ip_hash/round_robin/session_hash)只有专业版和企业版能用,配多个源站时才需要。
返回里 access_code 是 CNAME 前缀,access_status 是接入状态:0 未接入、1 已接入。刚建完必然是 0——域名还没有任何流量指向 WAF。
切流量之前,先把防护调成"只转发不检测"
protect_status 有三个取值,排障时非常好用:
| 值 | 含义 | 什么时候用 |
| 1 | 开启防护,按策略检测 | 正式运行 |
| 0 | 暂停防护,只转发不检测 | 切流验证、上线前压测 |
| -1 | bypass,请求直接到源站,不经过 WAF | 应急绕过,别当常用开关 |
正确的切流顺序是:建域名 → 把 protect_status 调成 0 → CNAME 切过去 → 跑一轮业务确认回源正常 → 再调回 1。反过来先开防护再切流,一旦有误拦截,你会同时面对"是网络问题还是策略问题"两个未知数。
from huaweicloudsdkwaf.v1 import (
UpdateHostProtectStatusRequest, UpdateHostProtectStatusRequestBody,
)
client.update_host_protect_status(UpdateHostProtectStatusRequest(
instance_id="<host_id>", # 域名 id,不是域名
body=UpdateHostProtectStatusRequestBody(protect_status=0),
))
CNAME 的值以控制台域名详情页为准,access_code 只是它的前缀,不要自己拼。切过去之后用 dig 确认解析:
dig +short CNAME www.example.com
解析生效后,用 ListHost 看 access_status 是否从 0 变成 1:
from huaweicloudsdkwaf.v1 import ListHostRequest
for h in client.list_host(ListHostRequest(pagesize=-1)).items:
print(h.hostname, h.access_code, h.access_status, h.protect_status)
ListHost 的 pagesize 填 -1 表示一次查全部域名,方便做巡检;ListPolicy 没有这个用法。
这一步还有一件必须做的事:源站安全组只放行 WAF 的回源网段。回源 IP 段在控制台的域名信息里可以拿到,用占位符写进安全组规则:
入方向:TCP 8080,源地址 <waf_back_to_source_cidr>
如果为了"先跑通"把 8080 对 0.0.0.0/0 打开,那 WAF 就只剩一个心理安慰——攻击者查到源站地址后可以直连,你的防护事件里一条记录都不会有。
403 从哪来:把防护事件当访问日志查
WAF 拦截的每一个请求都会落一条防护事件,这是定位误拦截的唯一入口。ListEvent 的参数里,决定查询范围的主要是三个:
recent:yesterday、today、3days、1week、1month;_from/to:毫秒时间戳,必须一起用,跨度最大 30 天,to不能超过今天结束;同时传recent和from/to时以recent为准;hosts:域名 id 列表,从ListHost拿,不是域名本身。
from huaweicloudsdkwaf.v1 import ListEventRequest
ev = client.list_event(ListEventRequest(
recent="3days",
hosts=["<host_id>"],
attacks=["sqli", "xss", "cmdi", "custom_custom", "cc"],
page=1,
pagesize=50,
sort_key="attack_time",
sort_direction="desc",
))
for it in ev.items:
print(it.time, it.sip, it.attack, it.rule, it.action, it.url)
attacks 里的取值要分清:custom_custom 是精准防护规则命中的事件,custom_whiteblackip 是 IP 黑白名单,cc 是 CC 攻击——排查"为什么我自己写的精准防护把正常请求拦了",要查的是 custom_custom。actions 则对应防护动作:block、log、pass、captcha 等。
事件列表里最关键的两个字段是 rule(命中的规则 id)和 payload_location、payload(命中的恶意载荷及其位置)。要看完整请求,用事件 id 拉详情:
from huaweicloudsdkwaf.v1 import ShowEventRequest detail = client.show_event(ShowEventRequest(eventid="<event_id>", x_language="zh-cn")) item = detail.items[0] print(item.rule, item.payload_location, item.payload) print(item.request_line) print(item.headers)
排查顺序建议固定成三步:先按域名和时间窗把范围缩到某一次发布之后;再看 attack 的类型分布是否异常集中在某一类;最后看 rule 是否反复命中同几条内置规则。如果某条规则在半小时内命中的全部是你自己的业务 IP,基本可以判定是误报。
误报长什么样,常见的三种:
- JSON 请求体里带 SQL 关键字或
--、//之类的注释符,比如查询参数里存了一段 SQL 片段; - 富文本编辑器提交的 HTML 被当成 XSS,
payload里是<p>、onerror这类正常标签; - 文件上传的 multipart 边界或文件名里的特殊字符被当成命令注入或目录遍历。
判断标准只有一个:payload 命中的是业务数据本身,还是攻击特征。前者是误报,后者说明防护在正常工作。
三条处置路径:加白、精准拦截、限速
全局白名单:让指定请求"不检测"
确认是误报之后,最省事的处置是把这类请求从检测里摘出去。这对应控制台上的"全局白名单"(误报屏蔽),SDK 里是 create_ignore_rule,注意它是挂在策略下的:
from huaweicloudsdkwaf.v1 import (
CreateIgnoreRuleRequest, CreateIgnoreRuleRequestBody,
CreateCondition, IgnoreAdvanced,
)
client.create_ignore_rule(CreateIgnoreRuleRequest(
policy_id="<policy_id>",
body=CreateIgnoreRuleRequestBody(
domain=["www.example.com"], # 空数组表示对全部域名生效
mode=1, # v2 误报屏蔽规则,固定为 1
rule="bypass", # 跳过全部检测
conditions=[
CreateCondition(
category="url",
logic_operation="prefix",
contents=["/api/v1/upload"],
),
],
advanced=IgnoreAdvanced(index="Multipart", contents=["all"]),
description="upload 接口 multipart 误报,2026-11-13 加白",
),
))
rule 的取值决定放行范围,这是最容易放得太宽的地方:
bypass:跳过所有模块的检测;- 内置规则 ID,多个用分号分隔,比如
"000000;111111"——只放过那几条; - 规则类别,同样分号分隔:
xss、sqli、webshell、vuln、robot、rfi、lfi、cmdi; illegal:非法请求。
能用规则 ID 就别用 bypass。一个上传接口图省事写了 bypass,等于这个路径上的 SQL 注入、命令注入全都不看了——而这个接口恰好是最容易成为入口的地方。domain 同理,留空数组就是全站生效,尽量写具体域名。
精准防护:主动拦掉不该来的请求
误报是"该放没放",还有一类问题是"该拦没拦"——扫描器在刷 /wp-admin、/.env、/actuator/env,这些用精准防护比改内置规则更直接:
from huaweicloudsdkwaf.v1 import (
CreateCustomRuleRequest, CreateCustomRuleRequestBody,
CustomConditions, CustomAction,
)
client.create_custom_rule(CreateCustomRuleRequest(
policy_id="<policy_id>",
body=CreateCustomRuleRequestBody(
name="block_admin_scan",
time=False, # False 立即生效
conditions=[
CustomConditions(
category="url",
logic_operation="prefix",
contents=["/wp-admin", "/.env", "/actuator"],
),
],
action=CustomAction(category="block"), # block / pass / log
priority=10, # 0~65535,越小越优先
description="拦截后台与配置文件探测",
),
))
conditions 的 category 支持 url、user-agent、ip、params、cookie、referer、header、request_line、method、request。params、header、cookie 需要 index 指定子字段名;匹配逻辑按类型受限,比如 ip 只能用 equal / not_equal / equal_any / not_equal_all,url 可以用 contain、prefix、suffix、len_greater 这一整套。
建议新规则先 action=log 跑一天,看事件里命中的是不是你以为的那些请求,再改成 block。直接上拦截,最容易拦掉自家监控的探测请求。
CC 防护:给单个接口限速
登录、发短信、抢购这类接口,被刷的表现不是攻击特征命中,而是请求量异常。用 CC 规则按接口限速:
from huaweicloudsdkwaf.v1 import (
CreateCcRuleRequest, CreateCcRuleRequestBody, CcCondition,
CreateCcRuleRequestBodyAction,
)
client.create_cc_rule(CreateCcRuleRequest(
policy_id="<policy_id>",
body=CreateCcRuleRequestBody(
name="cc_login_limit",
mode=1, # 1 高级模式,可对路径/IP/Cookie/Header/Params 限制
conditions=[
CcCondition(category="url", logic_operation="prefix", contents=["/api/login"]),
],
tag_type="ip", # ip / cookie / header / other / policy / domain / url
limit_num=20, # 限速频率
limit_period=60, # 限速周期,秒,1~3600
action=CreateCcRuleRequestBodyAction(category="block"),
lock_time=300, # 阻断后恢复时间,秒,0~65535
cc_priority=10,
description="登录接口单 IP 每分钟 20 次",
),
))
action.category 支持 captcha(人机验证)、block、log,以及高级模式下的 dynamic_block——它的意思是上一个周期超了限速频率,下一个周期按更低的"放行频率"(unlock_num)判定,适合抑制持续的慢速刷量。
tag_type 是这组参数里最需要想清楚的一个:ip 按来源 IP 区分访问者,最简单,但也最容易误伤 NAT 后面的整栋办公楼;cookie / header 需要 tag_index 指定字段名,适合已有登录态的接口。选错了不是防护弱,是直接把正常用户挡在外面。
源站看到的 IP 不是用户 IP
切到 WAF 之后,源站拿到的 remote_addr 是 WAF 的回源地址。所有基于客户端 IP 的逻辑——风控、限流、审计、地域判断——都会失准,而且失准得很隐蔽:日志里 IP 字段有值,只是不是你以为的那个人。
解决办法是在建域名时用 forward_header_map 把 WAF 侧的地址注入到请求头,前面建域名时已经配了一行:
forward_header_map={"X-Real-Client-IP": "$remote_addr"}
这样源站收到的每个请求都会带上 X-Real-Client-IP。业务代码里取这个头,不要取 remote_addr。
但这套机制成立有个前提:源站只接受来自 WAF 的请求。如果源站端口对公网开放,任何人都能自己造一个 X-Real-Client-IP 头发过来,风控和限流就被绕过了。所以回源网段的安全组限制不是"优化项",是这套方案能不能用的前提。
另外,forward_header_map 的 Key 不能和 nginx 原生字段重名,写成 X-Forwarded-For 这类已有字段会被拒绝,用自定义名字最稳。
几个真实踩坑
- HTTPS 域名只给了证书 id 没给名字,报错信息很含糊。
certificateid和certificatename是成对的,两个都得有;只填一个,返回的是参数校验错误,不会告诉你是漏了名字。 pagesize=-1不是所有列表接口都支持。ListHost支持填 -1 查全部,ListPolicy的范围是 1 到 100,照抄过去会直接 400。ListEvent的时间范围有两个陷阱。_from/to是毫秒时间戳不是秒;跨度超过 30 天或to超过今天结束都会失败。想查"最近一周",用recent="1week"比自己算时间戳省事。- 加白之后事件列表不会变干净。 全局白名单的效果是"不再检测",它不会删除历史事件。验证是否生效,要看加白之后新增的同类事件是否归零,而不是刷新旧列表。
- 排障时用
protect_status=0,别用-1。 0 是"只转发不检测",流量仍然经过 WAF,回源链路、证书、超时这些都能验证;-1 是 bypass,请求直接到源站,等于把 WAF 从链路上摘掉,验证不出任何东西。 - 策略
level改宽严之前先看事件。1宽松、2中等、3严格,从 2 调到 3 之后误报往往成倍增长。调之前先按rule统计一遍现有事件命中分布,才知道收紧之后会多拦哪些。
小结
WAF 接入真正麻烦的不是建域名,而是三件事的先后顺序:先把防护调成"只转发"验证回源,再切 CNAME,最后才开检测;切完之后第一件事是查防护事件而不是改策略;真实 IP 靠 forward_header_map 注入,而它成立的前提是源站只信 WAF 的回源网段。
按这个顺序做,403 就不再是"玄学拦截",而是一条能追到具体规则 id 的事件记录。
- 点赞
- 收藏
- 关注作者
评论(0)