History

JianBo He 89c65b6535 Merge tag 'v4.3.14-rc.4' into merge-main-v4.3-into-v4.4		2022-04-16 11:28:07 +08:00
..
docs	docs: EMQ X -> EMQX	2022-02-15 22:12:46 +01:00
etc	Merge remote-tracking branch 'origin/main-v4.3' into dev/v4.4.3	2022-04-06 13:24:37 +02:00
include	chore: update copyright	2022-04-14 11:23:25 +08:00
priv	Merge tag 'v4.3.14-rc.4' into merge-main-v4.3-into-v4.4	2022-04-16 11:28:07 +08:00
src	Merge tag 'v4.3.14-rc.4' into merge-main-v4.3-into-v4.4	2022-04-16 11:28:07 +08:00
test	Merge tag 'v4.3.14-rc.4' into merge-main-v4.3-into-v4.4	2022-04-16 11:28:07 +08:00
.gitignore	feat(exhook): add field `meta` for grpc proto	2022-04-07 17:26:59 +08:00
README.md	docs(README): EMQ X -> EMQX	2022-02-15 16:15:25 +01:00
rebar.config	chore: upgrade grpc to 0.6.4	2021-11-15 09:50:32 +08:00

README.md

emqx_exhook

The emqx_exhook extremly enhance the extensibility for EMQX. 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

EMQX                                      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