History

Thales Macedo Garitezi 5c693beadd chore(appup): remove `load_module` instructions if `restart_application` > the restart_application instruction will be translated into module load instructions by otp release handler.		2021-11-25 12:08:02 -03:00
..
etc	chore(auth-http): Disable Superuser Request by Defualt	2021-09-15 08:48:52 +08:00
include	fix(auth http): using ehttpc (#4021 )	2021-01-16 23:10:53 +08:00
priv	fix(http pipelining): support to switch http pipelining (#5279 )	2021-07-27 17:32:56 +08:00
src	chore(appup): remove `load_module` instructions if `restart_application`	2021-11-25 12:08:02 -03: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	refactor(proj): Add apps	2020-12-04 22:11:53 +01:00
rebar.config	chore(ehttpc): update tag of ehttpc	2021-04-15 21:47:20 +08:00

README.md

emqx_auth_http

EMQ X 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

EMQ X Team.