EMQX_AUTH_USERNAME 使用指南
Posted emqx
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了EMQX_AUTH_USERNAME 使用指南相关的知识,希望对你有一定的参考价值。
在阅读该教程之前,假定你已经了解 MQTT、EMQX 的简单知识。
emqx_auth_username 它通过比对每个终端的接入的 username
和 password
与 EMQ X 中存储的是否一致来实现终端接入的控制。其功能逻辑如下:
emqx_auth_username 目前版本仅提供了 连接认证 的功能。且提供了 CLI 和 REST API 来进行管理当前集群中的 Username 库
插件配置项说明
在这里给出了其 3.1.0 版本默认的配置文件。其内容非常的简单,主要包括:
1.Password 密文加密类型
终端在连接时,必须采用对用加密类型的密文才可以成功连接
## Password hash.
##
## Value: plain | md5 | sha | sha256
auth.user.password_hash = sha256
Username 管理
CLI 命令
在成功启动 emqx_auth_username
该插件时,会向 EMQ X
注册一些 CLI 命令以在运行时管理 username
:
$ ./bin/emqx_ctl users
users list
users add <Username> <Password>
users update <Username> <NewPassword>
users del <Username>
REST API
在成功启动 emqx_auth_username
该插件时,会开启对应的 REST API 用于在运行时管理 username
获取所有的 username
# Request
GET api/v3/auth_username
# Response
"code": 0,
"data": ["username1"]
添加一个 username:
# Request
POST api/v3/auth_username
"username": "some_name",
"password": "password"
# Response
"code": 0
更新某 username 的密码 :
# Request
PUT api/v3/auth_username/$NAME
"password": "password"
# Response
"code", 0
查看某 username 的密码 (密文):
# Request
GET api/v3/auth_username/$NAME
# Response
"code": 0,
"data":
"username": "some_username",
"password": "hashed_password"
删除某 username:
# Request
DELETE api/v3/auth_username/$NAME
# Response
"code": 0
更多信息请访问我们的官网 emqx.io,或关注我们的开源项目 github.com/emqx/emqx ,详细文档请访问 官方文档。
以上是关于EMQX_AUTH_USERNAME 使用指南的主要内容,如果未能解决你的问题,请参考以下文章