/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: 2021-03-21 20:46:40 UTC
  • Revision ID: teddy@recompile.se-20210321204640-lpsyen8jr9lw1jma
Some cleanup of GnuTLS interface

Rename opaque internal GnuTLS structures named *_int to also start
with underscore (_), as is the custom in Python programs.

Decode byte strings from UTF-8 where needed.  (Fixing, among other
things, all "DEBUG: GnuTLS" lines having a "b'" prefix in Python 3.)

Simplify calling C functions by:
1. Using the "_as_parameter_" attribute to store the ctypes object.
2. Creating and using helper classes to automatically create pointers
   or cast typed pointers to pointers to void.
3. Providing the "from_param()" method on relevant classes.

Remove "restype" attribute on C functions where "errcheck" attribute
is already set.

* mandos (gnutls.session_int): Rename to start with "_".
  (gnutls.openpgp_crt_int): - '' -
  (gnutls.Error.__init__): Decode byte string from gnutls.strerror().
  (gnutls.PointerTo): New helper class.
  (gnutls.CastToVoidPointer): - '' -
  (gnutls.With_from_param): - '' -
  (gnutls.Credentials): Inherit from "With_from_param" and store the
  ctypes object in the "_as_parameter_" attribute instead of
  "_c_object".
  (gnutls._error_code): Use "gnutls.E_SUCCESS" instead of the unadorned
  numerical constant "0".
  (gnutls._retry_on_error): - '' -
  (gnutls.priority_set_direct.argtypes): Use "ClientSession" instead
  of "session_t", and change all callers to match.
  (gnutls.init.argtypes): Use "PointerTo(ClientSession)" instead of
  "ctypes.POINTER(session_t)", and change all callers to match.
  (gnutls.set_default_priority.argtypes): Use "ClientSession" instead
  of "session_t", and change all callers to match.
  (gnutls.record_send.argtypes): - '' -
  (gnutls.certificate_allocate_credentials.argtypes): Use
  "PointerTo(Credentials)" instead of
  "ctypes.POINTER(certificate_credentials_t)", and change all callers
  to match.
  (gnutls.certificate_free_credentials.argtypes): Use "Credentials"
  instead of "certificate_credentials_t", and change all callers to
  match.
  (gnutls.handshake_set_private_extensions.argtypes): Use
  "ClientSession" instead of "session_t", and change all callers to
  match.
  (gnutls.credentials_set.argtypes): Use
  "CastToVoidPointer(Credentials)" instead of "ctypes.c_void_p", and
  change all callers to match.
  (gnutls.certificate_type_get.argtypes): Use "ClientSession" instead
  of "session_t", and change all callers to match.
  (gnutls.certificate_get_peers.argtypes): - '' -
  (gnutls.deinit.argtypes): - '' -
  (gnutls.handshake.argtypes): - '' -
  (gnutls.handshake.restype): Change from "_error_code" to
  "ctypes.c_int".
  (gnutls.transport_set_ptr.argtypes): Use "ClientSession" instead of
  "session_t", and change all callers to match.
  (gnutls.bye.argtypes): - '' -
  (gnutls.bye.restype): Change from "_error_code" to "ctypes.c_int".
  (gnutls.certificate_type_get2.argtypes): Use "ClientSession" instead
  of "session_t", and change all callers to match.
  (ClientHandler.handle): Decode "key_id" bytes to string before
  logging it in the debug log.
  (main.debug_gnutls): Decode GnuTLS log message from bytes to string
  before logging it in the debug log.

Show diffs side-by-side

added added

removed removed

Lines of Context:
6
6
* mandos-applet
7
7
 
8
8
* mandos-client
9
 
** TODO A --server option which only adds to the server list.
10
 
   (Unlike --connect, which implicitly disables zeroconf.)
11
 
** TODO [#B] Use capabilities instead of seteuid().
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))
 
9
** TODO A ~--server~ option which only adds to the server list.
 
10
   (Unlike ~--connect~, which implicitly disables ZeroConf.)
 
11
** TODO [#B] Use [[man:capabilities][capabilities]] instead of [[info:libc#Setting%20User%20ID][seteuid()]].
 
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~ [[man:bridge-utils-interfaces][bridge-utils-interfaces(5)]]
 
16
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
16
17
 
17
18
* splashy
18
 
** TODO [#B] use scandir(3) instead of readdir(3)
 
19
** TODO [#B] use [[info:libc#Scanning%20Directory%20Content][scandir(3)]] instead of [[info:libc#Reading/Closing%20Directory][readdir(3)]]
 
20
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
19
21
 
20
22
* usplash (Deprecated)
21
23
** TODO [#B] Make it work again
22
 
** TODO [#B] use scandir(3) instead of readdir(3)
 
24
** TODO [#B] use [[info:libc#Scanning%20Directory%20Content][scandir(3)]] instead of [[info:libc#Reading/Closing%20Directory][readdir(3)]]
 
25
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
23
26
 
24
27
* askpass-fifo
 
28
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
25
29
 
26
30
* password-prompt
27
 
** TODO [#B] lock stdin (with flock()?)
 
31
** TODO [#B] lock stdin (with [[info:libc#File%20Locks][flock()]]?)
 
32
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
28
33
 
29
34
* plymouth
 
35
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
30
36
 
31
37
* TODO [#B] passdev
32
38
 
33
39
* plugin-runner
34
40
** TODO handle printing for errors for plugins
35
41
*** Hook up stderr of plugins, buffer them, and prepend "Mandos Plugin [plugin name]"
36
 
** TODO [#C] use same file name rules as run-parts(8)
 
42
** TODO [#C] use same file name rules as [[man:run-parts][run-parts(8)]]
37
43
** kernel command line option for debug info
 
44
** TODO [#A] Restart plugins which exit with ~EX_TEMPFAIL~
38
45
 
39
46
* mandos (server)
40
 
** TODO [#B] --notify-command
 
47
** TODO [#B] ~--notify-command~
41
48
   This would allow the mandos.service to use
42
 
   --notify-command="systemd-notify --pid --ready"
 
49
   ~--notify-command="systemd-notify --pid --ready"~
 
50
** TODO [#B] python-systemd
 
51
*** import systemd.daemon; systemd.daemon.notify()
43
52
** TODO [#B] Log level                                                    :BUGS:
44
53
*** TODO /etc/mandos/clients.d/*.conf
45
54
    Watch this directory and add/remove/update clients?
50
59
** TODO [#B] Global enable/disable flag
51
60
** TODO [#B] By-client countdown on number of secrets given
52
61
** D-Bus Client method NeedsPassword(50) - Timeout, default disapprove
53
 
    + SetPass(u"gazonk", True) -> Approval, persistent
 
62
    + SetPass("gazonk", True) -> Approval, persistent
54
63
    + Approve(False) -> Close client connection immediately
55
64
** TODO [#C] python-parsedatetime
56
65
** TODO Separate logging logic to own object
57
 
** TODO [#B] Limit approval_delay to max gnutls/tls timeout value
58
 
** TODO [#B] break the wait on approval_delay if connection dies
59
 
** TODO Generate Client.runtime_expansions from client options + extra
 
66
** TODO [#B] Limit ~approval_delay~ to max GnuTLS/TLS timeout value
 
67
** TODO [#B] break the wait on ~approval_delay~ if connection dies
 
68
** TODO Generate ~Client.runtime_expansions~ from client options + extra
60
69
** TODO Allow %%(checker)s as a runtime expansion
61
70
** TODO D-Bus AddClient() method on server object
62
71
** TODO Use org.freedesktop.DBus.Method.NoReply annotation on async methods. :2:
63
72
** TODO Save state periodically to recover better from hard shutdowns
64
73
** TODO CheckerCompleted method, deprecate CheckedOK
65
 
** TODO Secret Service API?
66
 
   http://standards.freedesktop.org/secret-service/
 
74
** TODO [[https://standards.freedesktop.org/secret-service/][Secret Service]] API?
67
75
** TODO Remove D-Bus interfaces with old domain name                      :2:
68
 
** TODO Remove old string_to_delta format                                 :2:
 
76
** TODO Remove old ~string_to_delta~ format                               :2:
69
77
** TODO http://0pointer.de/blog/projects/stateless.html
70
 
*** File in /usr/lib/sysusers.d to create user+group "_mandos"
 
78
*** File in /usr/lib/sysusers.d to create user+group "~_mandos~"
71
79
** TODO Error handling on error parsing config files
72
80
** TODO init.d script error handling
73
81
** TODO D-Bus server properties; address, port, interface, etc.           :2:
74
 
** Python 3                                                               :2:
75
 
*** TODO [#C] In Python 3.3, use shlex.quote() instead of re.escape()
76
82
 
77
83
* mandos-ctl
78
 
*** Handle "no D-Bus server" and/or "no Mandos server found" better
79
 
*** [#B] --dump option
80
84
** TODO Remove old string_to_delta format                                 :2:
81
85
 
82
86
* TODO mandos-dispatch
84
88
  arguments.
85
89
 
86
90
* mandos-monitor
87
 
** TODO --servicename                                                  :BUGS:
 
91
** TODO ~--servicename~                                                :BUGS:
88
92
** TODO help should be toggleable
89
93
** Urwid client data displayer
90
94
   Better view of client data in the listing
92
96
** Print a nice "We are sorry" message, save stack trace to log.
93
97
 
94
98
* mandos-keygen
95
 
** TODO "--secfile" option
 
99
** TODO "~--secfile~" option
96
100
   Using the "secfile" option instead of "secret"
97
 
** TODO [#B] "--test" option
 
101
** TODO [#B] "~--test~" option
98
102
   For testing decryption before rebooting.
99
103
 
100
104
* Package
101
105
** /usr/share/initramfs-tools/hooks/mandos
102
 
*** TODO [#C] use same file name rules as run-parts(8)
 
106
*** TODO [#C] use same file name rules as [[man:run-parts][run-parts(8)]]
103
107
*** TODO [#C] Do not install in initrd.img if configured not to.
104
108
    Use "/etc/initramfs-tools/hooksconf.d/mandos"?
105
 
** TODO [#C] $(pkg-config --variable=completionsdir bash-completion)
 
109
** TODO [#C] ~$(pkg-config --variable=completionsdir bash-completion)~
106
110
   From XML sources directly?
107
111
 
108
112
* Side Stuff
113
117
 
114
118
 
115
119
#+STARTUP: showall
 
120
#+FILETAGS: :mandos: