website view en/doc/handbook/secure-server.html @ rev 42
Add Dropbear SSH to Handbook (en) and fix typos
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Sat May 10 17:14:02 2008 +0000 (2008-05-10) |
| parents | |
| children | a41653d22e7c |
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><title>SliTaz Handbook (en) - Template</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="slitaz English handbook" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2008-02-26 18:30:00" />
10 <meta name="publisher" content="www.slitaz.org" />
11 <meta name="author" content="Christophe Lincoln" />
12 <link rel="shortcut icon" href="favicon.ico" />
13 <link rel="stylesheet" type="text/css" href="book.css" /></head><body bgcolor="#ffffff">
15 <!-- Header and quick navigation -->
16 <div id="header">
17 <div id="quicknav" align="right">
18 <a name="top"></a>
19 <a href="index.html">Table of contents</a>
20 </div>
21 <h1><font color="#3e1220">SliTaz Handbook (en)</font></h1>
22 </div>
24 <!-- Content. -->
25 <div id="content">
26 <div class="content-right"></div>
28 <h2><font color="#df8f06">Secure SHell (SSH)</font></h2>
30 <ul>
31 <li><a href="#about">About Dropbear.</a></li>
32 <li><a href="#dbclient">Connecting to a remote host.</a> - (dbclient).</li>
33 <li><a href="#scp">Transfer files</a> - (scp).</li>
34 <li><a href="#dropbearkey">Generate keys rsa/dss.</a> - (dropbearkey).</li>
35 <li><a href="#start-stop-restart">Start, stop, restart SSH server.</a></li>
36 </ul>
38 <a name="about"></a>
39 <h3>About Dropbear</h3>
40 <p>
41 Control and administer remotely with the Dropbear SSH secure server. Dropbear is a small SSH client/server
42 supporting SSH 2, it's compatible with OpenSSH and uses ~/.ssh/authorized_keys for the management of public keys.
43 Dropbear also provides it's own version of <code>scp</code>, allowing you to copy files
44 between remote machines in a secure manner.
45 </p>
46 <p>
47 Project website:
48 <a href="http://matt.ucc.asn.au/dropbear/dropbear.html">matt.ucc.asn.au/dropbear/dropbear.html</a>
49 </p>
51 <a name="dbclient"></a>
52 <h3>Connecting to a remote host with dbclient</h3>
53 <p>
54 The configuration files for the SSH client are located in the ~/.ssh directory of each user, this contains
55 the authorized_keys and known_hosts files. The directory ~/.ssh and known_hosts file are automatically created
56 the first time you run the Dropbear server.
57 </p>
58 <p>
59 To connect to a remote host using the user and machine name:
60 </p>
61 <pre> $ dbclient user@machine.org
62 </pre>
63 <p>
64 You can also connect using the IP address of the machine:
65 </p>
66 <pre> $ dbclient user@192.168.0.2
67 </pre>
69 <a name="scp"></a>
70 <h3>Transfer of remote files with scp</h3>
71 <p>
72 To copy a file from your computer to another, scp can be utilized in the following way. To copy a file
73 named page.html to a remote directory of the user (don't forget the <code>:</code> after the machine name or
74 IP address):
75 </p>
76 <pre> $ scp page.html user@machine.org:Folder/Sub-Folder
77 </pre>
78 <p>
79 Copy a file from a remote machine to your local machine:
80 </p>
81 <pre> $ scp user@machine.org:Folder/Sub-Folder/page.html /path/your/machine
82 </pre>
84 <a name="dropbearkey"></a>
85 <h3>Generate rsa/dss keys with dropbearkey</h3>
86 <p>
87 Dropbear provides <code>dropbearkey</code> to generate the protected keys rsa
88 and dss. Note that when you start the server for the first time, secure keys will be
89 automatically generated if they don't already exist. You can use <code>dropbearkey</code> with
90 the following argurments:
91 </p>
92 <pre> # dropbearkey -t rsa -f /etc/dropbear/dropbear_rsa_host_key
93 # dropbearkey -t dss -f /etc/dropbear/dropbear_dss_host_key
94 </pre>
96 <a name="start-stop-restart"></a>
97 <h3>Start, stop, restart the SSH server</h3>
98 <p>
99 By default SliTaz will not start the SSH server at boot, to be launched automatically <code>dropbear</code>
100 must be added to the variable RUN_DAEMONS in the <code>/etc/rcS.conf</code> file. To start, stop or restart
101 the SSH server; use the following commands: <code>/etc/init.d/dropbear [start|stop|restart]</code>.
102 Example to start the server:
103 </p>
104 <pre> # /etc/init.d/dropbear start
105 </pre>
106 <p>
107 Note that the server supports the passing of various options when launched. To change the default values,
108 simple modify the daemons configuration file <code>/etc/daemons.conf</code>.
109 </p>
111 <!-- End of content -->
112 </div>
114 <!-- Footer. -->
115 <div id="footer">
116 <div class="footer-right"></div>
117 <a href="#top">Top of the page</a> |
118 <a href="http://www.slitaz.org/en/doc/handbook/index.html">Table of contents</a>
119 </div>
121 <div id="copy">
122 Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
123 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
124 Documentation is under
125 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
126 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
127 </div>
129 </body></html>