Mercurial > dropbear

comparison README @ 72:9597c2e3b9d4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Some doc changes
author Matt Johnston <matt@ucc.asn.au>
date Fri, 13 Aug 2004 10:58:51 +0000
parents fe6bca95afa7
children a54d20c96178
comparison
equal deleted inserted replaced
71:ac96bc733e71 72:9597c2e3b9d4
1 This is Dropbear, a smallish SSH 2 server. 1 This is Dropbear, a smallish SSH 2 server and client.
2 2
3 INSTALL has compilation instructions. 3 INSTALL has compilation instructions.
4 4
5 MULTI has instructions on making a multi-purpose binary (ie a single binary 5 MULTI has instructions on making a multi-purpose binary (ie a single binary
6 which performs multiple tasks, to save disk space) 6 which performs multiple tasks, to save disk space)
10 See TODO for a few of the things I know need looking at, and please contact 10 See TODO for a few of the things I know need looking at, and please contact
11 me if you have any questions/bugs found/features/ideas/comments etc :) 11 me if you have any questions/bugs found/features/ideas/comments etc :)
12 12
13 Matt Johnston 13 Matt Johnston
14 [email protected] 14 [email protected]
15
16 ============================================================================
17
18 Public key auth:
19
20 You can use ~/.ssh/authorized_keys in the same way as with OpenSSH, just put
21 the key entries in that file. They should be of the form:
22
23 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAwVa6M6cGVmUcLl2cFzkxEoJd06Ub4bVDsYrWvXhvUV+ZAM9uGuewZBDoAqNKJxoIn0Hyd0Nk/yU99UVv6NWV/5YSHtnf35LKds56j7cuzoQpFIdjNwdxAN0PCET/MG8qyskG/2IE2DPNIaJ3Wy+Ws4IZEgdJgPlTYUBWWtCWOGc= someone@hostname
24
25 You must make sure that ~/.ssh, and the key file, are only writable by the
26 user.
27
28 NOTE: Dropbear ignores authorized_keys options such as those described in the
29 OpenSSH sshd manpage, and will not allow a login for these keys.
30
31 To run the server, you need to generate server keys, this is one-off:
32 ./dropbearkey -t rsa -f dropbear_rsa_host_key
33 ./dropbearkey -t dss -f dropbear_dss_host_key
34
35 or alternatively convert OpenSSH keys to Dropbear:
36 ./dropbearconvert openssh dropbear /etc/ssh/ssh_host_dsa_key dropbear_dss_host_key
37
38 And you can now run the server.
39 ./dropbear
40
41 or './dropbear -h' to get options.
42
43 If the server is run as non-root, you most likely won't be able to allocate a
44 pty, and you cannot login as any user other than that running the daemon
45 (obviously). Shadow passwords will also be unusable as non-root.
46
47 The Dropbear distribution includes a standalone version of OpenSSH's scp
48 program. You can compile it with "make scp", you may want to change the path
49 of the ssh binary, specified near the top of the scp.c file. By default
50 the progress meter isn't compiled in to save space, you can enable it with
51 "make scp-progress".
52