Username 认证
Username 认证使用配置文件预设客户端用户名与密码,支持通过 HTTP API 管理认证数据。
Username 认证不依赖外部数据源,使用上足够简单轻量。
插件:
emqx_auth_username
哈希方法
Username 认证默认使用 sha256 进行密码哈希加密,可在 etc/plugins/emqx_auth_username.conf
中更改:
# etc/plugins/emqx_auth_username.conf
## Value: plain | md5 | sha | sha256
auth.user.password_hash = sha256
配置哈希方法后,新增的预设认证数据与通过 HTTP API 添加的认证数据将以哈希密文存储在 EMQ X 内置数据库中。
预设认证数据
可以通过配置文件预设认证数据,编辑配置文件:etc/plugins/emqx_auth_username.conf
# etc/plugins/emqx_auth_username.conf
## 第一组认证数据
auth.user.1.username = admin
auth.user.1.password = public
## 第二组认证数据
auth.user.2.username = wivwiv
auth.user.2.password = public
插件启动时将读取预设认证数据并加载到 EMQ X 内置数据库中,节点上的认证数据会在此阶段同步至集群中。
预设认证数据在配置文件中使用了明文密码,出于安全性与可维护性考虑应当避免使用该功能。
使用 HTTP API 管理认证数据
添加认证数据
API 定义:
# Request
POST api/v4/auth_username
{
"username": "emqx_u",
"password": "emqx_p"
}
# Response
{
"code": 0
}
使用 POST 请求添加 username 为 emqx_u
password 为 emqx_p
的认证信息,返回信息中 code = 0
即为成功。
查看已经添加的认证数据
API 定义:
# Request
GET api/v4/auth_username
# Response
{
"code": 0,
"data": ["emqx_u"]
}
更改指定用户名的密码
指定用户名,传递新密码进行更改,再次连接时需要使用新密码进行连接:
API 定义:
# Request
PUT api/v4/auth_username/${username}
{
"password": "emqx_new_p"
}
# Response
{
"code": 0
}
查看指定用户名信息
指定用户名,查看相关用户名、密码信息,注意此处返回的密码是使用配置文件指定哈希方式加密后的密码:
API 定义:
# Request
GET api/v4/auth_username/${username}
# Response
{
"code": 0,
"data": {
"username": "emqx_u",
"password": "091dc8753347e7dc5d348508fe6323735eecdb84fa800548870158117af8a0c0"
}
}
删除认证数据
删除指定认证数据:
API 定义:
# Request
DELETE api/v4/auth_username/${username}
# Response
{
"code": 0
}