Username 认证

    Username 认证不依赖外部数据源,使用上足够简单轻量。

    插件:

    Username 认证默认使用 sha256 进行密码哈希加密,可在 中更改:

    1. # etc/plugins/emqx_auth_username.conf
    2. ## Value: plain | md5 | sha | sha256
    3. auth.user.password_hash = sha256

    配置后,新增的预设认证数据与通过 HTTP API 添加的认证数据将以哈希密文存储在 EMQ X 内置数据库中。

    可以通过配置文件预设认证数据,编辑配置文件:etc/plugins/emqx_auth_username.conf

    预设认证数据在配置文件中使用了明文密码,出于安全性与可维护性考虑应当避免使用该功能。

    预设认证数据无法通过 API 修改、删除,请慎用。

    添加认证数据

    API 定义:

    1. POST api/v4/auth_username
    2. {
    3. "username": "emqx_u",
    4. "password": "emqx_p"
    5. }
    6. # Response
    7. {
    8. "code": 0
    9. }

    使用 POST 请求添加 username 为 emqx_u password 为 emqx_p 的认证信息,返回信息中 code = 0 即为成功。

    查看已经添加的认证数据

    API 定义:

    更改指定用户名的密码

    API 定义:

    1. # Request
    2. PUT api/v4/auth_username/${username}
    3. "password": "emqx_new_p"
    4. # Response
    5. {
    6. "code": 0
    7. }

    查看指定用户名信息

    指定用户名,查看相关用户名、密码信息,注意此处返回的密码是使用配置文件指定哈希方式加密后的密码:

    API 定义:

    删除认证数据

    删除指定认证数据:

    API 定义:

    1. # Request
    2. DELETE api/v4/auth_username/${username}
    3. # Response
    4. {