adrianhesketh/jwtproxy

JWT认证反向代理镜像

镜像概述

adrianhesketh/jwtproxy是一款轻量级反向HTTP代理工具，核心功能是通过JSON Web Token（JWT）验证传入请求的合法性，过滤无效请求并将合法请求转发至指定后端服务，为API访问提供安全认证保障。

核心功能

1. 验证请求头中Authorization字段的JWT有效性（包括签名、过期时间、签发者等）
2. 根据JWT的issuer字段匹配对应的公钥进行签名验证
3. 将验证通过的请求转发至后端服务
4. 支持通过配置文件或环境变量设置公钥映射、监听端口、后端URL等参数

使用场景

• 微服务架构中服务间的身份认证与访问控制
• 对外提供API接口时的安全验证
• 需要对HTTP请求进行身份校验的业务场景

配置说明

1. 公钥配置文件：创建keys.json文件，存储issuer到公钥的映射（公钥需将换行符替换为\n）

   json
   {
       "example.com": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxFj26fqmulXntc7kCp9t\nMs6MEQUsk2r16Jd6k+aZSaLBo0dVgP77q1os10gZT4N0gYH6NsbVqP4+wWAUIDie\nmhpxq986z5mtB/lGvmHmaQcK/bOnEvcLWinHJZIla1m2RF7diN5/WBRNh8CyYMiW\n+BV/6dngknBtP7bDpnCkYrySaOQtKRvrech1UFRKgQjD8bprrcUmOFWYrmKe2NCx\ncQs9RhYuACt3Du2Z4VwVWN2xvL5LlZdWK7jLENe3MkOZU5WcwA7n+K/tulqA9uNR\nv8cRIL/y8BUwUsUoqBiyVZXQUa7BgE82GoTXtv3uqkN/yZxnlEcaJW5BD1nFzuvu\nyQIDAQAB\n-----END PUBLIC KEY-----"
   }
   

2. 环境变量参数：
   • JWTPROXY_LISTEN_PORT：代理监听端口
   • JWTPROXY_REMOTE_URL：后端服务URL
   • JWTPROXY_CONFIG：公钥配置文件路径

部署示例

Docker Run命令

bash
docker run --link hopeful_pike -p 9090:9090/tcp --rm \
  -e "JWTPROXY_LISTEN_PORT=9090" \
  -e "JWTPROXY_REMOTE_URL=http://hopeful_pike:8080" \
  -e "JWTPROXY_CONFIG=keys.json" \
  adrianhesketh/jwtproxy

测试请求

携带有效JWT发送请求：

bash
curl -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOiIxNDg2MzkyMjAwIiwiZXhwIjoiMTU4NjM5MjIwMCIsImlzcyI6ImV4YW1wbGUuY29tIn0.McHwUVbe96y-vaTOExPjANm8e8p0v6I7puPf74SV7Jn-QYprrhLlklnBP4MEF77v0LIBUFKgzpOMfldCONId3ktOFOf0117x9iWG3J-Zf6Ni3HinhA9U1pPU7_OhTtkXacmgats8tLWAqmOz46NeyAmHS_dkvodUUPpcHY-AqQtzM4ql6RZpMDstz5dFJWZh9P0_prPknoI-argt2jn-KGajCOIghcGxNarylq5oX62rT9AavavyWGnJW0zLnP9qtIuChzigU542Nbg7y6_E7FaVA2cPICPuiPehn6vVTKuVil0o2SJgFD2J2HQfxa0iDrc8HzbubMGJcw7Vlpkk0w" \
http://localhost:9090