Archives/obfs4
2
0
Fork 0
mirror of https://gitlab.com/yawning/obfs4.git synced 2024-11-17 09:25:36 +00:00
Code Issues Projects Releases Wiki Activity
The obfourscator (obfs4proxy)
80 Commits 1 Branch 14 Tags 502 KiB
Go 100%
5abad1571c
Go to file
Yawning Angel 5abad1571c Use Vose's Alias Method to sample the weighted distribution. 
The weight generation code also was cleaned up (and now can support
generating distributions that look like what ScrambleSuit does as
a compile time change).

Per: http://www.keithschwarz.com/darts-dice-coins/
2014-06-19 06:29:12 +00:00
csrand Use Vose's Alias Method to sample the weighted distribution. 2014-06-19 06:29:12 +00:00
doc Change how the length obfsucation mask is derived. 2014-06-02 17:50:01 +00:00
drbg Change how the length obfsucation mask is derived. 2014-06-02 17:50:01 +00:00
framing Change how the length obfsucation mask is derived. 2014-06-02 17:50:01 +00:00
ntor Move utils.go to csrand/csrand.go, and clean up the interface. 2014-05-24 04:47:10 +00:00
obfs4proxy Allow randomly generating node-ids instead of requiring the fingerprint. 2014-06-07 00:26:36 +00:00
.gitignore Move to a unified client/server binary, and fix bugs. 2014-05-12 00:02:24 +00:00
handshake_ntor_test.go Move the server keypair generation to right after Accept(). 2014-06-01 05:22:07 +00:00
handshake_ntor.go Move the server keypair generation to right after Accept(). 2014-06-01 05:22:07 +00:00
LICENSE Document dependencies, add LICENSE (No functional changes). 2014-06-07 20:03:29 +00:00
obfs4.go Change how the length obfsucation mask is derived. 2014-06-02 17:50:01 +00:00
packet.go Change how the length obfsucation mask is derived. 2014-06-02 17:50:01 +00:00
README.md Document dependencies, add LICENSE (No functional changes). 2014-06-07 20:03:29 +00:00
replay_filter_test.go Add replay detection to handshakes. 2014-05-22 18:42:16 +00:00
replay_filter.go Move utils.go to csrand/csrand.go, and clean up the interface. 2014-05-24 04:47:10 +00:00
weighted_dist_test.go Use Vose's Alias Method to sample the weighted distribution. 2014-06-19 06:29:12 +00:00
weighted_dist.go Use Vose's Alias Method to sample the weighted distribution. 2014-06-19 06:29:12 +00:00

README.md

obfs4 - The obfourscator

Yawning Angel (yawning at torproject dot org)

WARNING

This is pre-alpha. Don't expect any security or wire protocol stability yet. If you want to use something like this, you should currently probably be looking at ScrambleSuit.

What?

This is a look-like nothing obfuscation protocol that incorporates ideas and concepts from Philipp Winter's ScrambleSuit protocol. The obfs naming was chosen primarily because it was shorter, in terms of protocol ancestery obfs4 is much closer to ScrambleSuit than obfs2/obfs3.

The notable differences between ScrambleSuit and obfs4:

  • The handshake always does a full key exchange (no such thing as a Session Ticket Handshake).
  • The handshake uses the Tor Project's ntor handshake with public keys obfuscated via the Elligator 2 mapping.
  • The link layer encryption uses NaCl secret boxes (Poly1305/XSalsa20).

Why not extend ScrambleSuit?

It's my protocol and I'll obfuscate if I want to.

Since a lot of the changes are to the handshaking process, it didn't make sense to extend ScrambleSuit as writing a server implementation that supported both handshake variants without being obscenely slow is non-trivial.

Dependencies

Build time library dependencies are handled by go get automatically but are listed for clarity.

TODO

  • Code cleanups.
  • Write more unit tests.
  • Optimize further.

WON'T DO

  • I do not care that much about standalone mode. Patches MAY be accepted, especially if they are clean and are useful to Tor users.
  • Yes, I use a bunch of code from the borg^w^wGoogle. If that bothers you feel free to write your own implementation.
  • I do not care about older versions of the go runtime.

Thanks

  • David Fifield for goptlib.
  • Adam Langley for his Elligator implementation.
  • Philipp Winter for the ScrambleSuit protocol which provided much of the design.