History

JianBo He ade69c1e18 fix(exhook): more safe type convertion		2021-08-07 08:48:34 +08:00
..
docs	docs(exhook): renanme CheckAcl to Authorize	2021-08-03 14:06:58 +08:00
etc	fix(exhook): fix the server config format	2021-08-07 08:48:34 +08:00
include	test(exhook): refine tests	2021-08-03 14:06:58 +08:00
priv/protos	fix(exhook): BrokerInfo uptime is now a duration integer	2021-08-05 12:58:03 +02:00
src	fix(exhook): more safe type convertion	2021-08-07 08:48:34 +08:00
test	fix(exhook): fix the server name type	2021-08-07 08:48:34 +08:00
.gitignore	refactor(exhook): adapt to the hocon schmea	2021-08-03 14:06:58 +08:00
README.md	refactor(exhook): adapt to the hocon schmea	2021-08-03 14:06:58 +08:00
rebar.config	test(exhook): refine tests	2021-08-03 14:06:58 +08:00

README.md

emqx_exhook

The emqx_exhook extremly enhance the extensibility for EMQ X. It allow using an others programming language to mount the hooks intead of erlang.

Feature

Based on gRPC, it brings a very wide range of applicability
Allows you to use the return value to extend emqx behavior.

Architecture

EMQ X                                      Third-party Runtime
+========================+                 +========+==========+
|    ExHook              |                 |        |          |
|   +----------------+   |      gRPC       | gRPC   |  User's  |
|   |   gPRC Client  | ------------------> | Server |  Codes   |
|   +----------------+   |    (HTTP/2)     |        |          |
|                        |                 |        |          |
+========================+                 +========+==========+

Usage

gRPC service

See: priv/protos/exhook.proto

CLI

Example

Recommended gRPC Framework

See: https://github.com/grpc-ecosystem/awesome-grpc

Thanks

grpcbox