History

JimMoen 5e100f52b8 style: erlfmt all `rebar.config` files and `bin/nodetool`		2023-12-29 09:08:03 +08:00
..
docs	feat(exhook): provide meta data in `RequestMeta`	2022-04-23 19:45:34 +08:00
etc	feat: generate a minimized emqx.conf	2022-05-31 19:20:27 +08:00
include	chore: update copyright year 2023	2023-01-02 09:22:27 +01:00
priv/protos	feat(exhook): subopts in on_client_subscribe/on_client_unsubscribe	2023-12-11 14:11:18 +08:00
src	fix(exhook): `client.authorize` hook always uses real-topic	2023-12-11 14:11:18 +08:00
test	feat(exhook): subopts in on_client_subscribe/on_client_unsubscribe	2023-12-11 14:11:18 +08:00
.gitignore	fix(exhook): fix obsolete SSL files aren't deleted after the Exhook config update	2022-11-29 10:40:08 +08:00
README.md	docs(README): EMQ X -> EMQX	2022-02-15 16:19:26 +01:00
rebar.config	style: erlfmt all `rebar.config` files and `bin/nodetool`	2023-12-29 09:08:03 +08:00

README.md

emqx_exhook

The emqx_exhook extremely enhance the extensibility for EMQX. It allow using an others programming language to mount the hooks instead 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