website diff 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 diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/en/doc/handbook/secure-server.html Sat May 10 17:14:02 2008 +0000 1.3 @@ -0,0 +1,130 @@ 1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 1.5 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head><title>SliTaz Handbook (en) - Template</title> 1.6 + 1.7 + 1.8 + 1.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.10 + <meta name="description" content="slitaz English handbook" /> 1.11 + <meta name="expires" content="never" /> 1.12 + <meta name="modified" content="2008-02-26 18:30:00" /> 1.13 + <meta name="publisher" content="www.slitaz.org" /> 1.14 + <meta name="author" content="Christophe Lincoln" /> 1.15 + <link rel="shortcut icon" href="favicon.ico" /> 1.16 + <link rel="stylesheet" type="text/css" href="book.css" /></head><body bgcolor="#ffffff"> 1.17 + 1.18 +<!-- Header and quick navigation --> 1.19 +<div id="header"> 1.20 +<div id="quicknav" align="right"> 1.21 + <a name="top"></a> 1.22 + <a href="index.html">Table of contents</a> 1.23 +</div> 1.24 +<h1><font color="#3e1220">SliTaz Handbook (en)</font></h1> 1.25 +</div> 1.26 + 1.27 +<!-- Content. --> 1.28 +<div id="content"> 1.29 +<div class="content-right"></div> 1.30 + 1.31 +<h2><font color="#df8f06">Secure SHell (SSH)</font></h2> 1.32 + 1.33 +<ul> 1.34 + <li><a href="#about">About Dropbear.</a></li> 1.35 + <li><a href="#dbclient">Connecting to a remote host.</a> - (dbclient).</li> 1.36 + <li><a href="#scp">Transfer files</a> - (scp).</li> 1.37 + <li><a href="#dropbearkey">Generate keys rsa/dss.</a> - (dropbearkey).</li> 1.38 + <li><a href="#start-stop-restart">Start, stop, restart SSH server.</a></li> 1.39 +</ul> 1.40 + 1.41 +<a name="about"></a> 1.42 +<h3>About Dropbear</h3> 1.43 +<p> 1.44 +Control and administer remotely with the Dropbear SSH secure server. Dropbear is a small SSH client/server 1.45 +supporting SSH 2, it's compatible with OpenSSH and uses ~/.ssh/authorized_keys for the management of public keys. 1.46 +Dropbear also provides it's own version of <code>scp</code>, allowing you to copy files 1.47 +between remote machines in a secure manner. 1.48 +</p> 1.49 +<p> 1.50 +Project website: 1.51 +<a href="http://matt.ucc.asn.au/dropbear/dropbear.html">matt.ucc.asn.au/dropbear/dropbear.html</a> 1.52 +</p> 1.53 + 1.54 +<a name="dbclient"></a> 1.55 +<h3>Connecting to a remote host with dbclient</h3> 1.56 +<p> 1.57 +The configuration files for the SSH client are located in the ~/.ssh directory of each user, this contains 1.58 +the authorized_keys and known_hosts files. The directory ~/.ssh and known_hosts file are automatically created 1.59 +the first time you run the Dropbear server. 1.60 +</p> 1.61 +<p> 1.62 +To connect to a remote host using the user and machine name: 1.63 +</p> 1.64 +<pre> $ dbclient user@machine.org 1.65 +</pre> 1.66 +<p> 1.67 +You can also connect using the IP address of the machine: 1.68 +</p> 1.69 +<pre> $ dbclient user@192.168.0.2 1.70 +</pre> 1.71 + 1.72 +<a name="scp"></a> 1.73 +<h3>Transfer of remote files with scp</h3> 1.74 +<p> 1.75 +To copy a file from your computer to another, scp can be utilized in the following way. To copy a file 1.76 +named page.html to a remote directory of the user (don't forget the <code>:</code> after the machine name or 1.77 +IP address): 1.78 +</p> 1.79 +<pre> $ scp page.html user@machine.org:Folder/Sub-Folder 1.80 +</pre> 1.81 +<p> 1.82 +Copy a file from a remote machine to your local machine: 1.83 +</p> 1.84 +<pre> $ scp user@machine.org:Folder/Sub-Folder/page.html /path/your/machine 1.85 +</pre> 1.86 + 1.87 +<a name="dropbearkey"></a> 1.88 +<h3>Generate rsa/dss keys with dropbearkey</h3> 1.89 +<p> 1.90 +Dropbear provides <code>dropbearkey</code> to generate the protected keys rsa 1.91 +and dss. Note that when you start the server for the first time, secure keys will be 1.92 +automatically generated if they don't already exist. You can use <code>dropbearkey</code> with 1.93 +the following argurments: 1.94 +</p> 1.95 +<pre> # dropbearkey -t rsa -f /etc/dropbear/dropbear_rsa_host_key 1.96 + # dropbearkey -t dss -f /etc/dropbear/dropbear_dss_host_key 1.97 +</pre> 1.98 + 1.99 +<a name="start-stop-restart"></a> 1.100 +<h3>Start, stop, restart the SSH server</h3> 1.101 +<p> 1.102 +By default SliTaz will not start the SSH server at boot, to be launched automatically <code>dropbear</code> 1.103 +must be added to the variable RUN_DAEMONS in the <code>/etc/rcS.conf</code> file. To start, stop or restart 1.104 +the SSH server; use the following commands: <code>/etc/init.d/dropbear [start|stop|restart]</code>. 1.105 +Example to start the server: 1.106 +</p> 1.107 +<pre> # /etc/init.d/dropbear start 1.108 +</pre> 1.109 +<p> 1.110 +Note that the server supports the passing of various options when launched. To change the default values, 1.111 +simple modify the daemons configuration file <code>/etc/daemons.conf</code>. 1.112 +</p> 1.113 + 1.114 +<!-- End of content --> 1.115 +</div> 1.116 + 1.117 +<!-- Footer. --> 1.118 +<div id="footer"> 1.119 + <div class="footer-right"></div> 1.120 + <a href="#top">Top of the page</a> | 1.121 + <a href="http://www.slitaz.org/en/doc/handbook/index.html">Table of contents</a> 1.122 +</div> 1.123 + 1.124 +<div id="copy"> 1.125 + Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> - 1.126 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 1.127 + Documentation is under 1.128 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 1.129 + and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>. 1.130 +</div> 1.131 + 1.132 +</body></html> 1.133 +