JWT 认证

打开，点击左侧的“模块”选项卡，选择“添加模块”：

然后选择“认证鉴权”下的“JWT 认证”：

JWT 认证提供了以下配置项：

密钥：签发 JWT 时使用的密钥。这里将用于验证 EMQX 收到的 JWT 是否合法，适用于 HMAC 算法签发的 JWT。
公钥文件：将用于验证 EMQX 收到的 JWT 是否合法，适用于 RSA 或 ECDSA 算法签发的 JWT。
JWKS 服务器地址：EMQX 将从 JWKS 服务器定期查询最新的公钥列表，并用于验证收到的 JWT 是否合法，适用于 RSA 或 ECDSA 算法签发的 JWT。
验证声明字段：是否需要验证 JWT Payload 中的声明与“声明字段列表”一致。
声明字段列表：用于验证 JWT Payload 中的声明是否合法。最常见的用法是，添加一个键为值为 %u 的键值对，%u 作为占位符将在运行时被替换为客户端实际连接时使用的 Username，替换后的值将被用于与 JWT Payload 的同键声明的值比较，以起到 JWT 与 Username 一一对应的效果。声明字段列表中目前支持以下两种占位符：
1. ：将在运行时被替换为客户端连接时使用的 Client ID。

配置完成后点击“添加”按钮即可成功添加 JWT 认证模块。

客户端使用用户名或密码字段携带 JWT（取决于模块配置），发起连接时 EMQX 使用配置中的密钥、证书进行解密，如果能成功解密则认证成功，否则认证失败。

默认配置下启用 JWT 认证后，你可以通过任意用户名+以下密码进行连接：

提示

上述JWT Token仅做测试使用，可根据自己的业务需求用相关工具生成。此处提供一个在线生成工具：

、sub 和 all 用于指定该客户端允许发布和订阅的主题白名单。

可以在主题白名单中使用以下占位符:

例如:

JWT ACL 检查时如果发现这个 Token 已经超期 (exp 字段指定)，那么所有的操作都将被禁止。客户端必需获取一个新的有效 JWT 在进行重连。

如果想要让一个 JWT 永不超期，可以在 JWT 中不提供字段即可。

注意