Relay CLI provides a variety of ways to configure request routing and also acts as an agent for request forwarding and tunnelling. Main features:
automatically configure bucket, input and output for webhook forwarding with relay forward command
automatically configure tunnel with relay connect command
manage buckets, inputs and outputs for one-way request forwarding
manage tunnel subdomains, destinations and authentication details
manage access keys and secrets
Authenticate
In order to start using your CLI, you first have to authenticate. Create your key & secret pair here: https://my.webhookrelay.com/tokens. Then, there are two ways to do it:
Using login command CLI will take advantage of native secure storage:
Create forwarding configuration (automatically creates bucket, input endpoint and output destination). If destination and bucket aren't specified - starts a relay for all endpoints
6
7
Options:
8
-b, --bucket string Bucket name (defaults to destination name if not supplied)
9
--command string Command to execute, must be used with '--relayer exec' option
10
--help Print usage
11
--input-mode string Input mode switches between raw request body passed into the exec command through STDIN and a JSON encoded full webhook event (see documentation for
12
format), must be used with '--relayer exec' option (default "body")
13
--no-agent Do not start relay agent after configuration
14
--relayer string Relayer type - 'default' HTTP (forward to HTTP servers) or 'exec' that executes commands on the current machine (default "default")
15
--timeout int Execution timeout in seconds, must be used with '--relayer exec' option. Set to 0 to never timeout (default 300)
16
-t, --type string Output type - internal or public (default "internal")
17
--ws Use WebSocket server as a transport (might evade certain firewalls)
Copied!
Here, to forward webhooks:
-b –bucket: supply bucket name to reuse existing one. Useful when invoking forward command for the same destination.
–no-agent: only configure bucket, input and output without starting an agent.
Another forward mode is to execute commands on your machine, to do that, use:
-b –bucket: supply bucket name to reuse existing one.
–relayer: use ‘exec’ relayer type to execute commands.
–command: command to execute, for example ‘python’, ‘bash’, ‘node’ and pretty much any other executable on your computer.
–input-mode: by default only request body is passed through stdin into the executed command, use ‘json’ to retrieve body, headers, method, query and additional bucket/input metadata.
All additional arguments passed to the forward command will be passed as arguments to the executed command:
Report client related issues here: https://github.com/webrelay/client/issues.
14
15
If you have any questions or security related issues, please contact us via email: [email protected]
16
17
Options:
18
--config string Location of client config files (default "/home/karolis/.webhookrelay")
19
--help Print usage
20
-v, --version Print version information and quit
21
22
Management Commands:
23
bucket Manage buckets - used to group inputs and outputs together
24
domain Manage domain reservations - reserved domains can later be used for bucket inputs or tunnel hostnames
25
function Manage functions - used to transform webhooks and writing custom plugins
26
ingress Manage ingresses - reverse tunnels for Kubernetes
27
input Manage inputs - your personal endpoints to receive webhooks
28
output Manage outputs - destinations where requests are relayed
29
token Manage tokens - required for API (OAuth users) and webhook streaming connections
30
tunnel Manage tunnels - bidirectional connections that expose internal services
31
32
Commands:
33
connect Connects supplied destination to the public endpoint
34
diagnostics Perform relay agent diagnostics
35
forward Create forwarding configuration (automatically creates bucket, input endpoint and output destination). If destination and bucket aren't specified - starts a relay for all endpoints
36
login Log in to a Webhook Relay service. Get your token key & secret pair here: https://my.webhookrelay.com/tokens.
37
logout Log out from a Webhook Relay service
38
register Register a new Webhook Relay account
39
run Run relay agent as a service with a given config file
40
service Install and control relay as a background service, available commands (install, uninstall, start, stop, restart, status)
41
42
Run 'relay COMMAND --help' for more information on a command.