adnanh/webhook
Webhook
Webhook is a lightweight automation server that executes local shell scripts and system commands in response to incoming HTTP requests. It functions as an integration engine, mapping external network events to server-side tasks by parsing request payloads and triggering predefined processes.
The project distinguishes itself through a declarative configuration model that allows for dynamic argument injection. By extracting values from request headers, query parameters, or bodies, it populates command templates to facilitate flexible script execution. This enables the automation of infrastructure workflows, such as deployment pipelines, by bridging external service events with local command-line operations.
Security is managed through request signature validation, which verifies the authenticity of incoming payloads against stored secrets before any command execution occurs. The system operates by spawning synchronous child processes, capturing their output to provide immediate feedback for each request. The software is distributed as a standalone binary and is configured via structured files.
Features
- Shell Script Execution Engines - Executes shell scripts automatically in response to incoming HTTP webhook requests.
- Local HTTP Servers - Acts as a lightweight server that executes shell scripts and system commands in response to HTTP requests.
- Automation Servers - Provides a utility for triggering local server tasks and deployment workflows through validated webhooks.
- Command Execution Engines - Maps HTTP request payloads to command-line arguments using templates to automate infrastructure tasks.
- Webhook Security - Verifies incoming webhook requests using shared secrets to ensure only authorized sources trigger commands.
- Workflow Automation Servers - Provides a server-side automation engine for triggering custom scripts via HTTP requests.
- HTTP Request Triggers - Triggers local system commands and shell scripts in response to incoming HTTP requests.
- Webhook Event Consumers - Integrates third-party services with local infrastructure by processing incoming webhook payloads.
- Infrastructure Tools - Executes server-side commands via HTTP hooks.
- Automation and Integrations - Executes commands triggered by incoming Slack webhooks.
- More to explore - Web hook server for shell commands.
- Continuous Deployment Pipelines - Automates deployment pipelines by triggering build and release scripts via webhook events.
- Request Validation - Verifies the authenticity of incoming webhook payloads using shared secrets before processing.
- Argument Injection Utilities - Parses request data into variables and injects them into command templates before execution.
- Command Template Engines - Supports dynamic construction of command parameters by injecting request data into templates.
- Administrative API Endpoints - Exposes controlled, secure API endpoints for triggering administrative tasks.
- Data Injection - Extracts values from request headers, query parameters, or bodies to populate command templates.
- Declarative Configuration - Uses structured configuration files to define the mapping between incoming HTTP requests and server-side command execution.
