在阅读该教程之前,假定你已经了解 MQTT、MQTT 5 以及 EMQ X 的简单知识 。
【基于 MySQL 的 EMQ X Auth & ACL】emqx-auth-MySQL 它通过检查每个终端接入的 username 和 password 是否与用户指定 的 MySQL 数据库中存储的信息一致来实现对终端的访问控制 。其功能逻辑如下:

文章插图
本文假设 MySQL 已经安装在您的机器上,并且您可以连接到 MySQL 服务器 。注:EMQ X 开源版至 v3.1-beta.2 为止,尚不支持 MySQL 8.0,因此以下内容仅适用于 MySQL 5.7 及以下版本 。
$ mysql --versionmysql Ver 14.14 Distrib 5.7.25, for macos10.14 (x86_64) using EditLine wrApper插件配置项说明

文章插图
mqtt.sql
emqx-auth-mysql 提供了 mqtt.sql 文件帮助用户快速创建数据表以及导入默认数据 。mqtt.sql 将会为 mqtt_acl 数据表导入以下默认规则:
mysql> select * from mqtt_acl;+----+-------+-----------+-----------+----------+--------+--------+| id | allow | ipaddr | username | clientid | access | topic |+----+-------+-----------+-----------+----------+--------+--------+| 1 | 1 | NULL | $all | NULL | 2 | # || 2 | 0 | NULL | $all | NULL | 1 | $SYS/# || 3 | 0 | NULL | $all | NULL | 1 | eq # || 4 | 1 | 127.0.0.1 | NULL | NULL | 2 | $SYS/# || 5 | 1 | 127.0.0.1 | NULL | NULL | 2 | # || 6 | 1 | NULL | dashboard | NULL | 1 | $SYS/# |+----+-------+-----------+-----------+----------+--------+--------+6 rows in set (0.00 sec)allow - 1: allow; 0: deny
access - 1: subscribe; 2: publish; 3: publish and subscribe
以上规则分别表示:
- 允许任何用户发布除以 '$' 字符开头以外的任何主题的消息
- 拒绝任何用户订阅任何以 "$SYS/" 开头的主题
- 拒绝任何用户订阅 "#" 主题
- 允许本机用户发布任何以 "$SYS/" 开头的主题
- 允许本机用户发布发布除以 '$' 字符开头以外的任何主题的消息
- 允许 dashboard 用户订阅任何以 "$SYS/" 开头的主题
除此之外,用户可以导入自定义的 ACL 规则 。
Auth 与 ACL 功能验证
- Mac 环境安装 mosquitto
- brew install mosquitto
- 创建数据库,导入数据
- mqtt.sql 路径可根据实际情况自行改动
mysql> create database mqtt;mysql> use mqtt;mysql> source ./emqx_auth_mysql/mqtt.sqlmysql> insert into mqtt_user (id, is_superuser, username, password, salt) -> values (1, false, 'test', 'password', 'salt');mysql> insert into mqtt_acl (id, allow, ipaddr, username, clientid, access, topic) -> values (7, 0, NULL, 'test', NULL, 1, 'mytopic');mysql> exit;
- 修改配置文件
- 禁止匿名访问:
## .../etc/emqx.confallow_anonymous = false
- 配置数据库中密码的加密方式为 plain,即不加密:
## .../etc/plugins/emqx_auth_mysql.confauth.mysql.password_hash = plain
- 配置要访问的数据库以及用户名密码:
## .../etc/plugins/emqx_auth_mysql.confauth.mysql.username = rootauth.mysql.password = publicauth.mysql.database = mqtt
- 启动 EMQ X 与 emqx-auth-mysql
$ ./_rel/emqx/bin/emqx startemqx 3.1 is started successfully!$ ./_rel/emqx/bin/emqx_ctl plugins load emqx_auth_mysql
- 测试
- 使用正确的用户名和密码进行连接,并订阅 "topic" 主题
$ mosquitto_sub -p 1883 -u test -P password -t 'topic' -dClient mosqsub|91114-zhouzibod sending CONNECTClient mosqsub|91114-zhouzibod received CONNACKClient mosqsub|91114-zhouzibod sending SUBSCRIBE (Mid: 1, Topic: topic, QoS: 0)Client mosqsub|91114-zhouzibod received SUBACKSubscribed (mid: 1): 0
- 现象:连接并订阅成功
- 使用错误的用户名或密码进行连接,并订阅 "topic" 主题
$ mosquitto_sub -p 1883 -u bad_user -P password -t 'topic' -dClient mosqsub|91136-zhouzibod sending CONNECTClient mosqsub|91136-zhouzibod received CONNACKConnection Refused: not authorised.
- 现象:连接被拒绝
- 使用正确的用户名和密码进行连接,并订阅 "#" 主题
$ mosquitto_sub -p 1883 -u test -P password -t '#' -dClient mosqsub|11257-zhouzibod sending CONNECTClient mosqsub|11257-zhouzibod received CONNACKClient mosqsub|11257-zhouzibod sending SUBSCRIBE (Mid: 1, Topic: #, QoS: 0)Client mosqsub|11257-zhouzibod received SUBACKSubscribed (mid: 1): 128
- 现象:连接成功,订阅失败,原因码128
- 使用正确的用户名和密码进行连接,并订阅 "mytopic" 主题
$ mosquitto_sub -p 1883 -u test -P password -t 'mytopic' -dClient mosqsub|13606-zhouzibod sending CONNECTClient mosqsub|13606-zhouzibod received CONNACKClient mosqsub|13606-zhouzibod sending SUBSCRIBE (Mid: 1, Topic: mytopic, QoS: 0)Client mosqsub|13606-zhouzibod received SUBACKSubscribed (mid: 1): 128
推荐阅读
-
-
老虎社区|4710 万创新高,腾讯音乐 Q2 财报超预期,音乐付费用户
-
于正质疑TFBOYS新海报抄袭发生什么事了?于正质疑TFBOYS新海报抄袭具体情况
-
「高速」别了!江西最大收费站。高速实现“一脚油门踩到底”从
-
如花般娱乐|曾火遍大江南北,这些年去哪里了?,那个唱《祝你平安》的孙悦
-
【岳云鹏】在鸡条睡觉是耍大牌?岳云鹏在《向往的生活》给出了原因,五个字
-
-
张若昀|《庆余年》、《雪中悍刀行》将拍新一季,张若昀、李沁、刘学义等
-
-
-
财华社|降其目标价至169港元,野村指网易(09999-HK)季绩受经营开支及汇兑拖累
-
Big广角镜|一定要赢下建业,庞利:卓尔本赛季第一次派出四外援首发
-
奥迪A4L|实拍:奥迪A4L犀利运动,上市不足8个月,优惠“跳水”厉害
-
北极|美一个师17000人,印一个师15000人,那我国一个师多少人?
-
[精彩评CBA]错失辽籍中锋争冠无望,失算了!郭士强念旧情拒绝交易烧烤店老板
-
-
【广州日报】世界羽联:本赛季亚洲站比赛改到明年1月在泰国举行
-
武磊|西媒狠批武磊:每场比赛都浪费机会!本可助西班牙人1-0领先
-
车辆报废新规已经出台,或许你的车辆将会升值,大家互相转发!
-