架构与系统设计 / 系统课时

网关访问控制

网关访问控制

本课完成一个可落地的支付网关访问控制链路:请求先匹配路由,再经过黑白名单、签名鉴权和限流,最后由网关注入可信上下文并转发到业务服务,避免每个下游重复实现同一套入口安全逻辑。

学习目标

  • 理解路由、访问名单、鉴权、限流和上下文传递的执行顺序
  • 使用 Spring Cloud Gateway 配置开放接口路由与 Redis 限流
  • 正确处理伪造请求头、代理 IP 和统一拒绝响应

控制链路与执行顺序

开放接口的控制顺序应保持稳定:先确认请求属于哪条路由,再解析可信客户端 IP,随后检查黑白名单、时间戳与签名,鉴权成功后按商户维度限流,最后覆盖内部上下文请求头并转发。任一环节失败都应立即终止,不进入业务服务。

网关访问控制执行链路

网关不是业务权限中心。它负责确认调用方身份和入口访问条件;订单归属、数据范围等业务授权仍由下游服务根据可信商户上下文判断。

配置路由与商户限流

下面是 Spring Cloud Gateway 路由片段。它把 /open-api/** 转发到交易服务,并通过 Redis 令牌桶按商户号限流。该片段依赖名为 merchantKeyResolver 的 Bean,以及可用的 Redis 连接。

yaml
spring:
  cloud:
    gateway:
      routes:
        - id: open-api-trade
          uri: lb://trade-service
          predicates:
            - Path=/open-api/**
          filters:
            - name: RequestRateLimiter
              args:
                redis-rate-limiter.replenishRate: 20
                redis-rate-limiter.burstCapacity: 40
                redis-rate-limiter.requestedTokens: 1
                key-resolver: "#{@merchantKeyResolver}"

配置生效后,同一商户稳定速率为每秒 20 个请求,短时最多可消耗 40 个令牌;超过容量时网关返回 HTTP 429。生产环境应根据商户等级和接口成本拆分限额,不能让查询接口与下单接口共享完全相同的阈值。

限流键必须来自鉴权后的商户身份。若直接信任客户端传入的 X-Merchant-No,攻击者可以不断更换商户号绕过限流。因此,实际实现中应先完成签名校验,再把确认过的商户号放入交换属性,KeyResolver 只读取该属性。

实现鉴权与可信上下文

下面是网关全局过滤器的片段示例。它依赖项目中的 OpenApiSignatureService、ClientIpResolver 和 GatewayAccessProperties,重点展示拒绝顺序与请求头覆盖方式。

java
package com.example.gateway.security;

import java.nio.charset.StandardCharsets;
import java.util.UUID;

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;
import lombok.RequiredArgsConstructor;
import org.springframework.cloud.gateway.filter.GatewayFilterChain;
import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.core.Ordered;
import org.springframework.core.io.buffer.DataBuffer;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.stereotype.Component;
import org.springframework.web.server.ServerWebExchange;
import reactor.core.publisher.Mono;

@Component
@RequiredArgsConstructor
public class GatewayAccessFilter implements GlobalFilter, Ordered {

    private final OpenApiSignatureService signatureService;
    private final ClientIpResolver clientIpResolver;
    private final GatewayAccessProperties accessProperties;
    private final ObjectMapper objectMapper;

    @Override
    public Mono<Void> filter(ServerWebExchange exchange, GatewayFilterChain chain) {
        String path = exchange.getRequest().getURI().getPath();
        if (!path.startsWith("/open-api/")) {
            return chain.filter(exchange);
        }

        String clientIp = clientIpResolver.resolve(exchange.getRequest());
        if (accessProperties.blockedIps().contains(clientIp)) {
            return writeJson(exchange, HttpStatus.FORBIDDEN,
                    "GATEWAY_FORBIDDEN", "客户端地址已被拒绝");
        }
        if (!accessProperties.allowedIps().isEmpty()
                && !accessProperties.allowedIps().contains(clientIp)) {
            return writeJson(exchange, HttpStatus.FORBIDDEN,
                    "GATEWAY_FORBIDDEN", "客户端地址不在白名单");
        }

        SignaturePrincipal principal = signatureService.verify(exchange.getRequest());
        if (principal == null) {
            return writeJson(exchange, HttpStatus.UNAUTHORIZED,
                    "GATEWAY_UNAUTHORIZED", "签名校验失败");
        }

        String traceId = UUID.randomUUID().toString();
        ServerWebExchange trustedExchange = exchange.mutate()
                .request(builder -> builder.headers(headers -> {
                    // 先移除外部同名头,再写入网关确认过的上下文。
                    headers.remove("X-Merchant-No");
                    headers.remove("X-Client-Ip");
                    headers.remove("X-Trace-Id");
                    headers.set("X-Merchant-No", principal.merchantNo());
                    headers.set("X-Client-Ip", clientIp);
                    headers.set("X-Trace-Id", traceId);
                }))
                .build();
        trustedExchange.getAttributes().put("authenticatedMerchantNo",
                principal.merchantNo());
        return chain.filter(trustedExchange);
    }

    private Mono<Void> writeJson(ServerWebExchange exchange,
                                 HttpStatus status,
                                 String code,
                                 String message) {
        String traceId = UUID.randomUUID().toString();
        ObjectNode body = objectMapper.createObjectNode();
        body.put("code", code);
        body.put("message", message);
        body.putNull("data");
        body.put("traceId", traceId);

        byte[] bytes;
        try {
            bytes = objectMapper.writeValueAsString(body)
                    .getBytes(StandardCharsets.UTF_8);
        } catch (Exception ex) {
            bytes = ("{\"code\":\"GATEWAY_ERROR\","
                    + "\"message\":\"响应序列化失败\"}")
                    .getBytes(StandardCharsets.UTF_8);
        }

        exchange.getResponse().setStatusCode(status);
        exchange.getResponse().getHeaders()
                .setContentType(MediaType.APPLICATION_JSON);
        DataBuffer buffer = exchange.getResponse()
                .bufferFactory().wrap(bytes);
        return exchange.getResponse().writeWith(Mono.just(buffer));
    }

    @Override
    public int getOrder() {
        return -100;
    }
}

这段过滤器不接受客户端自带的内部上下文,而是先删除后重写。ClientIpResolver 只能信任由负载均衡器清洗并重建的代理头;若客户端可以直接访问网关,就不能无条件采用 X-Forwarded-For 的首个值。

验证拒绝结果

启动网关后,用错误签名请求开放接口。<PORT> 是实际网关端口,时间戳和签名字段名应与项目约定保持一致。

bash
curl -i "http://localhost:<PORT>/open-api/pay/orders" \
  -H "X-Merchant-No: M1001" \
  -H "X-Timestamp: 1720000000000" \
  -H "X-Nonce: test-nonce" \
  -H "X-Signature: invalid"

预期输出:

text
HTTP/1.1 401 Unauthorized
Content-Type: application/json

{"code":"GATEWAY_UNAUTHORIZED","message":"签名校验失败","data":null,"traceId":"<ID>"}

<ID> 为动态追踪号,实际值每次不同。继续验证黑名单命中返回 403、超出令牌桶返回 429、合法请求到达下游后只能看到网关注入的商户号和客户端 IP,才算完成验收。

上线前检查

  • 只允许受信负载均衡器连接网关,并统一清洗转发头
  • 黑白名单、密钥和限流阈值使用动态配置,变更必须留审计记录
  • 拒绝响应不泄露签名原文、密钥、内部服务地址或具体校验细节
  • 网关与下游统一传递 X-Trace-Id,但业务服务仍需校验调用来自内部网络
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

网关访问控制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通