aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGreg Hudson <ghudson@mit.edu>2016-12-04 18:34:41 -0500
committerTom Yu <tlyu@mit.edu>2017-01-09 14:30:09 -0500
commitf2bff4a6557206f7adc64185f324a1b979a900c3 (patch)
tree261d86b3b1b01f29bbedfaceddec54e1ec79123f
parent43bb5c8c39cbcb418377d4345360765a7f1db45b (diff)
downloadkrb5-f2bff4a6557206f7adc64185f324a1b979a900c3.zip
krb5-f2bff4a6557206f7adc64185f324a1b979a900c3.tar.gz
krb5-f2bff4a6557206f7adc64185f324a1b979a900c3.tar.bz2
Add caveats to krbtgt change documentation
In database.rst, describe a couple of krbtgt rollover issues and how to avoid them. (cherry picked from commit 56d05e87858b672591c1e6b7869cb08e8b1e0d59) ticket: 8524 version_fixed: 1.15.1
-rw-r--r--doc/admin/database.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/admin/database.rst b/doc/admin/database.rst
index 078abc7..b693042 100644
--- a/doc/admin/database.rst
+++ b/doc/admin/database.rst
@@ -765,6 +765,24 @@ database as well as the new key. For example::
with older kvnos, ideally first making sure that all
tickets issued with the old keys have expired.
+Only the first krbtgt key of the newest key version is used to encrypt
+ticket-granting tickets. However, the set of encryption types present
+in the krbtgt keys is used by default to determine the session key
+types supported by the krbtgt service (see
+:ref:`session_key_selection`). Because non-MIT Kerberos clients
+sometimes send a limited set of encryption types when making AS
+requests, it can be important to for the krbtgt service to support
+multiple encryption types. This can be accomplished by giving the
+krbtgt principal multiple keys, which is usually as simple as not
+specifying any **-e** option when changing the krbtgt key, or by
+setting the **session_enctypes** string attribute on the krbtgt
+principal (see :ref:`set_string`).
+
+Due to a bug in releases 1.8 through 1.13, renewed and forwarded
+tickets may not work if the original ticket was obtained prior to a
+krbtgt key change and the modified ticket is obtained afterwards.
+Upgrading the KDC to release 1.14 or later will correct this bug.
+
.. _incr_db_prop: