dbus/doc
Simon McVittie 3f8b2ce52e spec: Update recommendations for DBUS_COOKIE_SHA1 timeouts
This had two issues that could damage interoperability.

First, the spec wording suggested that any cookie that had not been
deleted was suitable for use in authentication. However, this introduces
a race condition, which is called out in comments in both the reference
implementation and GDBus: the newest cookie might be less old than the
arbitrary lifetime when authentication *begins*, but older than the
lifetime at the time authentication *ends*. As a result, we need a grace
period during which an old cookie will still be accepted, but a newer
cookie exists and will be used for new authentication operations.

Second, the spec wording implied that the arbitrary timeouts were
completely up to the implementor. However, GLib bug
https://gitlab.gnome.org/GNOME/glib/-/issues/2164 indicates that they
need to be reasonably compatible: in particular, GDBus servers
historically didn't allocate new cookies until 10 minutes had passed,
but libdbus clients would decline to use a cookie older than 5 minutes,
causing authentication to fail if the gdbus-server test-case (in which
GDBus and libdbus clients connect to a GDBus server) happened to take
longer than 5 minutes to run.

While I'm here, also be consistent about calling the secrets "cookies"
(consistent with the name of the mechanism) rather than "keys" (which
is what they are called in libdbus' dbus-keyring.c).

Signed-off-by: Simon McVittie <smcv@collabora.com>
2020-09-07 11:03:00 +00:00
..
.gitignore .gitignore: Normalize into LC_ALL=C sort order 2018-12-14 12:53:08 +00:00
busconfig.dtd Add apparmor element and attributes to the bus config dtd 2015-02-18 17:03:56 +00:00
CMakeLists.txt cmake: Add macro check_auto_option() as an addition to add_auto_option() 2020-06-10 18:13:47 +00:00
dbus-api-design.duck doc: Fix bracket escaping in Ducktype API design file 2018-02-08 14:12:53 +00:00
dbus-cleanup-sockets.1.xml.in Eliminate unwanted whitespace from the man pages' XML source 2013-02-18 14:16:18 +00:00
dbus-daemon.1.xml.in doc: Fix environment variable name in dbus-daemon(1) 2019-08-13 16:08:03 +02:00
dbus-faq.xml Unify docbook dtd version to 4.4. 2013-04-19 12:40:01 +01:00
dbus-launch.1.xml.in dbus-launch: add --exit-with-x11 option 2016-07-20 13:32:36 +01:00
dbus-monitor.1.xml.in dbus-monitor: add options to log binary data with or without pcap framing 2015-02-04 17:15:34 +00:00
dbus-run-session.1.xml.in dbus-run-session(1): document modern Automake syntax 2015-04-16 13:06:27 +01:00
dbus-send.1.xml.in dbus-send: add --sender option 2019-07-15 12:36:50 +00:00
dbus-specification.xml spec: Update recommendations for DBUS_COOKIE_SHA1 timeouts 2020-09-07 11:03:00 +00:00
dbus-test-plan.xml Rename bus-test to test-bus to match common test application naming scheme. 2014-01-17 16:29:37 +00:00
dbus-test-tool.1.xml.in dbus-test-tool echo: fix sleep documentation 2016-03-02 18:19:35 +00:00
dbus-tutorial.xml dbus-tutorial: replace the entire GLib section with "use GDBus" 2014-10-29 14:15:53 +00:00
dbus-update-activation-environment.1.xml.in Add dbus-update-activation-environment tool 2015-02-24 11:15:52 +00:00
dbus-uuidgen.1.xml.in Eliminate unwanted whitespace from the man pages' XML source 2013-02-18 14:16:18 +00:00
dcop-howto.txt initial import of "dbus" skeleton 2002-11-21 16:41:33 +00:00
diagram.png 2005-01-18 Havoc Pennington <hp@redhat.com> 2005-01-18 20:42:15 +00:00
diagram.svg 2005-01-18 Havoc Pennington <hp@redhat.com> 2005-01-18 20:42:15 +00:00
doxygen_to_devhelp.xsl doxygen_to_devhelp: Produce Devhelp index format v2 2018-04-23 17:44:09 +01:00
file-boilerplate.c Bug 21161 - Update the FSF address 2009-07-14 15:39:47 -04:00
index.html.in Generate documentation html index file from doc/index.html.in for autotools and cmake 2019-01-22 09:57:57 +01:00
introspect.dtd spec: Allow <annotation> in <arg> elements in introspection XML 2016-10-03 11:33:47 +01:00
introspect.xsl spec: Allow <annotation> in <arg> elements in introspection XML 2016-10-03 11:33:47 +01:00
Makefile.am Add support to generate the api documentation in Qt help format 2020-04-29 15:23:23 +00:00
system-activation.txt doc: Clarify /etc/dbus-1/system.d and /usr/share/dbus-1/system.d 2017-02-24 18:34:22 +00:00
TODO 2006-11-08 Havoc Pennington <hp@redhat.com> 2006-11-09 00:19:29 +00:00