/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: 2024-09-08 00:24:32 UTC
  • Revision ID: teddy@recompile.se-20240908002432-0exnlv1fp73hps8j
Document how to add options to mandos-client when using dracut

* debian/mandos-client.README.Debian: Remove unnecessary word
  "simply".  Also add instructions on how to add the --connect=
  options to mandos-client when using dracut.
* dracut-module/ask-password-mandos.service ([Service]): Add comments
  that this file should *not* be modified, and explicit instructions
  on how to instead add extra options, like --debug, to mandos-client:
  using a systemd override unit file to set an environment variable.

Show diffs side-by-side

added added

removed removed

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