Go to file
Dirkjan Bussink 38d7da5fe5
Fix handling of replies to global requests (#112)
The current code assumes that all global requests want / need a reply.
This isn't always true and the request itself indicates if it wants a
reply or not.

It causes a specific problem with hostkeys-00@openssh.com messages.
These are sent by OpenSSH after authentication to inform the client of
potential other host keys for the host. This can be used to add a new
type of host key or to rotate host keys.

The initial information message from the server is sent as a global
request, but with want_reply set to false. This means that the server
doesn't expect an answer to this message. Instead the client needs to
send a prove request as a reply if it wants to receive proof of
ownership for the host keys.

The bug doesn't cause any current problems with due to how OpenSSH
treats receiving the failure message. It instead treats it as a
keepalive message and further ignores it.

Arguably this is a protocol violation though of Dropbear and it is only
accidental that it doesn't cause a problem with OpenSSH.

The bug was found when adding host keys support to libssh, which is more
strict protocol wise and treats the unexpected failure message an error,
also see https://gitlab.com/libssh/libssh-mirror/-/merge_requests/145
for more information.

The fix here is to honor the want_reply flag in the global request and
to only send a reply if the other side expects a reply.
2020-12-10 23:13:13 +08:00
debian Changelog for 2020.81 2020-10-29 21:35:50 +08:00
fuzz fuzz: add an always-failing dropbear_listen() replacement 2020-12-06 21:54:01 +08:00
libtomcrypt Remove blowfish 2020-06-10 23:42:42 +08:00
libtommath Use Dropbear's random source rather than libtommath's platform 2020-10-19 22:49:19 +08:00
.gitignore update ltm to 1.1.0 and enable FIPS 186.4 compliant key-generation (#79) 2019-09-16 21:50:38 +08:00
.hgignore fuzz harness 2017-05-13 22:50:54 +08:00
.hgsigs Added signature for changeset 5879c5829e85 2020-10-29 21:40:34 +08:00
.hgtags Added tag DROPBEAR_2020.81 for changeset 4b984c42372d 2020-10-29 21:40:27 +08:00
.travis.yml Add ubsan fuzz run to Travis CI too 2020-10-19 23:38:11 +08:00
agentfwd.h rsa-sha256 for ssh-agent 2020-05-25 20:23:02 +08:00
algo.h merge rsa-sha256 2020-05-26 00:24:02 +08:00
atomicio.c upgrade atomicio 2016-11-15 14:56:25 +01:00
atomicio.h upgrade atomicio 2016-11-15 14:56:25 +01:00
auth.h Remove unused cli_authinitialise 2020-12-03 21:19:19 +08:00
bignum.c Update LibTomMath to 1.2.0 (#84) 2020-05-26 23:36:47 +08:00
bignum.h add m_mp_free_multi, be more careful freeing when failing to load keys 2017-05-26 21:08:43 +08:00
buffer.c Remove accidentally committed abort() 2020-11-13 23:16:50 +08:00
buffer.h Add buf_decrpos() 2020-10-24 18:56:45 +08:00
chachapoly.c Fix ChaCha20 on 32-bit platforms (#99) 2020-05-29 21:26:22 +08:00
chachapoly.h Add Chacha20-Poly1305, AES128-GCM and AES256-GCM support (#93) 2020-05-25 23:50:25 +08:00
CHANGES Changelog for 2020.81 2020-10-29 21:35:50 +08:00
channel.h Split ChanType closehandler() and cleanup() so that dbclient doesn't 2018-11-14 22:57:56 +08:00
chansession.h Set SSH_ORIGINAL_COMMAND for "dropbear -c" too, fix build without 2020-03-14 23:28:18 +08:00
circbuffer.c Pointer parameter could be declared as pointing to const 2017-08-19 17:16:13 +02:00
circbuffer.h Pointer parameter could be declared as pointing to const 2017-08-19 17:16:13 +02:00
cli-agentfwd.c rsa-sha256 for ssh-agent 2020-05-25 20:23:02 +08:00
cli-auth.c Remove unused cli_authinitialise 2020-12-03 21:19:19 +08:00
cli-authinteract.c Convert #ifdef to #if, other build changes 2016-05-04 15:33:40 +02:00
cli-authpasswd.c Convert #ifdef to #if, other build changes 2016-05-04 15:33:40 +02:00
cli-authpubkey.c initialise variable to stop warning 2020-05-28 22:02:03 +08:00
cli-channel.c
cli-chansession.c Fix regression where TTY modes weren't reset for client 2019-03-24 20:41:02 +08:00
cli-kex.c Add fuzzer-client_nomaths, fix client fuzzer 2020-10-18 15:08:54 +08:00
cli-main.c Get client fuzzer building and starting (fails straight away) 2020-10-18 12:17:39 +08:00
cli-runopts.c Make "dbclient -m help -c help" work 2020-05-26 20:15:39 +08:00
cli-session.c Fix handling of replies to global requests (#112) 2020-12-10 23:13:13 +08:00
cli-tcpfwd.c fuzz: work around fuzz_connect_remote() limitations 2020-12-06 21:27:25 +08:00
common-algo.c Make "Too many remote algorithms" exit rather than log 2020-10-24 19:28:29 +08:00
common-channel.c Split ChanType closehandler() and cleanup() so that dbclient doesn't 2018-11-14 22:57:56 +08:00
common-chansession.c
common-kex.c Disallow extra kexinit messages 2020-10-18 22:17:54 +08:00
common-runopts.c Make "dbclient -m help -c help" work 2020-05-26 20:15:39 +08:00
common-session.c Fix #ifdef DROPBEAR_FUZZ (caught by linter) 2020-10-21 20:49:22 +08:00
compat.c Merge pull request #31 from bengardner/PATH_DEVNULL 2017-06-02 22:57:09 +08:00
compat.h fix empty C prototypes 2016-03-16 22:41:20 +08:00
config.guess Update config.sub to 2019-01-05 and config.guess to 2019-03-04 2019-03-23 21:19:02 +08:00
config.sub Update config.sub to 2019-01-05 and config.guess to 2019-03-04 2019-03-23 21:19:02 +08:00
configure.ac Move fuzzing code to fuzz/ subdirectory, improve Makefile.in 2020-10-23 23:10:20 +08:00
crypto_desc.c Use Dropbear's random source rather than libtommath's platform 2020-10-19 22:49:19 +08:00
crypto_desc.h fix empty C prototypes 2016-03-16 22:41:20 +08:00
curve25519.c void return types for curve25519 2020-05-30 00:05:49 +08:00
curve25519.h void return types for curve25519 2020-05-30 00:05:49 +08:00
dbclient.1 Some minor manpage improvements 2020-12-05 14:56:53 +08:00
dbhelpers.c some linting after fuzz merge (#60) 2018-03-03 11:06:45 +08:00
dbhelpers.h include config.h for options.h. don't need to include options.h when 2018-02-18 11:22:13 +08:00
dbmalloc.c Update LibTomMath to 1.2.0 (#84) 2020-05-26 23:36:47 +08:00
dbmalloc.h Attempt to fix m_free for libtomcrypt/libtommath 2018-03-02 00:02:06 +08:00
dbmulti.c
dbrandom.c Fuzzing - get rid of "prefix" for streams 2020-11-01 23:44:58 +08:00
dbrandom.h Pointer parameter could be declared as pointing to const 2017-08-19 17:16:13 +02:00
dbutil.c Print ascii in printhex too 2020-10-26 22:51:44 +08:00
dbutil.h - Add adaptive authentication failure delay 2018-11-05 23:36:34 +08:00
debug.h Remove unused DEBUG_FORKGPROF 2020-05-29 23:32:19 +08:00
default_options.h Disable by default 3des, cbc, hmac-sha1-96, x11 forwarding 2020-06-11 00:09:15 +08:00
DEVELOPING.md Some notes on style 2020-06-26 20:41:34 +08:00
dh_groups.c Fix typo DROPBEAR_NORMAL_DH 2020-05-28 23:23:54 +08:00
dh_groups.h Fix typo DROPBEAR_NORMAL_DH 2020-05-28 23:23:54 +08:00
dropbear_lint.sh Add linter for #ifdef 2020-05-24 13:15:24 +08:00
dropbear.8 Some minor manpage improvements 2020-12-05 14:56:53 +08:00
dropbearconvert.1
dropbearconvert.c Convert #ifdef to #if, other build changes 2016-05-04 15:33:40 +02:00
dropbearkey.1 Mention Ed25519 in dropbearkey man (#94) 2020-05-25 21:28:27 +08:00
dropbearkey.c send and handle SSH_MSG_EXT_INFO only at the correct point 2020-05-24 14:16:58 +08:00
dss.c Update LibTomMath to 1.2.0 (#84) 2020-05-26 23:36:47 +08:00
dss.h use sigtype where appropriate 2020-04-06 23:18:26 +08:00
ecc.c Update LibTomMath to 1.2.0 (#84) 2020-05-26 23:36:47 +08:00
ecc.h include config.h for options.h. don't need to include options.h when 2018-02-18 11:22:13 +08:00
ecdsa.c include config.h for options.h. don't need to include options.h when 2018-02-18 11:22:13 +08:00
ecdsa.h It turns out you can't have a single-quote in an #error 2018-03-08 22:37:54 +08:00
ed25519.c fix trace messages (#105) 2020-06-23 22:20:05 +08:00
ed25519.h use sigtype where appropriate 2020-04-06 23:18:26 +08:00
fake-rfc2553.c
fake-rfc2553.h
filelist.txt Add Ed25519 support (#91) 2020-03-12 00:09:45 +08:00
fuzz-wrapfd.h fuzz: make postauth set authdone properly 2020-12-03 22:18:51 +08:00
fuzz.h fuzz: add an always-failing dropbear_listen() replacement 2020-12-06 21:54:01 +08:00
FUZZER-NOTES.md Add Ed25519 support (#91) 2020-03-12 00:09:45 +08:00
fuzzers_test.sh Change secure.ucc.asn.au/hg to hg.ucc.asn.au 2020-07-28 18:53:48 +08:00
gcm.c Fix ChaCha20 on 32-bit platforms (#99) 2020-05-29 21:26:22 +08:00
gcm.h Add Chacha20-Poly1305, AES128-GCM and AES256-GCM support (#93) 2020-05-25 23:50:25 +08:00
gendss.c update ltm to 1.1.0 and enable FIPS 186.4 compliant key-generation (#79) 2019-09-16 21:50:38 +08:00
gendss.h Convert #ifdef to #if, other build changes 2016-05-04 15:33:40 +02:00
gened25519.c Add Ed25519 support (#91) 2020-03-12 00:09:45 +08:00
gened25519.h Add Ed25519 support (#91) 2020-03-12 00:09:45 +08:00
genrsa.c Update LibTomMath to 1.2.0 (#84) 2020-05-26 23:36:47 +08:00
genrsa.h Convert #ifdef to #if, other build changes 2016-05-04 15:33:40 +02:00
gensignkey.c Fallback for key gen without hard link support (#89) 2020-03-14 22:37:35 +08:00
gensignkey.h add configuration option for default RSA size. 2017-06-24 23:32:25 +08:00
ifndef_wrapper.sh avoid extended regex features to avoid caring about sed -r vs -E 2018-07-24 20:19:05 +08:00
includes.h move GNU_SOURCE earlier 2020-06-23 22:24:58 +08:00
INSTALL Add DEVELOPING.md 2020-06-15 22:30:28 +08:00
install-sh
kex.h Allow DH to be completely disabled (#97) 2020-05-28 23:01:48 +08:00
keyimport.c Add buf_decrpos() 2020-10-24 18:56:45 +08:00
keyimport.h Pointer parameter could be declared as pointing to const 2017-08-19 17:16:13 +02:00
LICENSE Refer to libtom license files 2020-06-25 23:18:16 +08:00
list.c include config.h for options.h. don't need to include options.h when 2018-02-18 11:22:13 +08:00
list.h fix empty C prototypes 2016-03-16 22:41:20 +08:00
listener.c Fix null pointer dereference removing listeners 2020-12-07 20:03:24 +08:00
listener.h Pointer parameter could be declared as pointing to const (callback) 2017-08-19 22:39:53 +02:00
loginrec.c loginrec close fd on error path 2018-02-17 12:16:18 +08:00
loginrec.h remove unused loginrec_set_addr() 2016-03-15 22:04:13 +08:00
ltc_prng.c include config.h for options.h. don't need to include options.h when 2018-02-18 11:22:13 +08:00
ltc_prng.h include config.h for options.h. don't need to include options.h when 2018-02-18 11:22:13 +08:00
Makefile.in fuzz: skip custom mutators with -fsanitize=memory 2020-12-05 11:54:53 +08:00
MULTI
netio.c fuzz: add an always-failing dropbear_listen() replacement 2020-12-06 21:54:01 +08:00
netio.h bind to port as well with -b 2018-01-26 00:28:25 +08:00
options.h mention localoptions.h being build directory, fix underscore in CHANGES 2018-03-01 22:12:30 +08:00
packet.c Load password and key for client fuzzer. 2020-10-20 23:34:38 +08:00
packet.h get rid of unused packet_type in encrypted write queue 2018-03-04 14:57:18 +08:00
process-packet.c merge rsa-sha256 2020-05-26 00:24:02 +08:00
progressmeter.c
progressmeter.h
pubkeyapi.h Rename EPKA -> Plugin 2019-05-15 21:59:45 +08:00
queue.c Pointer parameter could be declared as pointing to const 2017-08-19 17:16:13 +02:00
queue.h Pointer parameter could be declared as pointing to const 2017-08-19 17:16:13 +02:00
README Add Ed25519 support (#91) 2020-03-12 00:09:45 +08:00
release.sh can't call "make lint" without configure 2020-06-15 23:38:08 +08:00
rsa.c Update LibTomMath to 1.2.0 (#84) 2020-05-26 23:36:47 +08:00
rsa.h split signkey_type and signature_type for RSA sha1 vs sha256 2020-05-17 23:58:31 +08:00
runopts.h Rename EPKA -> Plugin 2019-05-15 21:59:45 +08:00
scp.c scp.c: Port OpenSSH CVE-2018-20685 fix (#80) 2020-05-25 20:54:29 +08:00
scpmisc.c use strlcpy & strlcat (#74) 2019-03-20 22:09:19 +08:00
scpmisc.h fix some gcc warnings (#73) 2019-03-20 22:25:15 +08:00
service.h fix empty C prototypes 2016-03-16 22:41:20 +08:00
session.h Get client fuzzer building and starting (fails straight away) 2020-10-18 12:17:39 +08:00
signkey.c Add buf_decrpos() 2020-10-24 18:56:45 +08:00
signkey.h ext-info handling for server-sig-algs 2020-05-19 00:31:41 +08:00
SMALL
ssh.h ext-info handling for server-sig-algs 2020-05-19 00:31:41 +08:00
sshpty.c
sshpty.h
svr-agentfwd.c Support servers without multiple user support (#76) 2019-03-20 22:44:49 +08:00
svr-auth.c Improve address logging on early exit messages (#83) 2020-03-18 23:28:56 +08:00
svr-authpam.c Fix for issue successfull login of disabled user (#78) 2019-03-20 22:03:40 +08:00
svr-authpasswd.c limit password length to 100 2019-03-21 00:09:07 +08:00
svr-authpubkey.c Add buf_decrpos() 2020-10-24 18:56:45 +08:00
svr-authpubkeyoptions.c Don't choke on disabled authorized_keys(5) options 2020-06-26 20:56:03 +08:00
svr-chansession.c Avoid gnu extension conditional operator 2020-10-08 11:00:04 +08:00
svr-kex.c send and handle SSH_MSG_EXT_INFO only at the correct point 2020-05-24 14:16:58 +08:00
svr-main.c Delay seedrandom until connections 2020-06-15 22:24:34 +08:00
svr-runopts.c send and handle SSH_MSG_EXT_INFO only at the correct point 2020-05-24 14:16:58 +08:00
svr-service.c more linting (#58) 2018-02-26 21:31:15 +08:00
svr-session.c fuzz: make postauth set authdone properly 2020-12-03 22:18:51 +08:00
svr-tcpfwd.c Fix handling of replies to global requests (#112) 2020-12-10 23:13:13 +08:00
svr-x11fwd.c Split ChanType closehandler() and cleanup() so that dbclient doesn't 2018-11-14 22:57:56 +08:00
sysoptions.h Changelog for 2020.81 2020-10-29 21:35:50 +08:00
tcp-accept.c FIx remote forward listeners 2018-09-07 23:02:20 +08:00
tcpfwd.h FIx remote forward listeners 2018-09-07 23:02:20 +08:00
termcodes.c termcodes: make VEOL2, VWERASE, VLNEXT, ECHOCTL, and ECHOKE optional 2016-05-25 10:03:53 -05:00
termcodes.h
x11fwd.h Pointer parameter could be declared as pointing to const 2017-08-19 17:16:13 +02:00

This is Dropbear, a smallish SSH server and client.
https://matt.ucc.asn.au/dropbear/dropbear.html

INSTALL has compilation instructions.

MULTI has instructions on making a multi-purpose binary (ie a single binary
which performs multiple tasks, to save disk space)

SMALL has some tips on creating small binaries.

Please contact me if you have any questions/bugs found/features/ideas/comments etc :)
There is also a mailing list http://lists.ucc.gu.uwa.edu.au/mailman/listinfo/dropbear

Matt Johnston
matt@ucc.asn.au


In the absence of detailed documentation, some notes follow:
============================================================================

Server public key auth:

You can use ~/.ssh/authorized_keys in the same way as with OpenSSH, just put
the key entries in that file. They should be of the form:

ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAwVa6M6cGVmUcLl2cFzkxEoJd06Ub4bVDsYrWvXhvUV+ZAM9uGuewZBDoAqNKJxoIn0Hyd0Nk/yU99UVv6NWV/5YSHtnf35LKds56j7cuzoQpFIdjNwdxAN0PCET/MG8qyskG/2IE2DPNIaJ3Wy+Ws4IZEgdJgPlTYUBWWtCWOGc= someone@hostname

You must make sure that ~/.ssh, and the key file, are only writable by the
user. Beware of editors that split the key into multiple lines.

Dropbear supports some options for authorized_keys entries, see the manpage.

============================================================================

Client public key auth:

Dropbear can do public key auth as a client, but you will have to convert
OpenSSH style keys to Dropbear format, or use dropbearkey to create them.

If you have an OpenSSH-style private key ~/.ssh/id_rsa, you need to do:

dropbearconvert openssh dropbear ~/.ssh/id_rsa  ~/.ssh/id_rsa.db
dbclient -i ~/.ssh/id_rsa.db <hostname>

Dropbear does not support encrypted hostkeys though can connect to ssh-agent.

============================================================================

If you want to get the public-key portion of a Dropbear private key, look at
dropbearkey's '-y' option.

============================================================================

To run the server, you need to generate server keys, this is one-off:
./dropbearkey -t rsa -f dropbear_rsa_host_key
./dropbearkey -t dss -f dropbear_dss_host_key
./dropbearkey -t ecdsa -f dropbear_ecdsa_host_key
./dropbearkey -t ed25519 -f dropbear_ed25519_host_key

or alternatively convert OpenSSH keys to Dropbear:
./dropbearconvert openssh dropbear /etc/ssh/ssh_host_dsa_key dropbear_dss_host_key

You can also get Dropbear to create keys when the first connection is made -
this is preferable to generating keys when the system boots. Make sure 
/etc/dropbear/ exists and then pass '-R' to the dropbear server.

============================================================================

If the server is run as non-root, you most likely won't be able to allocate a
pty, and you cannot login as any user other than that running the daemon
(obviously). Shadow passwords will also be unusable as non-root.

============================================================================

The Dropbear distribution includes a standalone version of OpenSSH's scp
program. You can compile it with "make scp", you may want to change the path
of the ssh binary, specified by _PATH_SSH_PROGRAM in options.h . By default
the progress meter isn't compiled in to save space, you can enable it by 
adding 'SCPPROGRESS=1' to the make commandline.