/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to TODO

  • Committer: Teddy Hogeborn
  • Date: 2019-07-27 10:11:45 UTC
  • Revision ID: teddy@recompile.se-20190727101145-jnpbpf8220gldbcd
Add dracut(8) support

Add support for the dracut(8) system for generating initramfs image
files; dracut is an alternative to the "initramfs-tools" package.

* .bzrignore (dracut-module/password-agent): Ignore new binary file.
* dracut-module: New directory for the dracut module.
* INSTALL (Prerequisites/Libraries/Mandos Client): Add dracut as an
                                                   alternative to
                                                   initramfs-tools,
                                                   and also add GLib.
* Makefile (DRACUTMODULE, GLIB_CFLAGS, GLIB_LIBS): New.
  (CPROGS): Add "dracut-module/password-agent".
  (DOCS): Add "dracut-module/password-agent.8mandos".
  (dracut-module/password-agent.8mandos): New.
  (dracut-module/password-agent.8mandos.xhtml): - '' -
  (dracut-module/password-agent): - '' -
  (check): Add command to run tests of password-agent(8mandos).
  (install-client-nokey): Also install the dracut module directory,
                          its files, and the password-agent(8mandos)
                          manual page.
  (install-client): To update the initramfs image file, run
                    update-initramfs or dracut depending on what is
                    installed.
  (uninstall-client): - '' - and also uninstall the the files in the
                      dracut module directory, that directory itself,
                      and the password-agent(8mandos) manual page.
* debian/control (Build-Depends): Add "libglib2.0-dev (>=2.40)".
  (Package: mandos-client/Depends): Add "dracut (>= 044+241-3)" as an
                                    alternative dependency to
                                    initramfs-tools.
  (Package: mandos-client/Conflicts): New; set to
                                      "dracut-config-generic".
  (debian/mandos-client.README.Debian): Document alternative commands
                                        to update the initramfs image
                                        for when dracut is used.
* debian/mandos-client.postinst (update_initramfs): Use alternative
                                                    commands to update
                                                    the initramfs
                                                    image for when
                                                    dracut is used.
* debian/tests/control (password-agent, password-agent-suid): Add two
                                                              new tests.
* dracut-module/ask-password-mandos.path: New.
* dracut-module/ask-password-mandos.service: - '' -
* dracut-module/cmdline-mandos.sh: - '' -
* dracut-module/module-setup.sh: - '' -
* dracut-module/password-agent.c: - '' -
* dracut-module/password-agent.xml: - '' -
* initramfs-unpack: Use the dracut "skipcpio" command, if available.
                    Also be more flexible and try hard to detect where
                    compressed data starts.
* plugins.d/mandos-client.xml (SECURITY): Be more precise that the
                                          mandos-client binary might
                                          not always be setuid, but
                                          that the program assumes
                                          that it has been started
                                          that way.
* plugins.d/password-prompt.c: Add new "--prompt" option.
  (conflict_detection): First try to detect the new PID file of
                        plymouth.
  (main): Define and use new "prompt" variable.
* plugins.d/password-prompt.xml (SYNOPSIS): Show new --prompt option.
  (DESCRIPTION): Describe new behavior of looking for plymouth PID
                 file.
  (OPTIONS): Document new "--prompt" option.
  (ENVIRONMENT): Clarify that the CRYPTTAB_SOURCE and CRYPTTAB_NAME
                 environment variables are not used if the --prompt
                 option is used.  Remove unnecessarily specific
                 details about where the CRYPTTAB_SOURCE and
                 CRYPTTAB_NAME comes from, since this can now be
                 either initramfs-tools or dracut.
  (SEE ALSO): Remove superfluous crypttab(5) reference, and add commas
              to separate the other references.
* plugins.d/plymouth.c: Add new "--prompt" and "--debug" options.
  (debug): New global flag.
  (fprintf_plus): New function, used for debug output.
  (exec_and_wait): Add extra "const" to "argv" argument.
  (main): Define and use new "prompt" variable.  Add debug output.
  (main/options, main/parse_opt): New; used to parse options.
* plugins.d/plymouth.xml (SYNOPSIS): Show new options.
  (OPTIONS): Document new options.
  (ENVIRONMENT): Clarify that the cryptsource and crypttarget
                 environment variables are not used if the --prompt
                 option is used.  Remove unnecessarily specific
                 details about where the cryptsource and crypttarget
                 comes from, since this can now be either
                 initramfs-tools or dracut.
  (EXAMPLE): Add an example using an option.
  (SEE ALSO): Remove superfluous crypttab(5) reference.
* plugins.d/splashy.xml (ENVIRONMENT): Clarify that the cryptsource
                                       and crypttarget environment
                                       variables are not used if the
                                       --prompt option is used.
                                       Remove unnecessarily specific
                                       details about where the
                                       cryptsource and crypttarget
                                       comes from, since this can now
                                       be either initramfs-tools or
                                       dracut.
  (SEE ALSO): Remove superfluous crypttab(5) reference.
* plugins.d/usplash.xml (ENVIRONMENT): Clarify that the cryptsource
                                       and crypttarget environment
                                       variables are not used if the
                                       --prompt option is used.
                                       Remove unnecessarily specific
                                       details about where the
                                       cryptsource and crypttarget
                                       comes from, since this can now
                                       be either initramfs-tools or
                                       dracut.
  (SEE ALSO): Remove superfluous crypttab(5) reference.

Show diffs side-by-side

added added

removed removed

Lines of Context:
TODO
1
1
-*- org -*-
2
2
 
3
 
* Use _attribute_((nonnull)) wherever possible.
 
3
* Testing
 
4
** python-nemu
4
5
 
5
 
* Release critical
6
 
** TODO Change make-run-server to not include --no-dbus
 
6
* mandos-applet
7
7
 
8
8
* mandos-client
9
 
** TODO [#B] use scandir(3) instead of readdir(3)
10
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
11
 
** TODO [#B] Retry a server which has a non-definite reply:
12
 
*** A closed connection during the TLS handshake
13
 
*** A TCP timeout
 
9
** TODO A --server option which only adds to the server list.
 
10
   (Unlike --connect, which implicitly disables zeroconf.)
14
11
** TODO [#B] Use capabilities instead of seteuid().
15
 
** TODO [#A] Retry --connect forever
 
12
   https://forums.grsecurity.net/viewtopic.php?f=7&t=2522
 
13
** TODO [#B] Use getaddrinfo(hints=AI_NUMERICHOST) instead of inet_pton()
 
14
** TODO [#C] Make start_mandos_communication() take "struct server".
 
15
** TODO [#C] --interfaces=regex,eth*,noregex (bridge-utils-interfaces(5))
 
16
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
 
17
** TODO [#B] Use reallocarray() with GNU LibC 2.29 or later.
16
18
 
17
19
* splashy
18
20
** TODO [#B] use scandir(3) instead of readdir(3)
19
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
21
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
20
22
 
21
 
* usplash
22
 
** TODO [#A] Make it work again
 
23
* usplash (Deprecated)
 
24
** TODO [#B] Make it work again
23
25
** TODO [#B] use scandir(3) instead of readdir(3)
24
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
25
 
** TODO Use [[info:libc:Argz%20Functions][argz_extract]]
 
26
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
26
27
 
27
28
* askpass-fifo
28
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
29
 
** TODO [#B] Drop privileges after opening FIFO.
 
29
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
30
30
 
31
31
* password-prompt
32
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
33
32
** TODO [#B] lock stdin (with flock()?)
 
33
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
34
34
 
35
35
* plymouth
36
 
** TODO Use [[info:libc:Argz%20Functions][argz_extract]]
 
36
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
 
37
** TODO [#B] Use reallocarray() with GNU LibC 2.29 or later.
37
38
 
38
39
* TODO [#B] passdev
39
40
 
40
41
* plugin-runner
41
 
** TODO [#B] use scandir(3) instead of readdir(3)
 
42
** TODO handle printing for errors for plugins
 
43
*** Hook up stderr of plugins, buffer them, and prepend "Mandos Plugin [plugin name]"
42
44
** TODO [#C] use same file name rules as run-parts(8)
43
45
** kernel command line option for debug info
44
 
** TODO [#B] Use openat()
 
46
** TODO [#A] Restart plugins which exit with EX_TEMPFAIL
45
47
 
46
48
* mandos (server)
 
49
** TODO [#B] --notify-command
 
50
   This would allow the mandos.service to use
 
51
   --notify-command="systemd-notify --pid --ready"
 
52
** TODO [#B] python-systemd
 
53
*** import systemd.daemon; systemd.daemon.notify()
47
54
** TODO [#B] Log level                                                    :BUGS:
48
 
** TODO Persistent state                                                  :BUGS:
49
 
   /var/lib/mandos/*
50
55
*** TODO /etc/mandos/clients.d/*.conf
51
56
    Watch this directory and add/remove/update clients?
52
57
** TODO [#C] config for TXT record
53
 
** TODO Log level option
54
 
   syslogger.setLevel(logging.WARNING)
55
 
   + SetLogLevel D-Bus call
56
 
** TODO Implement --foreground                                            :BUGS:
57
 
   [[info:standards:Option%20Table][Table of Long Options]]
58
 
** TODO Implement --socket
59
 
   [[info:standards:Option%20Table][Table of Long Options]]
60
 
** TODO Date+time on console log messages                                 :BUGS:
61
 
   Is this the default?
 
58
** TODO Log level dbus option
 
59
   SetLogLevel D-Bus call
62
60
** TODO [#C] DBusServiceObjectUsingSuper
63
61
** TODO [#B] Global enable/disable flag
64
 
** TODO [#B] By-client countdown on secrets given
65
 
** TODO [#B] Fix problem with fsck taking a really long time
66
 
   Whenever a client successfully gets a secret it could get a
67
 
   one-time timeout boost to allow for an fsck-incurred delay
68
 
** TODO [#A] Delay before client receives key
69
 
   This would give an operator opportunity to cancel the request if
70
 
   desired.
71
 
** TODO [#A] Client manual approval mode
72
 
   A client needs manual approval on the server before it gets the
73
 
   secret
74
 
** TODO [#B] Support RFC 3339 time duration syntax
75
 
** More D-Bus methods
76
 
*** NeedsApproval(50, True) -> timeout, default approve
77
 
    Default approval is configurable, but True by default
78
 
    + Approve(True) -> approve sending saved
79
 
    + Approve(False) -> Close client connection immediately
80
 
*** NeedsPassword(50) - Timeout, default disapprove
 
62
** TODO [#B] By-client countdown on number of secrets given
 
63
** D-Bus Client method NeedsPassword(50) - Timeout, default disapprove
81
64
    + SetPass(u"gazonk", True) -> Approval, persistent
82
65
    + Approve(False) -> Close client connection immediately
83
66
** TODO [#C] python-parsedatetime
84
 
** TODO [#C] systemd/launchd
85
 
   http://0pointer.de/blog/projects/systemd.html
86
67
** TODO Separate logging logic to own object
87
 
** TODO make clients to a dict!
88
 
** TODO [#A] Limit approved_delay to max gnutls/tls timeout value
89
 
 
90
 
* mandos.xml
91
 
** [[file:mandos.xml::XXX][Document D-Bus interface]]
92
 
   Remove mention of lack of such interface in BUGS section
93
 
** Add mandos contact info in manual pages
94
 
 
95
 
* TODO [#A] Provide and install /etc/dbus-1/system.d/mandos.conf
 
68
** TODO [#B] Limit approval_delay to max gnutls/tls timeout value
 
69
** TODO [#B] break the wait on approval_delay if connection dies
 
70
** TODO Generate Client.runtime_expansions from client options + extra
 
71
** TODO Allow %%(checker)s as a runtime expansion
 
72
** TODO D-Bus AddClient() method on server object
 
73
** TODO Use org.freedesktop.DBus.Method.NoReply annotation on async methods. :2:
 
74
** TODO Save state periodically to recover better from hard shutdowns
 
75
** TODO CheckerCompleted method, deprecate CheckedOK
 
76
** TODO Secret Service API?
 
77
   https://standards.freedesktop.org/secret-service/
 
78
** TODO Remove D-Bus interfaces with old domain name                      :2:
 
79
** TODO Remove old string_to_delta format                                 :2:
 
80
** TODO http://0pointer.de/blog/projects/stateless.html
 
81
*** File in /usr/lib/sysusers.d to create user+group "_mandos"
 
82
** TODO Error handling on error parsing config files
 
83
** TODO init.d script error handling
 
84
** TODO D-Bus server properties; address, port, interface, etc.           :2:
 
85
** Python 3                                                               :2:
 
86
*** TODO [#C] In Python 3.3, use shlex.quote() instead of re.escape()
96
87
 
97
88
* mandos-ctl
98
 
*** Handle "no D-Bus server" and/or "no Mandos server found" better
99
 
*** [#B] --dump option
100
 
** TODO Support RFC 3339 time duration syntax
 
89
** TODO Remove old string_to_delta format                                 :2:
101
90
 
102
91
* TODO mandos-dispatch
103
92
  Listens for specified D-Bus signals and spawns shell commands with
104
93
  arguments.
105
94
 
106
95
* mandos-monitor
107
 
** TODO help should be toggable
 
96
** TODO --servicename                                                  :BUGS:
 
97
** TODO help should be toggleable
108
98
** Urwid client data displayer
109
99
   Better view of client data in the listing
110
100
*** Properties popup
111
 
** Nicer crashes. Stack traces Messes up shell.
112
 
*** Print a nice "We are sorry" message, save stack trace to log.
 
101
** Print a nice "We are sorry" message, save stack trace to log.
113
102
 
114
103
* mandos-keygen
115
 
** TODO Loop until passwords match when run interactively
116
104
** TODO "--secfile" option
117
105
   Using the "secfile" option instead of "secret"
118
106
** TODO [#B] "--test" option
119
107
   For testing decryption before rebooting.
120
108
 
121
 
* Makefile
122
 
** TODO Add "--Xlinker --as-needed"
123
 
   http://udrepper.livejournal.com/19395.html
124
 
** TODO [#C] Implement DEB_BUILD_OPTIONS
125
 
   http://www.debian.org/doc/debian-policy/ch-source.html#s-debianrules-options
126
 
 
127
109
* Package
128
110
** /usr/share/initramfs-tools/hooks/mandos
129
111
*** TODO [#C] use same file name rules as run-parts(8)
130
112
*** TODO [#C] Do not install in initrd.img if configured not to.
131
113
    Use "/etc/initramfs-tools/hooksconf.d/mandos"?
132
 
** TODO [#C] /etc/bash_completion.d/mandos
 
114
** TODO [#C] $(pkg-config --variable=completionsdir bash-completion)
133
115
   From XML sources directly?
134
116
 
135
117
* Side Stuff
136
 
** TODO Locate which packet move the other bin/sh when busy box is deactivated
137
 
** TODO contact owner of packet, and ask them to have that shell static in position regardless of busybox
 
118
** TODO Locate which package moves the other bin/sh when busybox is deactivated
 
119
** TODO contact owner of package, and ask them to have that shell static in position regardless of busybox
 
120
 
 
121
* [[http://www.undeadly.org/cgi?action=article&sid=20110530221728][OpenBSD]]
138
122
 
139
123
 
140
124
#+STARTUP: showall