6
1
mirror of https://git.mills.io/saltyim/saltyim.git synced 2024-06-24 07:48:19 +00:00
prologic-saltyim/docs
James Mills ddd16c202f Add blob service and support for signing and verifying HTTP requests (#178)
Alternative to #177

The way this works is:

Client:

- Client creates a normal `net/http.Request{}` object using the `Request()` function in `utils.go`. The `http.Request{}` object is then signed using the Client's Ed25519 private key.
- The HTTP Method and Path (_note this is important_) are hashed, as well as the request body (if any) using the FNV128a hashing algorithm.
- This hash is then signed by the Client's's Ed25519 private key.
- The resulting signature is then encoded to Base64 (_standard encoding_) and added to the HTTP headers as a `Signature:` header.
- In addition the Client's Ed25519 public key is added to the HTTP headers as `Signer:`

Server:

- The server calculates the same FNV128a hash of the HTTP Request Method and Path and the body (if any)
- The server decodes the HTTP header `Signature:`
- The server then uses the Client's Ed25519 public key in the HTTP header `Signer:` to verify the signature of the `Signature:` HTTP header which gives us back the original FNV128a hash the Client calculated for the request.
- The server then compares the Client's hash with the expected hash to see if they compare equally.

Co-authored-by: James Mills <1290234+prologic@users.noreply.github.com>
Co-authored-by: Jon Lundy <jon@xuu.cc>
Reviewed-on: https://git.mills.io/saltyim/saltyim/pulls/178
Reviewed-by: xuu <xuu@noreply@mills.io>
2023-01-25 23:05:29 +00:00
..
screenshots feat: Add development guide with screenshots and refactor docs 2022-06-12 12:49:19 +10:00
stacks feat: Add development guide with screenshots and refactor docs 2022-06-12 12:49:19 +10:00
BlogStorage.md Add blob service and support for signing and verifying HTTP requests (#178) 2023-01-25 23:05:29 +00:00
Deployment-OpenBSD.md Add OpenBSD instructions, based on my personal setup. Update docs/Deployment.md 2022-08-27 12:25:23 +10:00
Deployment.md Add OpenBSD instructions, based on my personal setup. Update docs/Deployment.md 2022-08-27 12:25:23 +10:00
Development.md Fix README (Fixes #74) 2022-09-25 12:52:51 +10:00
logo.png Update logo 2022-10-24 14:40:30 +10:00