wireguard-tools/contrib/keygen-html
Jason A. Donenfeld d90e49599b wg: encoding: add missing static array constraints
Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
2018-06-06 00:05:58 +02:00
..
src wg: encoding: add missing static array constraints 2018-06-06 00:05:58 +02:00
.gitignore keygen-html: remove prebuilt file 2017-12-12 01:18:30 +01:00
Makefile Revert "contrib: keygen-html: rewrite in pure javascript" 2018-03-02 16:42:29 +01:00
README keygen-html: remove prebuilt file 2017-12-12 01:18:30 +01:00
keygen.html keygen-html: add zip file example 2018-05-02 17:38:07 +02: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