waf规则文件拉取脚本

This commit is contained in:
qing committed 2026-07-25 11:22:51 +08:00
1 parent c028e46d00
commit 15a4bac484
2 files changed
+152

No files matched your search

+144
View File
@@ -0,0 +1,144 @@
#!/bin/bash
# 拉取 OWASP CRS 规则(通过 Go module proxy,不依赖 GitHub 直连)
#
# 用法:
# bash _fetch_crs.sh # 拉取最新版
# bash _fetch_crs.sh v4.25.0 # 拉取指定版本
#
# 规则来源:github.com/corazawaf/coraza-coreruleset/v4(Apache-2.0)
# 规则文件放置在 rules/crs/rules/,入口配置 rules/crs/coraza.conf
# 整个 rules/crs/ 目录已在 .gitignore 中,不入库。
set -euo pipefail
cd "$(dirname "$0")" || exit
VERSION="${1:-latest}"
CRS_DIR="rules/crs"
RULES_DIR="$CRS_DIR/rules"
echo "==== 拉取 OWASP CRS (${VERSION}) ===="
# 1. 通过 Go module proxy 下载 coraza-coreruleset
TMPDIR=$(mktemp -d)
trap 'rm -rf "$TMPDIR"' EXIT
WORKDIR="$TMPDIR/crs-fetch"
mkdir -p "$WORKDIR"
cd "$WORKDIR"
cat > go.mod << 'EOF'
module crs-fetch
go 1.22.0
EOF
echo "[1/4] 下载 coraza-coreruleset (${VERSION}) ..."
if [ "$VERSION" = "latest" ]; then
GOPROXY=https://goproxy.cn,direct go mod download github.com/corazawaf/coraza-coreruleset/v4@latest 2>&1
else
GOPROXY=https://goproxy.cn,direct go mod download "github.com/corazawaf/coraza-coreruleset/v4@${VERSION}" 2>&1
fi
# 2. 定位模块缓存
GOMODCACHE=$(go env GOMODCACHE)
# 找到实际下载的版本目录(可能是 v4@v4.25.0 等形式)
MOD_DIR=$(ls -d "$GOMODCACHE"/github.com/corazawaf/coraza-coreruleset/v4@* 2>/dev/null | tail -1)
if [ -z "$MOD_DIR" ]; then
echo "[ERROR] 未在模块缓存中找到 coraza-coreruleset" >&2
exit 1
fi
ACTUAL_VER=$(basename "$MOD_DIR" | sed 's/v4@//')
echo " 实际版本: ${ACTUAL_VER}"
SRC_RULES="$MOD_DIR/rules/@owasp_crs"
if [ ! -d "$SRC_RULES" ]; then
echo "[ERROR] 规则目录不存在: $SRC_RULES" >&2
exit 1
fi
cd - > /dev/null
# 3. 复制规则文件
echo "[2/4] 复制规则文件到 ${RULES_DIR}/ ..."
mkdir -p "$RULES_DIR"
cp "$SRC_RULES"/*.conf "$SRC_RULES"/*.data "$RULES_DIR/"
CONF_COUNT=$(ls "$RULES_DIR"/*.conf 2>/dev/null | wc -l | tr -d ' ')
DATA_COUNT=$(ls "$RULES_DIR"/*.data 2>/dev/null | wc -l | tr -d ' ')
echo " ${CONF_COUNT} 个规则文件, ${DATA_COUNT} 个数据文件"
# 4. 复制 LICENSE
echo "[3/4] 复制 LICENSE ..."
cp "$MOD_DIR/rules/LICENSE" "$CRS_DIR/LICENSE" 2>/dev/null || true
# 5. 生成入口配置 crs/coraza.conf
echo "[4/4] 生成 ${CRS_DIR}/coraza.conf ..."
# 从版本号算出 crs_setup_version:v4.25.0 → 4250
SETUP_VER=$(echo "$ACTUAL_VER" | sed 's/^v//; s/\.//g; s/\([0-9]*\).*/\1/' | head -c 4)
# 更精确:取 major*1000 + minor*10 + patch
MAJOR=$(echo "$ACTUAL_VER" | sed 's/^v//; s/\..*//')
MINOR=$(echo "$ACTUAL_VER" | sed 's/^v[0-9]*\.//; s/\..*//')
PATCH=$(echo "$ACTUAL_VER" | sed 's/^v[0-9]*\.[0-9]*\.//; s/[^0-9].*//')
SETUP_VER="${MAJOR}${MINOR}${PATCH}"
cat > "$CRS_DIR/coraza.conf" << CONFEOF
# crs/coraza.conf —— OWASP CRS 入口配置(由 _fetch_crs.sh 自动生成)
#
# 加载顺序(由 engine.Reload 控制):
# 1. rules/waf.conf 基础配置(SecRuleEngine On 等)
# 2. rules/local/*.conf 本地自定义规则
# 3. rules/crs/coraza.conf ← 本文件(CRS 初始化)
# 4. rules/crs/rules/*.conf CRS 规则文件(按文件名字母序)
#
# 本文件职责:
# - 设置 CRS 必需的事务变量(crs_setup_version)
# - 初始化 XML/JSON 请求体处理器
#
# 不在此文件设置的项(由 waf.conf 统一管理):
# - SecRuleEngine / SecRequestBodyAccess / SecResponseBodyAccess
# - SecRequestBodyLimit
# - SecDefaultAction(coraza 不允许同 phase 重复定义)
# ===== 请求体处理器初始化 =====
SecRule REQUEST_HEADERS:Content-Type "^(?:application(?:/soap\+|/)|text/)xml" \\
"id:'200000',phase:1,t:none,t:lowercase,pass,nolog,ctl:requestBodyProcessor=XML"
SecRule REQUEST_HEADERS:Content-Type "^application/json" \\
"id:'200001',phase:1,t:none,t:lowercase,pass,nolog,ctl:requestBodyProcessor=JSON"
SecRule REQUEST_HEADERS:Content-Type "^application/[a-z0-9.-]+[+]json" \\
"id:'200006',phase:1,t:none,t:lowercase,pass,nolog,ctl:requestBodyProcessor=JSON"
# ===== CRS 必需变量 =====
# 规则 901001 检查此变量,未设置则返回 500
SecAction \\
"id:900990,\\
phase:1,\\
pass,\\
nolog,\\
setvar:tx.crs_setup_version=${SETUP_VER}"
# ===== 可选调优(取消注释以启用) =====
# 异常评分阈值(默认 inbound=5, outbound=4)
# SecAction \\
# "id:900110,\\
# phase:1,\\
# pass,\\
# nolog,\\
# setvar:tx.inbound_anomaly_score_threshold=5,\\
# setvar:tx.outbound_anomaly_score_threshold=4"
# 偏执等级(默认 1;等级越高规则越严、误报越多)
# SecAction \\
# "id:900000,\\
# phase:1,\\
# pass,\\
# nolog,\\
# setvar:tx.blocking_paranoia_level=1"
CONFEOF
echo ""
echo "==== 完成 ===="
echo " 版本: OWASP CRS ${ACTUAL_VER}"
echo " 规则: ${RULES_DIR}/ (${CONF_COUNT} conf + ${DATA_COUNT} data)"
echo " 入口: ${CRS_DIR}/coraza.conf"
echo " 许可: Apache-2.0 (${CRS_DIR}/LICENSE)"
echo ""
echo "验证: ./waf.bin -c config.yaml -list | head"
echo "热加载: kill -HUP \$(pidof waf.bin)"
+8
View File
@@ -4,8 +4,15 @@
# - 修改后执行 `kill -HUP <pid>` 热加载
# - 校验语法: `waf -test rules/local/xxx.conf`
#
# 加载顺序(engine.Reload):
# 1. waf.conf ← 本文件(引擎基础配置)
# 2. local/*.conf 本地自定义规则(按文件名字母序)
# 3. crs/coraza.conf OWASP CRS 入口(若存在)
# 4. crs/rules/*.conf OWASP CRS 规则(按文件名字母序)
#
# 规则 ID 分段约定:
# 100000-199999 本地自定义规则
# 200000-200006 请求体处理器初始化(crs/coraza.conf)
# 900000-999999 OWASP CRS(由 crs/ 提供,不手改)
#
# 注意:本文件不用 Include 指令(coraza 的 Include 路径相对于 cwd 解析,
@@ -16,6 +23,7 @@ SecRuleEngine On
SecRequestBodyAccess On
SecResponseBodyAccess On
SecDefaultAction "phase:1,pass,log,auditlog"
SecDefaultAction "phase:2,pass,log,auditlog"
# 请求体限制 10MB
SecRequestBodyLimit 10485760