A secure remote client/server terminal, written in Golang. Intended as a test-bed for experimental key exchanges and symmetric session crypto. Integrated traffic chaffing.
Go to file
Russ Magee 52423b7144 Cleaned up some debug, moved insulter for failed login into project 2018-01-24 18:14:21 -08:00
demo Cleaned up some debug, moved insulter for failed login into project 2018-01-24 18:14:21 -08:00
README.md Cleaned up some debug, moved insulter for failed login into project 2018-01-24 18:14:21 -08:00
herradurakex.go Cleaned up some debug, moved insulter for failed login into project 2018-01-24 18:14:21 -08:00
hkexauth.go Cleaned up some debug, moved insulter for failed login into project 2018-01-24 18:14:21 -08:00
hkexchan.go Removed channel-based server loop goroutine, solving eaten initial byte issue. 2018-01-20 21:20:49 -08:00
hkexnet.go Removed channel-based server loop goroutine, solving eaten initial byte issue. 2018-01-20 21:20:49 -08:00

README.md

Package herradurakex is a drop-in replacement for golang/pkg/net facilities (net.Dial(), net.Listen(), net.Accept() and the net.Conn type) using the experimental HerraduraKEx key exchange algorithm, first released at (Omar Elejandro Herrera Reyna's github page)[github.com/Caume/HerraduraKEx].

One can simply replace calls to net.Dial() with hkex.Dial(), and likewise net.Listen() with hkex.Listen(), to obtain connections (hkex.Conn) conforming to the basic net.Conn interface. Upon Dial(), the HerraduraKEx key exchange is initiated (whereby client and server independently derive the same keying material) and session algorithms to be used are exchanged allowing an encrypted channel between client and server.

NOTE: Due to the experimental nature of the HerraduraKEx algorithm used to derive crypto keying material on each end, this algorithm and the demonstration remote shell client/server programs should be used with caution. As of this time (Jan 2018) no verdict by acknowledged 'crypto experts' as to the true security of the HerraduraKEx algorithm for purposes of session key exchange over an insecure channel has been rendered. It is hoped that such experts in the field will analyze the algorithm and determine if it is indeed a suitable one for use in situations where Diffie-Hellman and other key exchange algorithms are currently utilized.

Within the demo/ tree are client and servers implementing a simplified, ssh-like secure shell facility and a password-setting utility using its own user/password file separate from the system /etc/passwd, which is used by the server to authenticate clients.

Dependencies: github.com/mattn/go-isatty //terminal tty detection github.com/kr/pty //unix pty control (server pty connections) github.com/jameskeane/bcrypt //password storage/auth

To run

$ go get /herradurakex.git $ cd $GOPATH/src//herradurakex $ go install . $ go build demo/client/client.go && go build demo/server/server.go $ go build demo/hkexpasswd/hkexpasswd.go

[To set accounts & passwords] $ sudo echo "joebloggs:::*" >/etc/hkex.passwd $ sudo ./hkexpasswd -u joebloggs

[ in separate shells ] [A]$ ./server & [B]$ ./client -u joebloggs