Client ID认证

1.插件

　　Client ID 认证使用配置文件预设客户端Client ID 与密码，支持通过 HTTP API 管理认证数据。

　　Client ID 认证不依赖外部数据源，使用上足够简单轻量，使用该种认证方式时需要开启 emqx_auth_clientid插件，直接在DashBoard中开启即可，

 

2.哈希方法

　　Client ID 认证默认使用 sha256 进行密码哈希加密，可在 etc/plugins/emqx_auth_clientid.conf 中更改：　

　　　　# etc/plugins/emqx_auth_clientid.conf

　　　　## Value: plain | md5 | sha | sha256

　　　　auth.client.password_hash = sha256

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

 

3.预设认证数据

　　可以通过配置文件预设认证数据，编辑配置文件： etc/plugins/emqx_auth_clientid.conf

　　　　## Value: plain | md5 | sha | sha256

　　　　auth.client.password_hash = sha256

　　插件启动时将读取预设认证数据并加载到 EMQ X 内置数据库中，节点上的认证数据会在此阶段同步至集群中。

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

 

4.HTTP API 管理认证

　　我们使用VSCode来通过EMQ X的API来添加和查看Client ID的认证数据。

　　1：添加认证数据API 定义： POST api/v4/auth_clientid{ "clientid": "emqx_c", "password": "emqx_p"}

　　　　####添加clientId和密码#####

　　　　POST http://{{hostname}}:{{port}}/api/v4/auth_clientid HTTP/1.1

　　　　Content-Type: {{contentType}}

　　　　Authorization: Basic {{userName}}:{{password}}

　　　　{"clientid": "emq-client1","password": "123456"}
 　　使用 POST 请求添加 clientid 为 emq-client1 password 为 123456 的认证信息，返回信息中 code = 0 即为成功。　

　　2：查看已经添加的认证数据API 定义： GET api/v4/auth_clientid

　　　　#############获取所有详细信息########

　　　　GET http://{{hostname}}:{{port}}/api/v4/auth_clientid HTTP/1.1

　　　　Content-Type: {{contentType}}

　　　　Authorization: Basic {{userName}}:{{password}} 

　　3：更改指定 Client ID 的密码API 定义： PUT api/v4/auth_clientid/${clientid}{ "password":"emqx_new_p"}

　　指定 Client ID，传递新密码进行更改，再次连接时需要使用新密码进行连接：

　　　　#############更改指定 Client ID 的密码########

　　　　PUT http://{{hostname}}:{{port}}/api/v4/auth_clientid/emq-client1 HTTP/1.1

　　　　Content-Type: {{contentType}}

　　　　Authorization: Basic {{userName}}:{{password}}

　　　　{

　　　　　　"password": "654321"

　　　　}

　　4：查看指定 Client ID 信息API 定义： GET api/v4/auth_clientid/${clientid}

　　指定 Client ID，查看相关 Client ID、密码信息，注意此处返回的密码是使用配置文件指定哈希方式加密后的密码：

　　　　#############获取指定ClientId详细信息########

　　　　GET http://{{hostname}}:{{port}}/api/v4/auth_clientid/emq-client1 HTTP/1.1

　　　　Content-Type: {{contentType}}

　　　　Authorization: Basic {{userName}}:{{password}} 

　　5：删除认证数据API 定义： DELETE api/v4/auth_clientid/${clientid}

　　删除指定 Client ID：

　　　　#############删除指定的client信息########

　　　　DELETE http://{{hostname}}:{{port}}/api/v4/auth_clientid/emq-client1 HTTP/1.1

　　　　Content-Type: {{contentType}}

　　　　Authorization: Basic {{userName}}:{{password}}

 

5MQTTX客户端验证

　　

　　用户名随便输一个，可以随便填写