Google Cloud Endpoints POST接口返回Jwt issuer未配置401错误求助
错误核心定位
Jwt issuer is not configured是Google Cloud Endpoints网关层返回的校验错误,请求根本未到达后端服务,和项目使用的Node.js/Python依赖无任何关联,无需排查后端依赖配置。
报错本质是:网关收到请求携带的JWT令牌后,发现令牌的iss(签发者)字段,不在当前请求接口绑定的安全策略允许的签发者白名单内,因此直接拒绝请求。
对照现有配置的问题点与修复方案
结合你提供的openapi.yaml全文,以下硬伤会直接触发该报错:
- 无效的顶层全局JWT配置
写在文档根节点的x-google-issuer、x-google-jwks_uri字段对Endpoints无实际作用。JWT签发者的配置规则要求必须嵌套在securityDefinitions下对应安全策略的节点内,写在根节点的这类字段不会被网关加载为校验白名单。 - /echo POST接口的安全策略覆盖不全
目前/echo接口绑定的安全校验规则为:
仅允许security: - google_id: [] api_key: []iss=accounts.google.com的Google用户身份JWT通过。如果实际请求携带的JWT是服务账号签发(iss值为xxxxx.iam.gserviceaccount.com)、或是Firebase签发的用户令牌(iss值为https://securetoken.google.com/mpa-work-flows),因为这两个签发者没有加入该接口的允许列表,网关就会直接抛出“未配置该JWT签发者”的报错。- 修复方式:如果接口需要支持多种身份来源,就把对应安全策略添加到security列表中。比如要同时支持普通Google用户、服务账号访问,需要将规则调整为:
security: - google_id: [] api_key: [] - google_sa: [] api_key: []
- 修复方式:如果接口需要支持多种身份来源,就把对应安全策略添加到security列表中。比如要同时支持普通Google用户、服务账号访问,需要将规则调整为:
- 直接导致配置加载失败的拼写错误
现有yaml里有三处拼写错误,会让对应安全策略完全失效,间接造成签发者无法被网关识别:google_sa的x-google-jwks_uri值中混入了#字符:当前值为https://www.googleapis.com/robot/v1/metadata/x509/#xxxxx.iam.gserviceaccount.com,特殊字符会导致公钥拉取失败,对应签发者的配置直接失效firebase安全策略的JWT位置字段名写错:当前写的是x-google-locations,正确字段名是x-google-jwt-locations,字段名错误会导致网关无法读取JWT的来源请求头,该策略的所有配置都不会生效- 占位配置未替换为真实值:比如
google_id下的x-google-audiences目前是占位符xxxxx,这个值必须和请求携带JWT中的aud(受众)字段完全一致,通常是OAuth客户端ID格式的字符串,占位符完全无法通过校验。
快速排查流程
- 先解码实际发请求时携带的JWT,直接确认
iss字段的真实值 - 对照
securityDefinitions里的所有签发者配置,确认这个iss值存在对应的有效配置项 - 确认该
iss对应的安全策略,已经绑定到正在调用的接口的security列表中 - 重新推送
openapi.yaml到Endpoints后,等待1-2分钟让网关配置全局生效,再发起测试
内容的提问来源于stack exchange,提问作者RJ Villamer
相关产品推荐
相关产品推荐

