如何在 AWS Lambda 函数 URL 中安全获取客户端真实 IP 地址

云涛吖_8200

云涛吖_8200

2026-11-17

372人浏览

原创

如何在 AWS Lambda 函数 URL 中安全获取客户端真实 IP 地址

本文详解如何在 Spring Cloud Function + AWS Lambda 函数 URL(v2.0 负载格式)场景下,正确提取并校验客户端源 IP,避免误用不可信的 X-Forwarded-For 头,确保 Stripe Webhook 等敏感接口的 IP 白名单机制安全可靠。

本文详解如何在 spring cloud function + aws lambda 函数 url(v2.0 负载格式)场景下,正确提取并校验客户端源 ip,避免误用不可信的 `x-forwarded-for` 头,确保 stripe webhook 等敏感接口的 ip 白名单机制安全可靠。

AWS Lambda 函数 URL 默认使用 Payload Format Version 2.0(如您日志中 "version": "2.0" 所示),而 APIGatewayProxyRequestEvent 是为 API Gateway REST/HTTP API 的 v1.0 格式设计的——它不包含 requestContext.http.sourceIp 字段,因此无法直接访问真实客户端 IP。强行尝试从 headers.get("x-forwarded-for") 获取 IP 存在严重安全隐患:该头可被恶意客户端伪造,绝不适用于安全敏感的白名单校验场景。

正确的解决方案是:改用 APIGatewayV2HTTPEvent 类型作为函数输入参数。该类型原生支持 v2.0 负载结构,其 getRequestContext().getHttp().getSourceIp() 方法可直接、可信地返回经 Lambda 服务验证的真实源 IP(即 $.requestContext.http.sourceIp)。

✅ 正确实现步骤

  1. 添加依赖(确保使用支持 v2 事件的 AWS Java Events 库):

    <!-- Maven -->
    <dependency><groupid>com.amazonaws</groupid><artifactid>aws-lambda-java-events</artifactid><version>3.11.4</version><!-- 推荐 ≥3.11.0 --></dependency>
  2. 修改函数签名与逻辑(关键变更):

    import com.amazonaws.services.lambda.runtime.events.APIGatewayV2HTTPEvent;
    import com.amazonaws.services.lambda.runtime.events.APIGatewayV2HTTPResponse;

@Bean public Function processEvent( StripeEventService stripeEventService) { return request -> {

    // ✅ 安全获取真实源 IP(Lambda 自动注入,不可伪造)
    String sourceIp = request.getRequestContext()
                             .getHttp()
                             .getSourceIp();

    // ? 拒绝非 Stripe 官方 IP(参考:https://stripe.com/docs/ips)
    if (!isStripeIp(sourceIp)) {
        return new APIGatewayV2HTTPResponse()
            .withStatusCode(403)
            .withBody("Forbidden: Invalid source IP");
    }

    String jsonPayload = request.getBody();
    String sigHeader = request.getHeaders().get("stripe-signature");

    if (sigHeader == null) {
        return new APIGatewayV2HTTPResponse()
            .withStatusCode(400)
            .withBody("Invalid signature");
    }

    try {
        Event event = Webhook.constructEvent(jsonPayload, sigHeader, "whsec_...");
        stripeEventService.processEvent(event);
        return new APIGatewayV2HTTPResponse()
            .withStatusCode(200)
            .withBody("Event processed");
    } catch (SignatureVerificationException e) {
        return new APIGatewayV2HTTPResponse()
            .withStatusCode(400)
            .withBody("Invalid signature");
    }
};

}

private boolean isStripeIp(String ip) { // 实际生产中应使用 Stripe 提供的官方 IP 段列表(定期更新) // 示例仅作示意,务必替换为最新 CIDR 列表 return ip != null && ( ip.startsWith("192.168.1.") || // ⚠️ 替换为真实 Stripe CIDR(如 151.101.0.0/20) "204.236.220.1".equals(ip) // ⚠️ 同上 ); }


### ⚠️ 重要注意事项

- **不要混用事件类型**:若使用 `APIGatewayV2HTTPEvent`,则必须确保 Lambda 的触发源为 **Function URL 或 API Gateway HTTP API(v2.0)**;REST API 仍需 `APIGatewayProxyRequestEvent`。
- **IP 白名单需动态维护**:Stripe 公开的 [Webhook IP 地址范围](https://stripe.com/docs/ips) 可能调整,请通过其官方文档或 API 定期同步 CIDR 列表,避免硬编码。
- **Spring Cloud Function 适配器兼容性**:确认 `spring-cloud-function-adapter-aws` 版本 ≥ 4.0.0(对应 Spring Boot 3.x),旧版本可能默认强制解析为 v1 事件,需检查 `AwsProxyRequestHandler` 配置。
- **日志调试建议**:首次部署时,可临时打印 `request.toString()` 验证事件结构是否为 v2.0 格式,确认 `requestContext.http.sourceIp` 字段存在。

通过以上改造,您即可在函数 URL 场景下,以零信任原则安全、精准地完成源 IP 校验,为 Stripe Webhook 构建坚实的第一道网络防线。
PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
lambda表达式
lambda表达式

Lambda表达式是一种匿名函数的简洁表示方式,它可以在需要函数作为参数的地方使用,并提供了一种更简洁、更灵活的编码方式,其语法为“lambda 参数列表: 表达式”,参数列表是函数的参数,可以包含一个或多个参数,用逗号分隔,表达式是函数的执行体,用于定义函数的具体操作。本专题为大家提供lambda表达式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.15

1171

5

python lambda函数
python lambda函数

本专题整合了python lambda函数用法详解,阅读专题下面的文章了解更多详细内容。

2025.11.08

345

7

Python lambda详解
Python lambda详解

本专题整合了Python lambda函数相关教程,阅读下面的文章了解更多详细内容。

2026.01.05

694

7

C++ Lambda 表达式与函数式编程
C++ Lambda 表达式与函数式编程

深入讲解 C++ Lambda 表达式与函数式编程范式,涵盖 Lambda 基础语法与返回值推导、值捕获与引用捕获的区别与陷阱、初始化捕获(C++14 广义捕获)、泛型 Lambda(auto 参数)、mutable 关键字修改捕获变量、std::function 类型擦除与函数包装、std::bind 参数绑定(及其被 Lambda 替代的趋势)、Lambda 在 STL 算法(sort/transform/for_each/remo

2026.05.06

869

22

Java 函数式接口与 Lambda 进阶技巧
Java 函数式接口与 Lambda 进阶技巧

在 Java Stream 基础之上进一步深入函数式编程,涵盖 @FunctionalInterface 注解与自定义函数式接口设计、四种方法引用(静态/实例/对象/构造器)的使用场景、Lambda 中的 effectively final 变量捕获规则、函数组合(andThen/compose)与柯里化技巧、Comparator 链式比较器构建、CompletableFuture 异步函数式编排、Reactor / RxJava 响应

2026.05.08

468

28

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

60

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习