Skip to content

使用 Redis 进行密码认证

作为密码认证方式的一种,EMQX 支持通过集成 Redis 进行密码认证。EMQX 支持三种 Redis 部署模式:单节点、Redis SentinelRedis Cluster,本节将介绍如何进行相关配置。

前置准备:

数据结构与查询指令

Redis 认证器支持使用 Redis hashes 存储认证数据,用户需要提供一个查询指令模板,且确保查询结果包含以下字段:

  • password_hash: 必需,数据库中的明文或散列密码字段
  • salt: 可选,为空或不存在时视为空盐(salt = ""
  • is_superuser: 可选,标记当前客户端是否为超级用户,默认为 false

添加我们希望添加一位名用户名为 emqx_u、密码为 public、盐值为 slat_foo123、散列方式为 sha256 且超级用户标志为 true 的用户:

bash
>redis-cli
127.0.0.1:6379> HSET mqtt_user:emqx_u is_superuser 1 salt slat_foo123 password_hash 44edc2d57cde8d79c98145003e105b90a14f1460b79186ea9cfe83942fc5abb5
(integer) 0

对应的配置参数为:

  • 密码加密方式:sha256
  • 加盐方式:suffix
  • 命令:HMGET mqtt_user:${username} password_hash salt is_superuser

TIP

password_hash 这一字段名称直观表明用户应当在数据库中存储散列密码。但鉴于 Redis 没有类似 MySQL 的 as 语法,我们保留了 4.x 对 password 的兼容。

所以,我们也可以将 cmd 配置为 HMGET mqtt_user:${username} password salt is_superuser

通过 Dashboard 配置

在 EMQX Dashboard 页面上点击左侧导航栏的访问控制 -> 客户端认证,在随即打开的客户端认证页面,单击**+ 创建**,依次选择认证方式Password-Based数据源Redis,点击下一步进入配置参数页签:

Authentication with redis

您可按照如下说明完成相关配置:

连接:在此部分完成到 Redis 数据库的连接设置。

  • 部署模式:选择 Redis 数据库的部署模式,可选值:单节点SentinelCluster
  • 服务列表):填入 Redis 服务器地址 (host:port) ;当部署模式选为 Sentinel 或 Cluster,您需在此提供所有相关 Redis 服务器的地址,不同地址之间以 , 分隔,格式为 host1:port1,host2:port2,...
  • Sentinel 名字:指定 Redis Sentinel 配置需要的主服务器名称,仅需在部署模式设置为 Sentinel 时设置。
  • 数据库:整数,用于指定 Redis 数据库的 Index。
  • 密码(可选):填入认证密码。

TLS 配置:配置是否启用 TLS。

连接配置:在此部分设置并发连接。

  • Pool size(可选):填入一个整数用于指定从 EMQX 节点到 Redis 数据库的并发连接数;默认值:8

认证配置:在此部分进行认证加密算法相关的配置。

  • 密码加密方式:选择存储密码时使用的散列算法,如 plain、md5、sha、bcrypt、pbkdf2 等。
  • 选择 plainmd5shasha256sha512 算法,需配置:
    • 加盐方式:用于指定盐和密码的组合方式,除需将访问凭据从外部存储迁移到 EMQX 内置数据库中外,一般不需要更改此选项;可选值:suffix(在密码尾部加盐)、prefix(在密码头部加盐)、disable(不启用)。注意:如选择 plain,加盐方式应设为 disable
  • 选择 bcrypt 算法,需配置:
    • Salt Rounds:指定散列需要的计算次数(2^Salt Rounds),也称成本因子。默认值:10,可选值:5~10;数值越高,加密的安全性越高,因此建议采用较大的值,但相应的用户验证的耗时也会增加,您可根据业务需求进行配置。
  • 选择 pkbdf2 算法,需配置:
    • 伪随机函数:指定生成密钥使用的散列函数,如 sha256 等。
    • 迭代次数:指定散列次数,默认值:4096
    • 密钥长度(可选):指定希望得到的密钥长度。如不指定,密钥长度将由伪随机函数确定。
  • 命令:Redis 查询命令

通过配置文件配置

您可通过配置文件完成相关配置。

以下为各部署模式下的配置文件示例: