讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

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

云涛吖_8200

云涛吖_8200

发布时间:2026-11-17 08:39:12

|

372人浏览过

|

来源于php中文网

原创

如何在 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 构建坚实的第一道网络防线。

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

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
lambda表达式
lambda表达式

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

1171

2023.09.15

python lambda函数
python lambda函数

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

345

2025.11.08

Python lambda详解
Python lambda详解

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

694

2026.01.05

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

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

869

2026.05.06

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

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

468

2026.05.08

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

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

140

2026.11.12

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

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

100

2026.11.12

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

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

60

2026.11.12

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

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

160

2026.11.06

热门下载

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

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn