/mandos/release

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

« back to all changes in this revision

Viewing changes to TODO

More consistent terminology: Clients are no longer "invalid" - they
are "disabled".  All code and documentation changed to reflect this.

D=Bus API change: The "properties" argument was removed from the
"ClientAdded" signal on interface "se.bsnet.fukt.Mandos".  All code in
both "mandos" and "mandos-monitor" changed to reflect this.

* mandos: Replaced "with closing(F)" with simply "with F" in all
          places where F is a file object.
  (Client.still_valid): Removed.  All callers changed to look at
                        "Client.enabled" instead.
  (dbus_service_property): Check for unsupported signatures with the
                           "byte_arrays" option.
  (DBusObjectWithProperties.Set): - '' -
  (ClientHandler.handle): Use the reverse pipe to receive the
                          "Client.enabled" attribute instead of the
                          now-removed "Client.still_valid()" method.
  (ForkingMixInWithPipe): Renamed to "ForkingMixInWithPipes" (all
                          users changed).  Now also create a reverse
                          pipe for sending data to the child process.
  (ForkingMixInWithPipes.add_pipe): Now takes two pipe fd's as
                                    arguments.  All callers changed.
  (IPv6_TCPServer.handle_ipc): Take an additional "reply_fd" argument
                               (all callers changed).  Close the reply
                               pipe when the child data pipe is
                               closed.  New "GETATTR" IPC method; will
                               pickle client attribute and send it
                               over the reply pipe FD.
  (MandosDBusService.ClientAdded): Removed "properties" argument.  All
                                   emitters changed.
* mandos-clients.conf.xml (DESCRIPTION, OPTIONS): Use
                                                  "enabled/disabled"
                                                  terminology.
* mandos-ctl: Option "--is-valid" renamed to "--is-enabled".
* mandos-monitor: Enable user locale.  Try to log exceptions.
  (MandosClientPropertyCache.__init__): Removed "properties" argument.
                                        All callers changed.
  (UserInterface.add_new_client): Remove "properties" argument.  All
                                  callers changed.  Supply "logger"
                                  argument to MandosClientWidget().
  (UserInterface.add_client): New "logger" argument.  All callers
                              changed.
* mandos.xml (BUGS, SECURITY/CLIENTS): Use "enabled/disabled"
                                       terminology.

Show diffs side-by-side

added added

removed removed

Lines of Context:
TODO
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
 
 
9
3
* mandos-client
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~
 
4
** TODO [#B] use scandir(3) instead of readdir(3)
 
5
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
6
** TODO use error() instead of perror()
 
7
** TODO [#B] Retry a server which has a non-definite reply:
 
8
*** A closed connection during the TLS handshake
 
9
*** A TCP timeout
 
10
** TODO [#B] Use capabilities instead of seteuid().
18
11
 
19
12
* splashy
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~
 
13
** TODO [#B] use scandir(3) instead of readdir(3)
 
14
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
15
** TODO use error() instead of perror()
22
16
 
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~
 
17
* usplash
 
18
** TODO [#B] use scandir(3) instead of readdir(3)
 
19
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
20
** TODO use error() instead of perror()
27
21
 
28
22
* askpass-fifo
29
 
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
 
23
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
24
** TODO use error() instead of perror()
 
25
** TODO [#B] Drop privileges after opening FIFO.
30
26
 
31
27
* password-prompt
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
 
28
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
29
** TODO use error() instead of perror()
 
30
** TODO lock stdin (with flock()?)
 
31
 
 
32
* TODO passdev
39
33
 
40
34
* plugin-runner
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)]]
44
 
** kernel command line option for debug info
45
 
** TODO [#A] Restart plugins which exit with ~EX_TEMPFAIL~
 
35
** TODO [#B] use scandir(3) instead of readdir(3)
 
36
** TODO [#C] use same file name rules as run-parts(8)
 
37
** TODO use error() instead of perror()
46
38
 
47
39
* mandos (server)
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:
 
40
** TODO [#B] Log level                          :BUGS:
 
41
** TODO /etc/mandos/clients.d/*.conf
 
42
   Watch this directory and add/remove/update clients?
 
43
** TODO config for TXT record
 
44
** TODO [#B] Run-time communication with server :BUGS:
 
45
   Probably using D-Bus
 
46
*** Client class
 
47
*** Main server
 
48
    + SetLogLevel
 
49
      syslogger.setLevel(logging.WARNING)
 
50
    + [[http://log.ometer.com/2007-05.html][Best D-Bus practices]]
 
51
** TODO Implement --foreground                  :BUGS:
 
52
   [[info:standards:Option%20Table][Table of Long Options]]
 
53
** TODO Implement --socket
 
54
   [[info:standards:Option%20Table][Table of Long Options]]
 
55
** TODO Date+time on console log messages       :BUGS:
 
56
   Is this the default?
 
57
** TODO DBusServiceObjectUsingSuper
 
58
** TODO Global enable/disable flag
 
59
** TODO By-client countdown on secrets given
 
60
** TODO Fix problem with fsck taking a really long time
 
61
   Whenever a client successfully gets a secret it could get a
 
62
   one-time timeout boost to allow for an fsck-incurred delay
 
63
** TODO Delay before client receives key
 
64
   This would give an operator opportunity to cancel the request if
 
65
   desired.
 
66
** TODO Client manual approval mode
 
67
   A client needs manual approval on the server before it gets the
 
68
   secret
 
69
** TODO Persistent state
 
70
   /var/lib/mandos/*
 
71
** TODO Support RFC 3339 time duration syntax
 
72
 
 
73
* mandos.xml
 
74
** [[file:mandos.xml::XXX][Document D-Bus interface]]
 
75
 
 
76
* Provide and install /etc/dbus-1/system.d/mandos.conf
83
77
 
84
78
* mandos-ctl
85
 
** TODO Remove old string_to_delta format                                 :2:
 
79
*** Handle "no D-Bus server" and/or "no Mandos server found" better
 
80
*** [#B] --dump option
 
81
** TODO Support RFC 3339 time duration syntax
86
82
 
87
83
* TODO mandos-dispatch
88
84
  Listens for specified D-Bus signals and spawns shell commands with
89
85
  arguments.
90
86
 
91
87
* mandos-monitor
92
 
** TODO ~--servicename~                                                :BUGS:
93
 
** TODO help should be toggleable
94
88
** Urwid client data displayer
95
 
   Better view of client data in the listing
96
89
*** Properties popup
97
 
** Print a nice "We are sorry" message, save stack trace to log.
98
90
 
99
91
* mandos-keygen
100
 
** TODO "~--secfile~" option
 
92
** TODO Loop until passwords match when run interactively
 
93
** TODO "--secfile" option
101
94
   Using the "secfile" option instead of "secret"
102
 
** TODO [#B] "~--test~" option
 
95
** TODO [#B] "--test" option
103
96
   For testing decryption before rebooting.
104
97
 
 
98
* Makefile
 
99
** Implement DEB_BUILD_OPTIONS
 
100
   http://www.debian.org/doc/debian-policy/ch-source.html#s-debianrules-options
 
101
 
105
102
* Package
106
103
** /usr/share/initramfs-tools/hooks/mandos
107
 
*** TODO [#C] use same file name rules as [[man:run-parts][run-parts(8)]]
 
104
*** TODO [#C] use same file name rules as run-parts(8)
108
105
*** TODO [#C] Do not install in initrd.img if configured not to.
109
106
    Use "/etc/initramfs-tools/hooksconf.d/mandos"?
110
 
** TODO [#C] ~$(pkg-config --variable=completionsdir bash-completion)~
 
107
** TODO [#C] /etc/bash_completion.d/mandos
111
108
   From XML sources directly?
112
109
 
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
 
 
119
110
 
120
111
#+STARTUP: showall
121
 
#+FILETAGS: :mandos: