如何在AWS CDK中为全代理LambdaRestApi配置全局Cognito Authorizer
核心结论
你完全不需要拆解已有的全代理LambdaRestApi,也不需要退回手写底层CloudFormation配置,CDK apigateway模块的原生能力,完全可以实现「授权器默认覆盖所有API方法」的需求。
具体实操步骤
第一步:创建Cognito授权器实例
直接使用CDK原生提供的CognitoUserPoolsAuthorizer关联你已有的用户池即可,不需要自定义授权逻辑:
const cognitoAuthorizer = new apig.CognitoUserPoolsAuthorizer(this, 'ProxyApiCognitoAuth', { cognitoUserPools: [userPool], // 配置和控制台默认一致的Bearer token取数规则 identitySource: 'method.request.header.Authorization', authorizerName: 'proxy-api-cognito-authorizer' });
第二步:全局绑定授权器,两种无侵入方案二选一
- 创建API阶段直接配置(最优方案)
LambdaRestApi本身继承自通用的RestApi,构造参数原生支持defaultMethodOptions字段,这个配置会自动应用到全代理模式下生成的所有方法(包括根路径的ANY方法、{proxy+}全路径匹配的ANY方法),不需要手动遍历资源:const proxyApi = new apig.LambdaRestApi(this, "HelloFoodSecureProxyApi", { handler: proxyHandlerLambdaFunction, // 直接设置全局默认授权规则 defaultMethodOptions: { authorizer: cognitoAuthorizer } }); - 如果API已经初始化完成,不需要重构现有代码
不需要改动原有LambdaRestApi的搭建逻辑,直接引用自动生成的核心路径资源,给上面绑定的所有方法统一设置授权器即可:// 获取全代理{proxy+}路径的资源引用 const proxyMatchResource = proxyApi.root.getResource('{proxy+}'); // 给根路径的所有方法绑定授权器,避免根路径无鉴权可访问 proxyApi.root.methods.forEach(method => method.authorizer = cognitoAuthorizer); // 给所有匹配到的代理路径的方法绑定授权器 proxyMatchResource.methods.forEach(method => method.authorizer = cognitoAuthorizer);
实操注意点
- 千万别只给
{proxy+}资源绑定授权器,很容易遗漏API根路径的ANY方法,导致不带认证直接访问API根地址也能正常响应。 - 如果后续需要给个别接口开放公开访问,不需要调整全局配置,只要给对应方法单独设置
authorizer: apig.Authorizer.none()就能覆盖全局规则。 - 你之前考虑的通过
add_property_override手动修改底层CloudFormation配置的方案完全不必要,以上原生配置生成的资源效果和手动override完全一致,且维护性、可读性更高,完全不需要把全代理API拆成零散的手动资源配置。
内容的提问来源于stack exchange,提问作者zachd1_618
相关产品推荐
相关产品推荐

