WAF 接入后接口开始 403:域名接入、误拦截排查与回源那几件事

举报
yd_42677603 发表于 2026/11/13 12:33:08 2026/11/13
【摘要】 域名 CNAME 切到 WAF 后接口开始零星 403,源站日志里的客户端 IP 也变了。这篇用 Python SDK 走一遍云模式 WAF 的接入顺序、防护事件排查、白名单与限速规则配置,以及真实客户端 IP 怎么传到源站。

域名 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,基本可以判定是误报。

误报长什么样,常见的三种:

  1. JSON 请求体里带 SQL 关键字或 --、// 之类的注释符,比如查询参数里存了一段 SQL 片段;
  2. 富文本编辑器提交的 HTML 被当成 XSS,payload 里是 <p>、onerror 这类正常标签;
  3. 文件上传的 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 这类已有字段会被拒绝,用自定义名字最稳。

几个真实踩坑

  1. HTTPS 域名只给了证书 id 没给名字,报错信息很含糊。 certificateid 和 certificatename 是成对的,两个都得有;只填一个,返回的是参数校验错误,不会告诉你是漏了名字。
  2. pagesize=-1 不是所有列表接口都支持。 ListHost 支持填 -1 查全部,ListPolicy 的范围是 1 到 100,照抄过去会直接 400。
  3. ListEvent 的时间范围有两个陷阱。 _from / to 是毫秒时间戳不是秒;跨度超过 30 天或 to 超过今天结束都会失败。想查"最近一周",用 recent="1week" 比自己算时间戳省事。
  4. 加白之后事件列表不会变干净。 全局白名单的效果是"不再检测",它不会删除历史事件。验证是否生效,要看加白之后新增的同类事件是否归零,而不是刷新旧列表。
  5. 排障时用 protect_status=0,别用 -1。 0 是"只转发不检测",流量仍然经过 WAF,回源链路、证书、超时这些都能验证;-1 是 bypass,请求直接到源站,等于把 WAF 从链路上摘掉,验证不出任何东西。
  6. 策略 level 改宽严之前先看事件。 1 宽松、2 中等、3 严格,从 2 调到 3 之后误报往往成倍增长。调之前先按 rule 统计一遍现有事件命中分布,才知道收紧之后会多拦哪些。

小结

WAF 接入真正麻烦的不是建域名,而是三件事的先后顺序:先把防护调成"只转发"验证回源,再切 CNAME,最后才开检测;切完之后第一件事是查防护事件而不是改策略;真实 IP 靠 forward_header_map 注入,而它成立的前提是源站只信 WAF 的回源网段。

按这个顺序做,403 就不再是"玄学拦截",而是一条能追到具体规则 id 的事件记录。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。