History

DDDHuang 4a692f0c2e fix: config schema sni disable		2022-04-10 12:57:50 +08:00
..
etc	chore: rename more descriptive EQM X to EMQX	2022-02-22 11:16:38 +01:00
include	refactor: remove the acl metrics for all auth plugins	2022-01-21 14:24:03 +08:00
priv	fix(http pipelining): support to switch http pipelining (#5279 )	2021-07-27 17:32:56 +08:00
src	fix: config schema sni disable	2022-04-10 12:57:50 +08:00
test	test(emqx_auth_http): test ipv6 + hostname resolution	2021-04-28 10:43:36 +02:00
.gitignore	refactor(proj): Add apps	2020-12-04 22:11:53 +01:00
README.md	docs(README): EMQ X -> EMQX	2022-02-15 16:15:25 +01:00
rebar.config	chore(ehttpc): update tag of ehttpc	2021-04-15 21:47:20 +08:00

README.md

emqx_auth_http

EMQX HTTP Auth/ACL Plugin

Build

make && make tests

Configure the Plugin

File: etc/emqx_auth_http.conf

##--------------------------------------------------------------------
## Authentication request.
##
## Variables:
##  - %u: username
##  - %c: clientid
##  - %a: ipaddress
##  - %r: protocol
##  - %P: password
##  - %C: common name of client TLS cert
##  - %d: subject of client TLS cert
##
## Value: URL
auth.http.auth_req = http://127.0.0.1:8080/mqtt/auth
## Value: post | get | put
auth.http.auth_req.method = post
## Value: Params
auth.http.auth_req.params = clientid=%c,username=%u,password=%P

##--------------------------------------------------------------------
## Superuser request.
##
## Variables:
##  - %u: username
##  - %c: clientid
##  - %a: ipaddress
##  - %r: protocol
##  - %P: password
##  - %C: common name of client TLS cert
##  - %d: subject of client TLS cert
##
## Value: URL
auth.http.super_req = http://127.0.0.1:8080/mqtt/superuser
## Value: post | get | put
auth.http.super_req.method = post
## Value: Params
auth.http.super_req.params = clientid=%c,username=%u

##--------------------------------------------------------------------
## ACL request.
##
## Variables:
##  - %A: 1 | 2, 1 = sub, 2 = pub
##  - %u: username
##  - %c: clientid
##  - %a: ipaddress
##  - %r: protocol
##  - %m: mountpoint
##  - %t: topic
##
## Value: URL
auth.http.acl_req = http://127.0.0.1:8080/mqtt/acl
## Value: post | get | put
auth.http.acl_req.method = get
## Value: Params
auth.http.acl_req.params = access=%A,username=%u,clientid=%c,ipaddr=%a,topic=%t

Load the Plugin

./bin/emqx_ctl plugins load emqx_auth_http

HTTP API

200 if ok

4xx if unauthorized

License

Apache License Version 2.0

Author

EMQX Team.