tencent cloud

注册配置治理

文档注册配置治理云原生网关实践教程认证鉴权配置 JWT 认证鉴权

配置 JWT 认证鉴权

PDF
聚焦模式
字号
最后更新时间： 2026-05-07 17:58:02

操作场景

JWT（JSON Web Token） 是现代 Web 服务中经常用到的认证和授权方式。Kong 能够验证使用 HS256 或 RS256 签名的 JWT 的请求。您可以为消费者配置 JWT 凭据（公钥和私钥），并用这些凭据签署他们的 JWT。 Kong 支持通过 Query、Cookie、Header 传递 JWT Token。如果 JWT 的签名通过验证，Kong 将把请求代理到上游服务，否则将丢弃请求。 JWT 常见的三种签名算法为 HS256、RS256 和 ES256，区别在于消息签名与签名验证需要的 key 不同。
HS256 使用同一个 secret_key 进行签名和验证，适用于集中式认证场景，签名和验证都必须由可信方进行。
RS256 是使用 RSA 私钥进行签名，使用 RSA 公钥进行验证，因此可以将验证委托给其他应用。
ES256 使用私钥签名，公钥验证，但是拥有更短的签名长度。
本文介绍如何在 Kong 云原生网关上通过 JWT 插件实现下述常见 JWT 认证鉴权场景：
对使用 HS256 签名的请求进行认证鉴权。
对使用 RS256 签名的请求进行认证鉴权。

前置条件

已购买 Kong 网关实例，详情请参见 实例管理。
配置了后端（Service）以及路由（Route）。

插件配置

字段名称
字段说明
uri param names
用于获取 JWT Token 的 Query 参数列表，当 JWT Token 配置在 URI 时，设置此属性。
cookies names
用于获取 JWT Token 的 Cookie 参数列表，当 JWT Token 配置在Cookie时，设置此属性。
key claim name
Credential 的 key 值，对应的 JWT Claim 的内容，默认为 iss。
secret is base64
Credential 的 secret 是否进行 base64 编码。
claims to verify
Kong 进行校验的 Claims，支持 exp 或 nbf。
anonymous
认证失败时，判断是否作为匿名Consumer。默认为空，表明请求失败时返回4xx。
run on preflight
插件是否应在 OPTIONS 预检请求上运行（并尝试进行身份验证）。 如果设置为 false，则将始终允许 OPTIONS 请求。
maximum expiration
JWT Token 过期时间，支持0-31536000（365天）。当设置该值时，需要在 claims to verify 中指定 exp。默认值为0，表示无限期。当 Token 过期时请求将被拒绝，返回 HTTP 403。请注意，配置该值时应考虑潜在的时钟偏差。
header names
用于获取 JWT Token 的 Header 参数列表。当 JWT Token 配置在 URI 时，设置此属性。

操作步骤

场景一：对使用 HS256 签名的请求进行认证鉴权

步骤1：创建 Consumer

1. 登录 TSF 控制台，进入需要配置限流插件的 Kong 网关实例详情页，在 Konga 控制台页面查看管理控制台登录方式。
2. 登录到 Konga 控制台，进入 Consumer 详情页，选择需要配置访问控制的用户（如clare），单击 Credentials Tab，选择 JWT，单击 创建 JWT，为该用户创建一个 JWT Token 作为访问凭证。


3. 配置 JWT 相关参数。
配置项
描述
key
对应 JWT Claims 的 issuer，即签发人。留空则自动生成。
algorithm
JWT Token 签名所使用的加密算法，支持 HS256 和 RS256。本场景设置为 HS256。
secret
当签名算法为 HS256 时，设置 secret，用于验证签名，留空则自动生成。



4. 查看生成的用户凭证。


5. 使用程序生成对应的 JWT Token。



步骤2：绑定JWT插件

1. 进入需要认证的 Service，单击 ADD PLUGIN，在插件市场的 Authentication 分组中选择 Jwt 插件，单击 Add Plugin。


2. 填写 JWT Token 校验的信息，单击 ADD PLUGIN。



步骤3：测试请求

1. 不携带 JWT Token 请求服务，该请求被拒绝，返回401。
curl -i xxxxxxx/test

HTTP/1.1 401 Unauthorized
Connection: keep-alive
Content-Length: 26
Content-Type: application/json; charset=utf-8
Date: Tue, 29 Nov 2022 12:55:33 GMT
Server: kong/2.5.1
X-Kong-Response-Latency: 23

{"message":"Unauthorized"}
2. 携带 JWT Token 请求服务，请求成功。
curl -i 'http://xxxxxx/test' \\
--header 'Authorization: Bearer eyJhbGciOixxxxxxxxxxI6IkpXVCJ9.eyJpc3MiOiJoUXY4eGRtWxxxxxxxxxxxzFoQ0VUQnNySiJ9.APz7Kx9eIiV1CxAJUVt4i4-gvsJ56TtPxxxxxxK67VQ'

HTTP/1.1 200 OK
Connection: keep-alive
Content-Type: application/json; charset=utf-8
Date: Tue, 29 Nov 2022 12:57:38 GMT
Server: apigw/1.0.15
Vary: Accept-Encoding
Via: kong/2.5.1
X-Api-Id: api-1nxxxxkuc
X-Api-Requestid: ab873xxxxd68cac394ddc208
X-Kong-Proxy-Latency: 7
X-Kong-Upstream-Latency: 6
Content-Length: 11

hello Kong

场景二：对使用 RS256 签名的请求进行认证鉴权

步骤1：创建 Consumer

1. 登录 TSF 控制台，进入需要配置限流插件的 Kong 网关实例详情页，在配置管理页查看管理控制台登录方式。
2. 登录到 Konga 控制台，进入 Consumer 详情页，选择需要配置访问控制的用户（如clarersa），单击 Credentials Tab，选择 JWT，单击 创建 JWT，为该用户创建一个 JWT Token 作为访问凭证。


3. 配置JWT相关参数。
配置项
描述
key
对应 JWT Claims 的 issuer，即签发人。留空则自动生成。
algorithm
JWT Token 签名所使用的加密算法，支持 HS256 和 RS256。本场景设置为 RS256。
rsa_public_key
当签名算法为 RS256 时，设置公钥（PEM 格式），用于验证签名。
secret
当签名算法为 RS256 时，设置私钥（PEM 格式），用于验证签名。



4. 查看生成的用户凭证。


5. 生成对应的 JWT Token。



步骤2：绑定 JWT 插件

1. 进入需要认证的 Service，单击 ADD PLUGIN，在插件市场的 Authentication 分组中选择 Jwt 插件，单击 Add Plugin。


2. 填写 JWT Token 校验的信息，单击 ADD PLUGIN。



步骤3：测试请求

1. 不携带 JWT Token 请求服务，该请求被拒绝，返回401。
curl -i xxxxxxx/testrsa

HTTP/1.1 401 Unauthorized
Connection: keep-alive
Content-Length: 26
Content-Type: application/json; charset=utf-8
Date: Tue, 29 Nov 2022 12:55:33 GMT
Server: kong/2.5.1
X-Kong-Response-Latency: 23

{"message":"Unauthorized"}
2. 携带 JWT Token 请求服务，请求成功。
curl -i 'http://xxxxxx/testrsa' \\
--header 'Authorization: Bearer eyJhbGciOixxxxxxxxxxI6IkpXVCJ9.eyJpc3MiOiJoUXY4eGRtWxxxxxxxxxxxzFoQ0VUQnNySiJ9.APz7Kx9eIiV1CxAJUVt4i4-gvsJ56TtPxxxxxxK67VQ'

HTTP/1.1 200 OK
Connection: keep-alive
Content-Type: application/json; charset=utf-8
Date: Tue, 29 Nov 2022 12:57:38 GMT
Server: apigw/1.0.15
Vary: Accept-Encoding
Via: kong/2.5.1
X-Api-Id: api-1nxxxxkuc
X-Api-Requestid: ab873xxxxd68cac394ddc208
X-Kong-Proxy-Latency: 7
X-Kong-Upstream-Latency: 6
Content-Length: 11

hello Kong

参考

更多相关说明请参见 Kong JWT 插件官方文章。
上一篇: 使用 Bot Detection 插件拒绝爬虫请求下一篇: 使用熔断保护后端

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈