hyp/hypd
Steven Polley f660a5a2e5
All checks were successful
continuous-integration/drone/push Build is passing
More readme content
2024-04-20 16:11:10 -06:00
..
cmd add support for multiple secrets (independent agents) on the knock daemon 2024-04-19 22:04:00 -06:00
configuration add support for multiple secrets (independent agents) on the knock daemon 2024-04-19 22:04:00 -06:00
examples/openwrt-wireguard add openwrt-wireguard example 2024-04-18 09:39:21 -06:00
server Add support for timeout action 2024-04-20 15:41:26 -06:00
main.go BREAKING: changes to CLI interface, moved to cobra CLI 2024-04-10 21:42:38 -06:00
README.md More readme content 2024-04-20 16:11:10 -06:00

hypd | Hide Your Ports Daemon

hypd is the pork knocking daemon which listens for incoming authentic knock sequences.

Usage

Running hypd requires generating secrets which are then shared with hyp clients. hypd is used to generate these secrets, and it's recommended you create a directory just for hyp secrets.

# Example: create a directory named secrets
mkdir -p secrets

# Then generate a secret file in this directory
./hypd generate secret > secrets/my-first-secret

It's recommended you generate a secret for each trusted agent so you can granularly control revocation just by removing a secret file from the secrets directory.

Running hypd requires specifying a configuration file. It's recommended you generate the default configuration file and then edit it afterwards.

# Create a default configuration file
./hypd generate defaultconfig > hypd.conf

Make sure you take the time to review the hypd.conf file and edit it to your liking, this is the most important step.

Once you have set your config file, you can finally run hypd.

# As root or sudo, specify the configuration file
sudo ./hypd server hypd.conf