1<section xmlns="http://docbook.org/ns/docbook"
2 xmlns:xlink="http://www.w3.org/1999/xlink"
3 xmlns:xi="http://www.w3.org/2001/XInclude"
4 version="5.0"
5 xml:id="sec-ssh">
6 <title>Secure Shell Access</title>
7
8 <para>
9 Secure shell (SSH) access to your machine can be enabled by setting:
10<programlisting>
11<xref linkend="opt-services.openssh.enable"/> = true;
12</programlisting>
13 By default, root logins using a password are disallowed. They can be disabled
14 entirely by setting <xref linkend="opt-services.openssh.permitRootLogin"/> to
15 <literal>"no"</literal>.
16 </para>
17
18 <para>
19 You can declaratively specify authorised RSA/DSA public keys for a user as
20 follows:
21<!-- FIXME: this might not work if the user is unmanaged. -->
22<programlisting>
23<link linkend="opt-users.users._name__.openssh.authorizedKeys.keys">users.users.alice.openssh.authorizedKeys.keys</link> =
24 [ "ssh-dss AAAAB3NzaC1kc3MAAACBAPIkGWVEt4..." ];
25</programlisting>
26 </para>
27</section>