wireguard-tools/contrib/keygen-html
Jason A. Donenfeld 1aa8364b17 keygen-html: add missing glue macro
Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
2018-11-06 03:30:06 +01:00
..
src keygen-html: add missing glue macro 2018-11-06 03:30:06 +01:00
.gitignore 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
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

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