benalexau / IP-Bound-HMAC

A Cloudflare Worker that returns a SHA-256 HMAC based on requestor IP address and provided URL path.

IP-Bound-HMAC

A Cloudflare Worker that returns a SHA-256 HMAC based on requestor IP address and provided URL path.

In effect this allows a client to make a HTTP GET request and receive a Base64 response which can be used for purposes such as unsealing a local key store.

Public Deployment

This worker is deployed at https://ip-bound-hmac.acegi.com.au. This instance is freely provided on a "best efforts" basis and as such may be removed or stop working at any time. Nevertheless you are welcome to use it if it assists your use case and you are only making a small number of requests. It also lets you quickly test the worker without deploying it yourself (eg use different IP addresses and/or paths and observe the HMAC changes):

• https://ip-bound-hmac.acegi.com.au/hello-world
• https://ip-bound-hmac.acegi.com.au/another-path

Hosting Your Own Deployment

1. Sign up for a Cloudflare Account and create a zone
2. Add a DNS A record for ip-bound-hmac.YOUR-DOMAIN to 192.0.2.1
3. Install Wrangler
4. Configure with wrangler login
5. Clone this repository
6. Copy wrangler.yaml.example to wrangler.yaml and adjust to your domain
7. Create a secret using wrangler secret put SECRET
8. Deploy using wrangler publish

Usage

Simply request https://ip-bound-hmac.YOUR-DOMAIN/any-path and you will receive back a SHA-256 HMAC specific to that path, IP address and worker SECRET.

See PiTang for a practical example of how to use this worker to unlock LUKS volumes.