mirror of
https://git.in.rschanz.org/ryan77627/guix.git
synced 2024-11-14 10:55:23 -05:00
d8f3128119
* gnu/services/ssh.scm (<openssh-configuration>): Add default values. [pubkey-authentication?]: Rename to... [public-key-authentication?]: ... this. (openssh-service): Remove. * doc/guix.texi (Networking Services): Adjust accordingly.
446 lines
18 KiB
Scheme
446 lines
18 KiB
Scheme
;;; GNU Guix --- Functional package management for GNU
|
||
;;; Copyright © 2014, 2015, 2016 Ludovic Courtès <ludo@gnu.org>
|
||
;;; Copyright © 2016 David Craven <david@craven.ch>
|
||
;;; Copyright © 2016 Julien Lepiller <julien@lepiller.eu>
|
||
;;;
|
||
;;; This file is part of GNU Guix.
|
||
;;;
|
||
;;; GNU Guix is free software; you can redistribute it and/or modify it
|
||
;;; under the terms of the GNU General Public License as published by
|
||
;;; the Free Software Foundation; either version 3 of the License, or (at
|
||
;;; your option) any later version.
|
||
;;;
|
||
;;; GNU Guix is distributed in the hope that it will be useful, but
|
||
;;; WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
;;; GNU General Public License for more details.
|
||
;;;
|
||
;;; You should have received a copy of the GNU General Public License
|
||
;;; along with GNU Guix. If not, see <http://www.gnu.org/licenses/>.
|
||
|
||
(define-module (gnu services ssh)
|
||
#:use-module (gnu packages ssh)
|
||
#:use-module (gnu packages admin)
|
||
#:use-module (gnu services)
|
||
#:use-module (gnu services shepherd)
|
||
#:use-module (gnu system pam)
|
||
#:use-module (gnu system shadow)
|
||
#:use-module (guix gexp)
|
||
#:use-module (guix records)
|
||
#:use-module (srfi srfi-26)
|
||
#:use-module (ice-9 match)
|
||
#:export (lsh-configuration
|
||
lsh-configuration?
|
||
lsh-service
|
||
lsh-service-type
|
||
|
||
openssh-configuration
|
||
openssh-configuration?
|
||
openssh-service-type
|
||
openssh-service
|
||
|
||
dropbear-configuration
|
||
dropbear-configuration?
|
||
dropbear-service-type
|
||
dropbear-service))
|
||
|
||
;;; Commentary:
|
||
;;;
|
||
;;; This module implements secure shell (SSH) services.
|
||
;;;
|
||
;;; Code:
|
||
|
||
(define-record-type* <lsh-configuration>
|
||
lsh-configuration make-lsh-configuration
|
||
lsh-configuration?
|
||
(lsh lsh-configuration-lsh
|
||
(default lsh))
|
||
(daemonic? lsh-configuration-daemonic?)
|
||
(host-key lsh-configuration-host-key)
|
||
(interfaces lsh-configuration-interfaces)
|
||
(port-number lsh-configuration-port-number)
|
||
(allow-empty-passwords? lsh-configuration-allow-empty-passwords?)
|
||
(root-login? lsh-configuration-root-login?)
|
||
(syslog-output? lsh-configuration-syslog-output?)
|
||
(pid-file? lsh-configuration-pid-file?)
|
||
(pid-file lsh-configuration-pid-file)
|
||
(x11-forwarding? lsh-configuration-x11-forwarding?)
|
||
(tcp/ip-forwarding? lsh-configuration-tcp/ip-forwarding?)
|
||
(password-authentication? lsh-configuration-password-authentication?)
|
||
(public-key-authentication? lsh-configuration-public-key-authentication?)
|
||
(initialize? lsh-configuration-initialize?))
|
||
|
||
(define %yarrow-seed
|
||
"/var/spool/lsh/yarrow-seed-file")
|
||
|
||
(define (lsh-initialization lsh host-key)
|
||
"Return the gexp to initialize the LSH service for HOST-KEY."
|
||
#~(begin
|
||
(unless (file-exists? #$%yarrow-seed)
|
||
(system* (string-append #$lsh "/bin/lsh-make-seed")
|
||
"--sloppy" "-o" #$%yarrow-seed))
|
||
|
||
(unless (file-exists? #$host-key)
|
||
(mkdir-p (dirname #$host-key))
|
||
(format #t "creating SSH host key '~a'...~%" #$host-key)
|
||
|
||
;; FIXME: We're just doing a simple pipeline, but 'system' cannot be
|
||
;; used yet because /bin/sh might be dangling; factorize this somehow.
|
||
(let* ((in+out (pipe))
|
||
(keygen (primitive-fork)))
|
||
(case keygen
|
||
((0)
|
||
(close-port (car in+out))
|
||
(close-fdes 1)
|
||
(dup2 (fileno (cdr in+out)) 1)
|
||
(execl (string-append #$lsh "/bin/lsh-keygen")
|
||
"lsh-keygen" "--server"))
|
||
(else
|
||
(let ((write-key (primitive-fork)))
|
||
(case write-key
|
||
((0)
|
||
(close-port (cdr in+out))
|
||
(close-fdes 0)
|
||
(dup2 (fileno (car in+out)) 0)
|
||
(execl (string-append #$lsh "/bin/lsh-writekey")
|
||
"lsh-writekey" "--server" "-o" #$host-key))
|
||
(else
|
||
(close-port (car in+out))
|
||
(close-port (cdr in+out))
|
||
(waitpid keygen)
|
||
(waitpid write-key))))))))))
|
||
|
||
(define (lsh-activation config)
|
||
"Return the activation gexp for CONFIG."
|
||
#~(begin
|
||
(use-modules (guix build utils))
|
||
(mkdir-p "/var/spool/lsh")
|
||
#$(if (lsh-configuration-initialize? config)
|
||
(lsh-initialization (lsh-configuration-lsh config)
|
||
(lsh-configuration-host-key config))
|
||
#t)))
|
||
|
||
(define (lsh-shepherd-service config)
|
||
"Return a <shepherd-service> for lsh with CONFIG."
|
||
(define lsh (lsh-configuration-lsh config))
|
||
(define pid-file (lsh-configuration-pid-file config))
|
||
(define pid-file? (lsh-configuration-pid-file? config))
|
||
(define daemonic? (lsh-configuration-daemonic? config))
|
||
(define interfaces (lsh-configuration-interfaces config))
|
||
|
||
(define lsh-command
|
||
(append
|
||
(cons (file-append lsh "/sbin/lshd")
|
||
(if daemonic?
|
||
(let ((syslog (if (lsh-configuration-syslog-output? config)
|
||
'()
|
||
(list "--no-syslog"))))
|
||
(cons "--daemonic"
|
||
(if pid-file?
|
||
(cons #~(string-append "--pid-file=" #$pid-file)
|
||
syslog)
|
||
(cons "--no-pid-file" syslog))))
|
||
(if pid-file?
|
||
(list #~(string-append "--pid-file=" #$pid-file))
|
||
'())))
|
||
(cons* #~(string-append "--host-key="
|
||
#$(lsh-configuration-host-key config))
|
||
#~(string-append "--password-helper=" #$lsh "/sbin/lsh-pam-checkpw")
|
||
#~(string-append "--subsystems=sftp=" #$lsh "/sbin/sftp-server")
|
||
"-p" (number->string (lsh-configuration-port-number config))
|
||
(if (lsh-configuration-password-authentication? config)
|
||
"--password" "--no-password")
|
||
(if (lsh-configuration-public-key-authentication? config)
|
||
"--publickey" "--no-publickey")
|
||
(if (lsh-configuration-root-login? config)
|
||
"--root-login" "--no-root-login")
|
||
(if (lsh-configuration-x11-forwarding? config)
|
||
"--x11-forward" "--no-x11-forward")
|
||
(if (lsh-configuration-tcp/ip-forwarding? config)
|
||
"--tcpip-forward" "--no-tcpip-forward")
|
||
(if (null? interfaces)
|
||
'()
|
||
(map (cut string-append "--interface=" <>)
|
||
interfaces)))))
|
||
|
||
(define requires
|
||
(if (and daemonic? (lsh-configuration-syslog-output? config))
|
||
'(networking syslogd)
|
||
'(networking)))
|
||
|
||
(list (shepherd-service
|
||
(documentation "GNU lsh SSH server")
|
||
(provision '(ssh-daemon))
|
||
(requirement requires)
|
||
(start #~(make-forkexec-constructor (list #$@lsh-command)))
|
||
(stop #~(make-kill-destructor)))))
|
||
|
||
(define (lsh-pam-services config)
|
||
"Return a list of <pam-services> for lshd with CONFIG."
|
||
(list (unix-pam-service
|
||
"lshd"
|
||
#:allow-empty-passwords?
|
||
(lsh-configuration-allow-empty-passwords? config))))
|
||
|
||
(define lsh-service-type
|
||
(service-type (name 'lsh)
|
||
(extensions
|
||
(list (service-extension shepherd-root-service-type
|
||
lsh-shepherd-service)
|
||
(service-extension pam-root-service-type
|
||
lsh-pam-services)
|
||
(service-extension activation-service-type
|
||
lsh-activation)))))
|
||
|
||
(define* (lsh-service #:key
|
||
(lsh lsh)
|
||
(daemonic? #t)
|
||
(host-key "/etc/lsh/host-key")
|
||
(interfaces '())
|
||
(port-number 22)
|
||
(allow-empty-passwords? #f)
|
||
(root-login? #f)
|
||
(syslog-output? #t)
|
||
(pid-file? #f)
|
||
(pid-file "/var/run/lshd.pid")
|
||
(x11-forwarding? #t)
|
||
(tcp/ip-forwarding? #t)
|
||
(password-authentication? #t)
|
||
(public-key-authentication? #t)
|
||
(initialize? #t))
|
||
"Run the @command{lshd} program from @var{lsh} to listen on port @var{port-number}.
|
||
@var{host-key} must designate a file containing the host key, and readable
|
||
only by root.
|
||
|
||
When @var{daemonic?} is true, @command{lshd} will detach from the
|
||
controlling terminal and log its output to syslogd, unless one sets
|
||
@var{syslog-output?} to false. Obviously, it also makes lsh-service
|
||
depend on existence of syslogd service. When @var{pid-file?} is true,
|
||
@command{lshd} writes its PID to the file called @var{pid-file}.
|
||
|
||
When @var{initialize?} is true, automatically create the seed and host key
|
||
upon service activation if they do not exist yet. This may take long and
|
||
require interaction.
|
||
|
||
When @var{initialize?} is false, it is up to the user to initialize the
|
||
randomness generator (@pxref{lsh-make-seed,,, lsh, LSH Manual}), and to create
|
||
a key pair with the private key stored in file @var{host-key} (@pxref{lshd
|
||
basics,,, lsh, LSH Manual}).
|
||
|
||
When @var{interfaces} is empty, lshd listens for connections on all the
|
||
network interfaces; otherwise, @var{interfaces} must be a list of host names
|
||
or addresses.
|
||
|
||
@var{allow-empty-passwords?} specifies whether to accept log-ins with empty
|
||
passwords, and @var{root-login?} specifies whether to accept log-ins as
|
||
root.
|
||
|
||
The other options should be self-descriptive."
|
||
(service lsh-service-type
|
||
(lsh-configuration (lsh lsh) (daemonic? daemonic?)
|
||
(host-key host-key) (interfaces interfaces)
|
||
(port-number port-number)
|
||
(allow-empty-passwords? allow-empty-passwords?)
|
||
(root-login? root-login?)
|
||
(syslog-output? syslog-output?)
|
||
(pid-file? pid-file?) (pid-file pid-file)
|
||
(x11-forwarding? x11-forwarding?)
|
||
(tcp/ip-forwarding? tcp/ip-forwarding?)
|
||
(password-authentication?
|
||
password-authentication?)
|
||
(public-key-authentication?
|
||
public-key-authentication?)
|
||
(initialize? initialize?))))
|
||
|
||
|
||
;;;
|
||
;;; OpenSSH.
|
||
;;;
|
||
|
||
(define-record-type* <openssh-configuration>
|
||
openssh-configuration make-openssh-configuration
|
||
openssh-configuration?
|
||
(pid-file openssh-configuration-pid-file
|
||
(default "/var/run/sshd.pid"))
|
||
(port-number openssh-configuration-port-number ;integer
|
||
(default 22))
|
||
(permit-root-login openssh-configuration-permit-root-login ;Boolean | 'without-password
|
||
(default #f))
|
||
(allow-empty-passwords? openssh-configuration-allow-empty-passwords? ;Boolean
|
||
(default #f))
|
||
(password-authentication? openssh-configuration-password-authentication? ;Boolean
|
||
(default #t))
|
||
(public-key-authentication? openssh-configuration-public-key-authentication?
|
||
(default #t)) ;Boolean
|
||
(rsa-authentication? openssh-configuration-rsa-authentication? ;Boolean
|
||
(default #t))
|
||
(x11-forwarding? openssh-configuration-x11-forwarding? ;Boolean
|
||
(default #f))
|
||
(protocol-number openssh-configuration-protocol-number ;integer
|
||
(default 2)))
|
||
|
||
(define %openssh-accounts
|
||
(list (user-group (name "sshd") (system? #t))
|
||
(user-account
|
||
(name "sshd")
|
||
(group "sshd")
|
||
(system? #t)
|
||
(comment "sshd privilege separation user")
|
||
(home-directory "/var/run/sshd")
|
||
(shell #~(string-append #$shadow "/sbin/nologin")))))
|
||
|
||
(define (openssh-activation config)
|
||
"Return the activation GEXP for CONFIG."
|
||
#~(begin
|
||
(mkdir-p "/etc/ssh")
|
||
(mkdir-p (dirname #$(openssh-configuration-pid-file config)))
|
||
|
||
;; Generate missing host keys.
|
||
(system* (string-append #$openssh "/bin/ssh-keygen") "-A")))
|
||
|
||
(define (openssh-config-file config)
|
||
"Return the sshd configuration file corresponding to CONFIG."
|
||
(computed-file
|
||
"sshd_config"
|
||
#~(call-with-output-file #$output
|
||
(lambda (port)
|
||
(display "# Generated by 'openssh-service'.\n" port)
|
||
(format port "Protocol ~a\n"
|
||
#$(if (eq? (openssh-configuration-protocol-number config) 1)
|
||
"1" "2"))
|
||
(format port "Port ~a\n"
|
||
#$(number->string (openssh-configuration-port-number config)))
|
||
(format port "PermitRootLogin ~a\n"
|
||
#$(match (openssh-configuration-permit-root-login config)
|
||
(#t "yes")
|
||
(#f "no")
|
||
('without-password "without-password")))
|
||
(format port "PermitEmptyPasswords ~a\n"
|
||
#$(if (openssh-configuration-allow-empty-passwords? config)
|
||
"yes" "no"))
|
||
(format port "PasswordAuthentication ~a\n"
|
||
#$(if (openssh-configuration-password-authentication? config)
|
||
"yes" "no"))
|
||
(format port "PubkeyAuthentication ~a\n"
|
||
#$(if (openssh-configuration-public-key-authentication? config)
|
||
"yes" "no"))
|
||
(format port "RSAAuthentication ~a\n"
|
||
#$(if (openssh-configuration-rsa-authentication? config)
|
||
"yes" "no"))
|
||
(format port "X11Forwarding ~a\n"
|
||
#$(if (openssh-configuration-x11-forwarding? config)
|
||
"yes" "no"))
|
||
(format port "PidFile ~a\n"
|
||
#$(openssh-configuration-pid-file config))
|
||
#t))))
|
||
|
||
(define (openssh-shepherd-service config)
|
||
"Return a <shepherd-service> for openssh with CONFIG."
|
||
|
||
(define pid-file
|
||
(openssh-configuration-pid-file config))
|
||
|
||
(define openssh-command
|
||
#~(list (string-append #$openssh "/sbin/sshd")
|
||
"-D" "-f" #$(openssh-config-file config)))
|
||
|
||
(list (shepherd-service
|
||
(documentation "OpenSSH server.")
|
||
(requirement '(networking syslogd))
|
||
(provision '(ssh-daemon))
|
||
(start #~(make-forkexec-constructor #$openssh-command
|
||
#:pid-file #$pid-file))
|
||
(stop #~(make-kill-destructor)))))
|
||
|
||
(define openssh-service-type
|
||
(service-type (name 'openssh)
|
||
(extensions
|
||
(list (service-extension shepherd-root-service-type
|
||
openssh-shepherd-service)
|
||
(service-extension activation-service-type
|
||
openssh-activation)
|
||
(service-extension account-service-type
|
||
(const %openssh-accounts))))))
|
||
|
||
|
||
;;;
|
||
;;; Dropbear.
|
||
;;;
|
||
|
||
(define-record-type* <dropbear-configuration>
|
||
dropbear-configuration make-dropbear-configuration
|
||
dropbear-configuration?
|
||
(dropbear dropbear-configuration-dropbear
|
||
(default dropbear))
|
||
(port-number dropbear-configuration-port-number
|
||
(default 22))
|
||
(syslog-output? dropbear-configuration-syslog-output?
|
||
(default #t))
|
||
(pid-file dropbear-configuration-pid-file
|
||
(default "/var/run/dropbear.pid"))
|
||
(root-login? dropbear-configuration-root-login?
|
||
(default #f))
|
||
(allow-empty-passwords? dropbear-configuration-allow-empty-passwords?
|
||
(default #f))
|
||
(password-authentication? dropbear-configuration-password-authentication?
|
||
(default #t)))
|
||
|
||
(define (dropbear-activation config)
|
||
"Return the activation gexp for CONFIG."
|
||
#~(begin
|
||
(mkdir-p "/etc/dropbear")))
|
||
|
||
(define (dropbear-shepherd-service config)
|
||
"Return a <shepherd-service> for dropbear with CONFIG."
|
||
(define dropbear
|
||
(dropbear-configuration-dropbear config))
|
||
|
||
(define pid-file
|
||
(dropbear-configuration-pid-file config))
|
||
|
||
(define dropbear-command
|
||
#~(list (string-append #$dropbear "/sbin/dropbear")
|
||
|
||
;; '-R' allows host keys to be automatically generated upon first
|
||
;; connection, at a time when /dev/urandom is more likely securely
|
||
;; seeded.
|
||
"-F" "-R"
|
||
|
||
"-p" #$(number->string (dropbear-configuration-port-number config))
|
||
"-P" #$pid-file
|
||
#$@(if (dropbear-configuration-syslog-output? config) '() '("-E"))
|
||
#$@(if (dropbear-configuration-root-login? config) '() '("-w"))
|
||
#$@(if (dropbear-configuration-password-authentication? config)
|
||
'()
|
||
'("-s" "-g"))
|
||
#$@(if (dropbear-configuration-allow-empty-passwords? config)
|
||
'("-B")
|
||
'())))
|
||
|
||
(define requires
|
||
(if (dropbear-configuration-syslog-output? config)
|
||
'(networking syslogd) '(networking)))
|
||
|
||
(list (shepherd-service
|
||
(documentation "Dropbear SSH server.")
|
||
(requirement requires)
|
||
(provision '(ssh-daemon))
|
||
(start #~(make-forkexec-constructor #$dropbear-command
|
||
#:pid-file #$pid-file))
|
||
(stop #~(make-kill-destructor)))))
|
||
|
||
(define dropbear-service-type
|
||
(service-type (name 'dropbear)
|
||
(extensions
|
||
(list (service-extension shepherd-root-service-type
|
||
dropbear-shepherd-service)
|
||
(service-extension activation-service-type
|
||
dropbear-activation)))))
|
||
|
||
(define* (dropbear-service #:optional (config (dropbear-configuration)))
|
||
"Run the @uref{https://matt.ucc.asn.au/dropbear/dropbear.html,Dropbear SSH
|
||
daemon} with the given @var{config}, a @code{<dropbear-configuration>}
|
||
object."
|
||
(service dropbear-service-type config))
|
||
|
||
;;; ssh.scm ends here
|