wireguard-tools/contrib/keygen-html
Jason A. Donenfeld 9207dec08f global: year bump
Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
2018-01-03 21:58:00 +01:00
..
src global: year bump 2018-01-03 21:58:00 +01:00
.gitignore keygen-html: remove prebuilt file 2017-12-12 01:18:30 +01:00
Makefile keygen-html: remove prebuilt file 2017-12-12 01:18:30 +01:00
README keygen-html: remove prebuilt file 2017-12-12 01:18:30 +01:00
keygen.html global: year bump 2018-01-03 21:58:00 +01:00

README

WireGuard Key Generation in JavaScript
======================================

Various people believe in JavaScript crypto, unfortunately. This small
example helps them fuel their poor taste.

It's possible to generate WireGuard keys (and thus configurations) in the
browser. The webpage here simulates talking to a server to exchange keys
and then generates a configuration file for the user to download.

Bugs
----

Who knows how emscripten actually compiles this and whether or not it
introduces interesting side-channel attacks.

Secrets aren't zerored after use. Maybe you can get around this with
some tricks taking advantage of browser allocator behavior and different
processes, but it seems pretty hard.

Building
--------

In order to use the example `keygen.html` file, you must first build
the C sources using emscripten. Simply run:

    $ make