sea-kg / webhook-handler

webhook-handler service

webhook-handler

HTTP endpoints (hooks) - no ssl configuration (use a http-server with proxy)

Install

Ubuntu. PPA

Build on debian/ubuntu

Install requriments

$ apt-get -y update && apt-get install -y \
    make cmake \
    g++ \
    pkg-config

Build

$ ./clean.sh && ./build_simple.sh

Run

./webhook-handler --dir ./data start

Configuration examples

File ./data/webhook-handler-conf.yml (or server will try search in /etc/webhook-handler):

# server configuration
server:
  port: 8002
  wait-seconds-between-run-scripts: 60
  max-script-threads: 1
  max-deque: 100
  allow-status-page: yes
  status-page-url-path: "/wh/status" # will work if 'allow-status-page: yes'
  log-dir: "./logs"

Where

• server/port - number, web port (default 8002)

• server/allow-status-page - boolean, enable or disable status page (default: no)

• server/status-page-url-path - string, path to page with status of server (default: "/wh/status")

• server/log-dir - string, path to log directory (default: "/var/log/webhook-handler/")

• server/max-script-threads - number, max count of threads for handling webhooks

• server/wait-seconds-between-run-scripts - number,

• server/max-deque - number, max value of possible webhooks handlers

• webhook-handlers/%webhookid%/commands - list of commands to execute (Variables: %WEBHOOK_DATA_FILE_PATH% - path to file with income data with webhooks)

File ./data/%dir%/webhook.conf:

id = %webhookid%
script_path = ./rebuild.sh
script_wait_in_sec = 600
enabled = yes

• id - unique id of webhook (replace on randoms string [A-Za-z0-9])
• script_path - path to script, relative
• script_wait_in_sec - how much time wait

After start server will be here

unique id of webhook, Webhook will like http://localhost:%port%/%webhook-url-path%

webhook-handler's Issues

Prepare package for homebrew

Workdir must be resolved like absolute path

feature: add admin web pages

command like a

./webhook-handler -wd ./data start  --with-web-admin

Redesign logger to wsjcpplog

Create a snap package

Check and set default directory /usr/local/share/webhook-handler

Load previous webhooks on restart

Run commands by specific user

Add support github / branches

Redesign configs to yaml

Extend confuguration for web server

Accept request from host
(For example: only localhost)

Improve keep queue to disk

When received correct request just keep to file to data/queue/%datetime%.json

Implement status page

When started
How much in queue
Faileds and etc

Prepare scripts for ppa

add Dockerfile

For simple start

Refactor to wsjcpp light web server

Add sample conf for apache/nginx to README