API 网关
API 网关
文档指南
请输入
- 文档首页
API 网关用户指南插件中心认证鉴权JWT 认证鉴权
复制全文
下载 pdfJWT 认证鉴权
文档反馈
问问助手认证对应访问 API 网关的终端用户的身份信息。开启认证后，在调用 API 网关时携带认证信息的请求才能访问网关发布的服务，安全级别更高。本文介绍如何配置 JWT 认证鉴权。
背景信息
- JWT 认证：JSON Web Token（JWT）是一个轻量级的认证规范，这个规范允许我们使用 JWT 在用户和服务器之间传递安全可靠的信息。其本质是一个 Token，是一种紧凑的 URL 安全方法，用于在网络通信的双方之间传递。详情请参见 官方文档。
- API 网关的身份认证信息目前与服务绑定，服务开启 JWT 认证后，在访问服务对应域名下的所有请求中，只有携带 JWT Token 的请求才能访问成功。
前提条件
- 已创建实例，详情请参见 创建实例。
- 已创建服务，详情请参见 创建服务。
操作步骤
步骤一：开启 JWT 认证
- 登录 API 网关控制台。
- 在顶部导航栏，选择目标地域。
- 在左侧导航栏选择 路由管理 > 服务列表（域名）。在服务列表中，单击目标服务名称，进入服务概览页面。
- 选择 认证管理 页签，单击
图标，弹出 认证管理 对话框。
-
- 启用 认证信息 开关。
-
- 单击 确认，完成配置。
步骤二：生成 JWT Token
注意
JWT Token 从签发时起，有效期为 7 天。请在到期前及时获取新的 JWT Token，避免影响业务。
- 在左侧导航栏选择 路由管理 > 服务列表。在服务列表中，单击目标服务名称，进入服务概览页面。
- 单击 认证管理，切换至 认证管理 页签。
- 在 JWT 认证信息 页面，单击 生成认证 Token，获取 JWT Token。您也可以在 调用示例 区域查看调用示例。
结果验证
在 API 网关的服务中开启 JWT 认证，并生成 JWT 认证信息后。仅携带该认证信息的访问请求，能够通过 API 网关访问到后端 Upstream。
- 使用 API 网关实例中配置的域名访问服务，当未携带 JWT 认证信息时。
预期结果如下，表示认证失败，无法通过 API 网关访问到后端的服务。
- 使用 API 网关实例中配置的域名访问服务，当携带 JWT 认证信息时。
预期结果如下，表示能够通过 API 网关访问到后端的服务。
相关文档
最近更新时间：2025.07.04 14:55:28
这个页面对您有帮助吗？
有用
有用
无用
无用