Debian Codegraph @

doc/html/admin/advanced/retiring-des.html

raw
1 <!DOCTYPE html>
2
3 <html lang="en" data-content_root="../../">
4 <head>
5 <meta charset="utf-8" />
6 <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
7
8 <title>Retiring DES &#8212; MIT Kerberos Documentation</title>
9 <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
10 <link rel="stylesheet" type="text/css" href="../../_static/agogo.css?v=879f3c71" />
11 <link rel="stylesheet" type="text/css" href="../../_static/kerb.css?v=6a0b3979" />
12 <script src="../../_static/documentation_options.js?v=6dbce55c"></script>
13 <script src="../../_static/doctools.js?v=888ff710"></script>
14 <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
15 <link rel="author" title="About these documents" href="../../about.html" />
16 <link rel="index" title="Index" href="../../genindex.html" />
17 <link rel="search" title="Search" href="../../search.html" />
18 <link rel="copyright" title="Copyright" href="../../copyright.html" />
19 <link rel="next" title="Various links" href="../various_envs.html" />
20 <link rel="prev" title="Advanced topics" href="index.html" />
21 </head><body>
22 <div class="header-wrapper">
23 <div class="header">
24
25
26 <h1><a href="../../index.html">MIT Kerberos Documentation</a></h1>
27
28 <div class="rel">
29
30 <a href="../../index.html" title="Full Table of Contents"
31 accesskey="C">Contents</a> |
32 <a href="index.html" title="Advanced topics"
33 accesskey="P">previous</a> |
34 <a href="../various_envs.html" title="Various links"
35 accesskey="N">next</a> |
36 <a href="../../genindex.html" title="General Index"
37 accesskey="I">index</a> |
38 <a href="../../search.html" title="Enter search criteria"
39 accesskey="S">Search</a> |
40 <a href="mailto:[email protected]?subject=Documentation__Retiring DES">feedback</a>
41 </div>
42 </div>
43 </div>
44
45 <div class="content-wrapper">
46 <div class="content">
47 <div class="document">
48
49 <div class="documentwrapper">
50 <div class="bodywrapper">
51 <div class="body" role="main">
52
53 <section id="retiring-des">
54 <span id="id1"></span><h1>Retiring DES<a class="headerlink" href="#retiring-des" title="Link to this heading">¶</a></h1>
55 <p>Version 5 of the Kerberos protocol was originally implemented using
56 the Data Encryption Standard (DES) as a block cipher for encryption.
57 While it was considered secure at the time, advancements in computational
58 ability have rendered DES vulnerable to brute force attacks on its 56-bit
59 keyspace. As such, it is now considered insecure and should not be
60 used (<span class="target" id="index-0"></span><a class="rfc reference external" href="https://datatracker.ietf.org/doc/html/rfc6649.html"><strong>RFC 6649</strong></a>).</p>
61 <section id="history">
62 <h2>History<a class="headerlink" href="#history" title="Link to this heading">¶</a></h2>
63 <p>DES was used in the original Kerberos implementation, and was the
64 only cryptosystem in krb5 1.0. Partial support for triple-DES (3DES) was
65 added in version 1.1, with full support following in version 1.2.
66 The Advanced Encryption Standard (AES), which supersedes DES, gained
67 partial support in version 1.3.0 of krb5 and full support in version 1.3.2.
68 However, deployments of krb5 using Kerberos databases created with older
69 versions of krb5 will not necessarily start using strong crypto for
70 ordinary operation without administrator intervention.</p>
71 <p>MIT krb5 began flagging deprecated encryption types with release 1.17,
72 and removed DES (single-DES) support in release 1.18. As a
73 consequence, a release prior to 1.18 is required to perform these
74 migrations.</p>
75 </section>
76 <section id="types-of-keys">
77 <h2>Types of keys<a class="headerlink" href="#types-of-keys" title="Link to this heading">¶</a></h2>
78 <ul class="simple">
79 <li><p>The database master key: This key is not exposed to user requests,
80 but is used to encrypt other key material stored in the kerberos
81 database. The database master key is currently stored as <code class="docutils literal notranslate"><span class="pre">K/M</span></code>
82 by default.</p></li>
83 <li><p>Password-derived keys: User principals frequently have keys
84 derived from a password. When a new password is set, the KDC
85 uses various string2key functions to generate keys in the database
86 for that principal.</p></li>
87 <li><p>Keytab keys: Application server principals generally use random
88 keys which are not derived from a password. When the database
89 entry is created, the KDC generates random keys of various enctypes
90 to enter in the database, which are conveyed to the application server
91 and stored in a keytab.</p></li>
92 <li><p>Session keys: These are short-term keys generated by the KDC while
93 processing client requests, with an enctype selected by the KDC.</p></li>
94 </ul>
95 <p>For details on the various enctypes and how enctypes are selected by the KDC
96 for session keys and client/server long-term keys, see <a class="reference internal" href="../enctypes.html#enctypes"><span class="std std-ref">Encryption types</span></a>.
97 When using the <a class="reference internal" href="../admin_commands/kadmin_local.html#kadmin-1"><span class="std std-ref">kadmin</span></a> interface to generate new long-term keys,
98 the <strong>-e</strong> argument can be used to force a particular set of enctypes,
99 overriding the KDC default values.</p>
100 <div class="admonition note">
101 <p class="admonition-title">Note</p>
102 <p>When the KDC is selecting a session key, it has no knowledge about the
103 kerberos installation on the server which will receive the service ticket,
104 only what keys are in the database for the service principal.
105 In order to allow uninterrupted operation to
106 clients while migrating away from DES, care must be taken to ensure that
107 kerberos installations on application server machines are configured to
108 support newer encryption types before keys of those new encryption types
109 are created in the Kerberos database for those server principals.</p>
110 </div>
111 </section>
112 <section id="upgrade-procedure">
113 <h2>Upgrade procedure<a class="headerlink" href="#upgrade-procedure" title="Link to this heading">¶</a></h2>
114 <p>This procedure assumes that the KDC software has already been upgraded
115 to a modern version of krb5 that supports non-DES keys, so that the
116 only remaining task is to update the actual keys used to service requests.
117 The realm used for demonstrating this procedure, ZONE.MIT.EDU,
118 is an example of the worst-case scenario, where all keys in the realm
119 are DES. The realm was initially created with a very old version of krb5,
120 and <strong>supported_enctypes</strong> in <a class="reference internal" href="../conf_files/kdc_conf.html#kdc-conf-5"><span class="std std-ref">kdc.conf</span></a> was set to a value
121 appropriate when the KDC was installed, but was not updated as the KDC
122 was upgraded:</p>
123 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">realms</span><span class="p">]</span>
124 <span class="n">ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="o">=</span> <span class="p">{</span>
125 <span class="p">[</span><span class="o">...</span><span class="p">]</span>
126 <span class="n">master_key_type</span> <span class="o">=</span> <span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span>
127 <span class="n">supported_enctypes</span> <span class="o">=</span> <span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span><span class="p">:</span><span class="n">normal</span> <span class="n">des</span><span class="p">:</span><span class="n">normal</span> <span class="n">des</span><span class="p">:</span><span class="n">v4</span> <span class="n">des</span><span class="p">:</span><span class="n">norealm</span> <span class="n">des</span><span class="p">:</span><span class="n">onlyrealm</span> <span class="n">des</span><span class="p">:</span><span class="n">afs3</span>
128 <span class="p">}</span>
129 </pre></div>
130 </div>
131 <p>This resulted in the keys for all principals in the realm being forced
132 to DES-only, unless specifically requested using <a class="reference internal" href="../admin_commands/kadmin_local.html#kadmin-1"><span class="std std-ref">kadmin</span></a>.</p>
133 <p>Before starting the upgrade, all KDCs were running krb5 1.11,
134 and the database entries for some “high-value” principals were:</p>
135 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin.local -r ZONE.MIT.EDU -q &#39;getprinc krbtgt/ZONE.MIT.EDU&#39;</span>
136 <span class="p">[</span><span class="o">...</span><span class="p">]</span>
137 <span class="n">Number</span> <span class="n">of</span> <span class="n">keys</span><span class="p">:</span> <span class="mi">1</span>
138 <span class="n">Key</span><span class="p">:</span> <span class="n">vno</span> <span class="mi">1</span><span class="p">,</span> <span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span><span class="p">:</span><span class="n">v4</span>
139 <span class="p">[</span><span class="o">...</span><span class="p">]</span>
140 <span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin.local -r ZONE.MIT.EDU -q &#39;getprinc kadmin/admin&#39;</span>
141 <span class="p">[</span><span class="o">...</span><span class="p">]</span>
142 <span class="n">Number</span> <span class="n">of</span> <span class="n">keys</span><span class="p">:</span> <span class="mi">1</span>
143 <span class="n">Key</span><span class="p">:</span> <span class="n">vno</span> <span class="mi">15</span><span class="p">,</span> <span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span>
144 <span class="p">[</span><span class="o">...</span><span class="p">]</span>
145 <span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin.local -r ZONE.MIT.EDU -q &#39;getprinc kadmin/changepw&#39;</span>
146 <span class="p">[</span><span class="o">...</span><span class="p">]</span>
147 <span class="n">Number</span> <span class="n">of</span> <span class="n">keys</span><span class="p">:</span> <span class="mi">1</span>
148 <span class="n">Key</span><span class="p">:</span> <span class="n">vno</span> <span class="mi">14</span><span class="p">,</span> <span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span>
149 <span class="p">[</span><span class="o">...</span><span class="p">]</span>
150 </pre></div>
151 </div>
152 <p>The <code class="docutils literal notranslate"><span class="pre">krbtgt/REALM</span></code> key appears to have never been changed since creation
153 (its kvno is 1), and all three database entries have only a des-cbc-crc key.</p>
154 <section id="the-krbtgt-key-and-kdc-keys">
155 <h3>The krbtgt key and KDC keys<a class="headerlink" href="#the-krbtgt-key-and-kdc-keys" title="Link to this heading">¶</a></h3>
156 <p>Perhaps the biggest single-step improvement in the security of the cell
157 is gained by strengthening the key of the ticket-granting service principal,
158 <code class="docutils literal notranslate"><span class="pre">krbtgt/REALM</span></code>—if this principal’s key is compromised, so is the
159 entire realm. Since the server that will handle service tickets
160 for this principal is the KDC itself, it is easy to guarantee that it
161 will be configured to support any encryption types which might be
162 selected. However, the default KDC behavior when creating new keys is to
163 remove the old keys, which would invalidate all existing tickets issued
164 against that principal, rendering the TGTs cached by clients useless.
165 Instead, a new key can be created with the old key retained, so that
166 existing tickets will still function until their scheduled expiry
167 (see <a class="reference internal" href="../database.html#changing-krbtgt-key"><span class="std std-ref">Changing the krbtgt key</span></a>).</p>
168 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># enctypes=aes256-cts-hmac-sha1-96:normal,\</span>
169 <span class="o">&gt;</span> <span class="n">aes128</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span><span class="p">:</span><span class="n">normal</span><span class="p">,</span><span class="n">des3</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="p">:</span><span class="n">normal</span><span class="p">,</span><span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span><span class="p">:</span><span class="n">normal</span>
170 <span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin.local -r ZONE.MIT.EDU -q &quot;cpw -e ${enctypes} -randkey \</span>
171 <span class="o">&gt;</span> <span class="o">-</span><span class="n">keepold</span> <span class="n">krbtgt</span><span class="o">/</span><span class="n">ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span><span class="s2">&quot;</span>
172 <span class="n">Authenticating</span> <span class="k">as</span> <span class="n">principal</span> <span class="n">root</span><span class="o">/</span><span class="n">admin</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">password</span><span class="o">.</span>
173 <span class="n">Key</span> <span class="k">for</span> <span class="s2">&quot;krbtgt/[email protected]&quot;</span> <span class="n">randomized</span><span class="o">.</span>
174 </pre></div>
175 </div>
176 <div class="admonition note">
177 <p class="admonition-title">Note</p>
178 <p>The new <code class="docutils literal notranslate"><span class="pre">krbtgt&#64;REALM</span></code> key should be propagated to replica KDCs
179 immediately so that TGTs issued by the primary KDC can be used to
180 issue service tickets on replica KDCs. Replica KDCs will refuse
181 requests using the new TGT kvno until the new krbtgt entry has
182 been propagated to them.</p>
183 </div>
184 <p>It is necessary to explicitly specify the enctypes for the new database
185 entry, since <strong>supported_enctypes</strong> has not been changed. Leaving
186 <strong>supported_enctypes</strong> unchanged makes a potential rollback operation
187 easier, since all new keys of new enctypes are the result of explicit
188 administrator action and can be easily enumerated.
189 Upgrading the krbtgt key should have minimal user-visible disruption other
190 than that described in the note above, since only clients which list the
191 new enctypes as supported will use them, per the procedure
192 in <a class="reference internal" href="../enctypes.html#session-key-selection"><span class="std std-ref">Session key selection</span></a>.
193 Once the krbtgt key is updated, the session and ticket keys for user
194 TGTs will be strong keys, but subsequent requests
195 for service tickets will still get DES keys until the service principals
196 have new keys generated. Application service
197 remains uninterrupted due to the key-selection procedure on the KDC.</p>
198 <p>After the change, the database entry is now:</p>
199 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin.local -r ZONE.MIT.EDU -q &#39;getprinc krbtgt/ZONE.MIT.EDU&#39;</span>
200 <span class="p">[</span><span class="o">...</span><span class="p">]</span>
201 <span class="n">Number</span> <span class="n">of</span> <span class="n">keys</span><span class="p">:</span> <span class="mi">5</span>
202 <span class="n">Key</span><span class="p">:</span> <span class="n">vno</span> <span class="mi">2</span><span class="p">,</span> <span class="n">aes256</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span>
203 <span class="n">Key</span><span class="p">:</span> <span class="n">vno</span> <span class="mi">2</span><span class="p">,</span> <span class="n">aes128</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span>
204 <span class="n">Key</span><span class="p">:</span> <span class="n">vno</span> <span class="mi">2</span><span class="p">,</span> <span class="n">des3</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">sha1</span>
205 <span class="n">Key</span><span class="p">:</span> <span class="n">vno</span> <span class="mi">2</span><span class="p">,</span> <span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span>
206 <span class="n">Key</span><span class="p">:</span> <span class="n">vno</span> <span class="mi">1</span><span class="p">,</span> <span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span><span class="p">:</span><span class="n">v4</span>
207 <span class="p">[</span><span class="o">...</span><span class="p">]</span>
208 </pre></div>
209 </div>
210 <p>Since the expected disruptions from rekeying the krbtgt principal are
211 minor, after a short testing period, it is
212 appropriate to rekey the other high-value principals, <code class="docutils literal notranslate"><span class="pre">kadmin/admin&#64;REALM</span></code>
213 and <code class="docutils literal notranslate"><span class="pre">kadmin/changepw&#64;REALM</span></code>. These are the service principals used for
214 changing user passwords and updating application keytabs. The kadmin
215 and password-changing services are regular kerberized services, so the
216 session-key-selection algorithm described in <a class="reference internal" href="../enctypes.html#session-key-selection"><span class="std std-ref">Session key selection</span></a>
217 applies. It is particularly important to have strong session keys for
218 these services, since user passwords and new long-term keys are conveyed
219 over the encrypted channel.</p>
220 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># enctypes=aes256-cts-hmac-sha1-96:normal,\</span>
221 <span class="o">&gt;</span> <span class="n">aes128</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span><span class="p">:</span><span class="n">normal</span><span class="p">,</span><span class="n">des3</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="p">:</span><span class="n">normal</span>
222 <span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin.local -r ZONE.MIT.EDU -q &quot;cpw -e ${enctypes} -randkey \</span>
223 <span class="o">&gt;</span> <span class="n">kadmin</span><span class="o">/</span><span class="n">admin</span><span class="s2">&quot;</span>
224 <span class="n">Authenticating</span> <span class="k">as</span> <span class="n">principal</span> <span class="n">root</span><span class="o">/</span><span class="n">admin</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">password</span><span class="o">.</span>
225 <span class="n">Key</span> <span class="k">for</span> <span class="s2">&quot;kadmin/[email protected]&quot;</span> <span class="n">randomized</span><span class="o">.</span>
226 <span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin.local -r ZONE.MIT.EDU -q &quot;cpw -e ${enctypes} -randkey \</span>
227 <span class="o">&gt;</span> <span class="n">kadmin</span><span class="o">/</span><span class="n">changepw</span><span class="s2">&quot;</span>
228 <span class="n">Authenticating</span> <span class="k">as</span> <span class="n">principal</span> <span class="n">root</span><span class="o">/</span><span class="n">admin</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">password</span><span class="o">.</span>
229 <span class="n">Key</span> <span class="k">for</span> <span class="s2">&quot;kadmin/[email protected]&quot;</span> <span class="n">randomized</span><span class="o">.</span>
230 </pre></div>
231 </div>
232 <p>It is not necessary to retain a single-DES key for these services, since
233 password changes are not part of normal daily workflow, and disruption
234 from a client failure is likely to be minimal. Furthermore, if a kerberos
235 client experiences failure changing a user password or keytab key,
236 this indicates that that client will become inoperative once services
237 are rekeyed to non-DES enctypes. Such problems can be detected early
238 at this stage, giving more time for corrective action.</p>
239 </section>
240 <section id="adding-strong-keys-to-application-servers">
241 <h3>Adding strong keys to application servers<a class="headerlink" href="#adding-strong-keys-to-application-servers" title="Link to this heading">¶</a></h3>
242 <p>Before switching the default enctypes for new keys over to strong enctypes,
243 it may be desired to test upgrading a handful of services with the
244 new configuration before flipping the switch for the defaults. This
245 still requires using the <strong>-e</strong> argument in <a class="reference internal" href="../admin_commands/kadmin_local.html#kadmin-1"><span class="std std-ref">kadmin</span></a> to get non-default
246 enctypes:</p>
247 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># enctypes=aes256-cts-hmac-sha1-96:normal,\</span>
248 <span class="o">&gt;</span> <span class="n">aes128</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span><span class="p">:</span><span class="n">normal</span><span class="p">,</span><span class="n">des3</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">sha1</span><span class="p">:</span><span class="n">normal</span><span class="p">,</span><span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span><span class="p">:</span><span class="n">normal</span>
249 <span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin -r ZONE.MIT.EDU -p zephyr/[email protected] -k -t \</span>
250 <span class="o">&gt;</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">zephyr</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span> <span class="o">-</span><span class="n">q</span> <span class="s2">&quot;ktadd -e $</span><span class="si">{enctypes}</span><span class="s2"> </span><span class="se">\</span>
251 <span class="s2">&gt; -k /etc/zephyr/krb5.keytab zephyr/[email protected]&quot;</span>
252 <span class="n">Authenticating</span> <span class="k">as</span> <span class="n">principal</span> <span class="n">zephyr</span><span class="o">/</span><span class="n">zephyr</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">keytab</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">zephyr</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
253 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">zephyr</span><span class="o">/</span><span class="n">zephyr</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">4</span><span class="p">,</span> <span class="n">encryption</span> <span class="nb">type</span> <span class="n">aes256</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span> <span class="n">added</span> <span class="n">to</span> <span class="n">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">zephyr</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
254 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">zephyr</span><span class="o">/</span><span class="n">zephyr</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">4</span><span class="p">,</span> <span class="n">encryption</span> <span class="nb">type</span> <span class="n">aes128</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span> <span class="n">added</span> <span class="n">to</span> <span class="n">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">zephyr</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
255 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">zephyr</span><span class="o">/</span><span class="n">zephyr</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">4</span><span class="p">,</span> <span class="n">encryption</span> <span class="nb">type</span> <span class="n">des3</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">sha1</span> <span class="n">added</span> <span class="n">to</span> <span class="n">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">zephyr</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
256 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">zephyr</span><span class="o">/</span><span class="n">zephyr</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">4</span><span class="p">,</span> <span class="n">encryption</span> <span class="nb">type</span> <span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span> <span class="n">added</span> <span class="n">to</span> <span class="n">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">zephyr</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
257 </pre></div>
258 </div>
259 <p>Be sure to remove the old keys from the application keytab, per best
260 practice.</p>
261 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># k5srvutil -f /etc/zephyr/krb5.keytab delold</span>
262 <span class="n">Authenticating</span> <span class="k">as</span> <span class="n">principal</span> <span class="n">zephyr</span><span class="o">/</span><span class="n">zephyr</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">keytab</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">zephyr</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
263 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">zephyr</span><span class="o">/</span><span class="n">zephyr</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">3</span> <span class="n">removed</span> <span class="kn">from</span> <span class="nn">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">zephyr</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
264 </pre></div>
265 </div>
266 </section>
267 <section id="adding-strong-keys-by-default">
268 <h3>Adding strong keys by default<a class="headerlink" href="#adding-strong-keys-by-default" title="Link to this heading">¶</a></h3>
269 <p>Once the high-visibility services have been rekeyed, it is probably
270 appropriate to change <a class="reference internal" href="../conf_files/kdc_conf.html#kdc-conf-5"><span class="std std-ref">kdc.conf</span></a> to generate keys with the new
271 encryption types by default. This enables server administrators to generate
272 new enctypes with the <strong>change</strong> subcommand of <a class="reference internal" href="../admin_commands/k5srvutil.html#k5srvutil-1"><span class="std std-ref">k5srvutil</span></a>,
273 and causes user password
274 changes to add new encryption types for their entries. It will probably
275 be necessary to implement administrative controls to cause all user
276 principal keys to be updated in a reasonable period of time, whether
277 by forcing password changes or a password synchronization service that
278 has access to the current password and can add the new keys.</p>
279 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">realms</span><span class="p">]</span>
280 <span class="n">ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="o">=</span> <span class="p">{</span>
281 <span class="n">supported_enctypes</span> <span class="o">=</span> <span class="n">aes256</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span><span class="p">:</span><span class="n">normal</span> <span class="n">aes128</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span><span class="p">:</span><span class="n">normal</span> <span class="n">des3</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">sha1</span><span class="p">:</span><span class="n">normal</span> <span class="n">des3</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="p">:</span><span class="n">normal</span> <span class="n">des</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">crc</span><span class="p">:</span><span class="n">normal</span>
282 </pre></div>
283 </div>
284 <div class="admonition note">
285 <p class="admonition-title">Note</p>
286 <p>The krb5kdc process must be restarted for these changes to take effect.</p>
287 </div>
288 <p>At this point, all service administrators can update their services and the
289 servers behind them to take advantage of strong cryptography.
290 If necessary, the server’s krb5 installation should be configured and/or
291 upgraded to a version supporting non-DES keys. See <a class="reference internal" href="../enctypes.html#enctypes"><span class="std std-ref">Encryption types</span></a> for
292 krb5 version and configuration settings.
293 Only when the service is configured to accept non-DES keys should
294 the key version number be incremented and new keys generated
295 (<code class="docutils literal notranslate"><span class="pre">k5srvutil</span> <span class="pre">change</span> <span class="pre">&amp;&amp;</span> <span class="pre">k5srvutil</span> <span class="pre">delold</span></code>).</p>
296 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">root</span><span class="nd">@dr</span><span class="o">-</span><span class="n">willy</span><span class="p">:</span><span class="o">~</span><span class="c1"># k5srvutil change</span>
297 <span class="n">Authenticating</span> <span class="k">as</span> <span class="n">principal</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">keytab</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
298 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">3</span><span class="p">,</span> <span class="n">encryption</span> <span class="nb">type</span> <span class="n">AES</span><span class="o">-</span><span class="mi">256</span> <span class="n">CTS</span> <span class="n">mode</span> <span class="k">with</span> <span class="mi">96</span><span class="o">-</span><span class="n">bit</span> <span class="n">SHA</span><span class="o">-</span><span class="mi">1</span> <span class="n">HMAC</span> <span class="n">added</span> <span class="n">to</span> <span class="n">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
299 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">3</span><span class="p">,</span> <span class="n">encryption</span> <span class="nb">type</span> <span class="n">AES</span><span class="o">-</span><span class="mi">128</span> <span class="n">CTS</span> <span class="n">mode</span> <span class="k">with</span> <span class="mi">96</span><span class="o">-</span><span class="n">bit</span> <span class="n">SHA</span><span class="o">-</span><span class="mi">1</span> <span class="n">HMAC</span> <span class="n">added</span> <span class="n">to</span> <span class="n">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
300 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">3</span><span class="p">,</span> <span class="n">encryption</span> <span class="nb">type</span> <span class="n">Triple</span> <span class="n">DES</span> <span class="n">cbc</span> <span class="n">mode</span> <span class="k">with</span> <span class="n">HMAC</span><span class="o">/</span><span class="n">sha1</span> <span class="n">added</span> <span class="n">to</span> <span class="n">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
301 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">3</span><span class="p">,</span> <span class="n">encryption</span> <span class="nb">type</span> <span class="n">DES</span> <span class="n">cbc</span> <span class="n">mode</span> <span class="k">with</span> <span class="n">CRC</span><span class="o">-</span><span class="mi">32</span> <span class="n">added</span> <span class="n">to</span> <span class="n">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
302 <span class="n">root</span><span class="nd">@dr</span><span class="o">-</span><span class="n">willy</span><span class="p">:</span><span class="o">~</span><span class="c1"># klist -e -k -t /etc/krb5.keytab</span>
303 <span class="n">Keytab</span> <span class="n">name</span><span class="p">:</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span>
304 <span class="n">KVNO</span> <span class="n">Timestamp</span> <span class="n">Principal</span>
305 <span class="o">----</span> <span class="o">-----------------</span> <span class="o">--------------------------------------------------------</span>
306 <span class="mi">2</span> <span class="mi">10</span><span class="o">/</span><span class="mi">10</span><span class="o">/</span><span class="mi">12</span> <span class="mi">17</span><span class="p">:</span><span class="mi">03</span><span class="p">:</span><span class="mi">59</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="p">(</span><span class="n">DES</span> <span class="n">cbc</span> <span class="n">mode</span> <span class="k">with</span> <span class="n">CRC</span><span class="o">-</span><span class="mi">32</span><span class="p">)</span>
307 <span class="mi">3</span> <span class="mi">12</span><span class="o">/</span><span class="mi">12</span><span class="o">/</span><span class="mi">12</span> <span class="mi">15</span><span class="p">:</span><span class="mi">31</span><span class="p">:</span><span class="mi">19</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="p">(</span><span class="n">AES</span><span class="o">-</span><span class="mi">256</span> <span class="n">CTS</span> <span class="n">mode</span> <span class="k">with</span> <span class="mi">96</span><span class="o">-</span><span class="n">bit</span> <span class="n">SHA</span><span class="o">-</span><span class="mi">1</span> <span class="n">HMAC</span><span class="p">)</span>
308 <span class="mi">3</span> <span class="mi">12</span><span class="o">/</span><span class="mi">12</span><span class="o">/</span><span class="mi">12</span> <span class="mi">15</span><span class="p">:</span><span class="mi">31</span><span class="p">:</span><span class="mi">19</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="p">(</span><span class="n">AES</span><span class="o">-</span><span class="mi">128</span> <span class="n">CTS</span> <span class="n">mode</span> <span class="k">with</span> <span class="mi">96</span><span class="o">-</span><span class="n">bit</span> <span class="n">SHA</span><span class="o">-</span><span class="mi">1</span> <span class="n">HMAC</span><span class="p">)</span>
309 <span class="mi">3</span> <span class="mi">12</span><span class="o">/</span><span class="mi">12</span><span class="o">/</span><span class="mi">12</span> <span class="mi">15</span><span class="p">:</span><span class="mi">31</span><span class="p">:</span><span class="mi">19</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="p">(</span><span class="n">Triple</span> <span class="n">DES</span> <span class="n">cbc</span> <span class="n">mode</span> <span class="k">with</span> <span class="n">HMAC</span><span class="o">/</span><span class="n">sha1</span><span class="p">)</span>
310 <span class="mi">3</span> <span class="mi">12</span><span class="o">/</span><span class="mi">12</span><span class="o">/</span><span class="mi">12</span> <span class="mi">15</span><span class="p">:</span><span class="mi">31</span><span class="p">:</span><span class="mi">19</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="p">(</span><span class="n">DES</span> <span class="n">cbc</span> <span class="n">mode</span> <span class="k">with</span> <span class="n">CRC</span><span class="o">-</span><span class="mi">32</span><span class="p">)</span>
311 <span class="n">root</span><span class="nd">@dr</span><span class="o">-</span><span class="n">willy</span><span class="p">:</span><span class="o">~</span><span class="c1"># k5srvutil delold</span>
312 <span class="n">Authenticating</span> <span class="k">as</span> <span class="n">principal</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">keytab</span> <span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
313 <span class="n">Entry</span> <span class="k">for</span> <span class="n">principal</span> <span class="n">host</span><span class="o">/</span><span class="n">dr</span><span class="o">-</span><span class="n">willy</span><span class="o">.</span><span class="n">xvm</span><span class="o">.</span><span class="n">mit</span><span class="o">.</span><span class="n">edu</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">kvno</span> <span class="mi">2</span> <span class="n">removed</span> <span class="kn">from</span> <span class="nn">keytab</span> <span class="n">WRFILE</span><span class="p">:</span><span class="o">/</span><span class="n">etc</span><span class="o">/</span><span class="n">krb5</span><span class="o">.</span><span class="n">keytab</span><span class="o">.</span>
314 </pre></div>
315 </div>
316 <p>When a single service principal is shared by multiple backend servers in
317 a load-balanced environment, it may be necessary to schedule downtime
318 or adjust the population in the load-balanced pool in order to propagate
319 the updated keytab to all hosts in the pool with minimal service interruption.</p>
320 </section>
321 <section id="removing-des-keys-from-usage">
322 <h3>Removing DES keys from usage<a class="headerlink" href="#removing-des-keys-from-usage" title="Link to this heading">¶</a></h3>
323 <p>This situation remains something of a testing or transitory state,
324 as new DES keys are still being generated, and will be used if requested
325 by a client. To make more progress removing DES from the realm, the KDC
326 should be configured to not generate such keys by default.</p>
327 <div class="admonition note">
328 <p class="admonition-title">Note</p>
329 <p>An attacker posing as a client can implement a brute force attack against
330 a DES key for any principal, if that key is in the current (highest-kvno)
331 key list. This attack is only possible if <strong>allow_weak_crypto = true</strong>
332 is enabled on the KDC. Setting the <strong>+requires_preauth</strong> flag on a
333 principal forces this attack to be an online attack, much slower than
334 the offline attack otherwise available to the attacker. However, setting
335 this flag on a service principal is not always advisable; see the entry in
336 <a class="reference internal" href="../admin_commands/kadmin_local.html#add-principal"><span class="std std-ref">add_principal</span></a> for details.</p>
337 </div>
338 <p>The following KDC configuration will not generate DES keys by default:</p>
339 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">realms</span><span class="p">]</span>
340 <span class="n">ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="o">=</span> <span class="p">{</span>
341 <span class="n">supported_enctypes</span> <span class="o">=</span> <span class="n">aes256</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span><span class="p">:</span><span class="n">normal</span> <span class="n">aes128</span><span class="o">-</span><span class="n">cts</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="o">-</span><span class="mi">96</span><span class="p">:</span><span class="n">normal</span> <span class="n">des3</span><span class="o">-</span><span class="n">cbc</span><span class="o">-</span><span class="n">sha1</span><span class="p">:</span><span class="n">normal</span> <span class="n">des3</span><span class="o">-</span><span class="n">hmac</span><span class="o">-</span><span class="n">sha1</span><span class="p">:</span><span class="n">normal</span>
342 </pre></div>
343 </div>
344 <div class="admonition note">
345 <p class="admonition-title">Note</p>
346 <p>As before, the KDC process must be restarted for this change to take
347 effect. It is best practice to update kdc.conf on all KDCs, not just the
348 primary, to avoid unpleasant surprises should the primary fail and a
349 replica need to be promoted.</p>
350 </div>
351 <p>It is now appropriate to remove the legacy single-DES key from the
352 <code class="docutils literal notranslate"><span class="pre">krbtgt/REALM</span></code> entry:</p>
353 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin.local -r ZONE.MIT.EDU -q &quot;cpw -randkey -keepold \</span>
354 <span class="o">&gt;</span> <span class="n">krbtgt</span><span class="o">/</span><span class="n">ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span><span class="s2">&quot;</span>
355 <span class="n">Authenticating</span> <span class="k">as</span> <span class="n">principal</span> <span class="n">host</span><span class="o">/</span><span class="n">admin</span><span class="nd">@ATHENA</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">password</span><span class="o">.</span>
356 <span class="n">Key</span> <span class="k">for</span> <span class="s2">&quot;krbtgt/[email protected]&quot;</span> <span class="n">randomized</span><span class="o">.</span>
357 </pre></div>
358 </div>
359 <p>After the maximum ticket lifetime has passed, the old database entry
360 should be removed.</p>
361 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="p">[</span><span class="n">root</span><span class="nd">@casio</span> <span class="n">krb5kdc</span><span class="p">]</span><span class="c1"># kadmin.local -r ZONE.MIT.EDU -q &#39;purgekeys krbtgt/ZONE.MIT.EDU&#39;</span>
362 <span class="n">Authenticating</span> <span class="k">as</span> <span class="n">principal</span> <span class="n">root</span><span class="o">/</span><span class="n">admin</span><span class="nd">@ZONE</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span> <span class="k">with</span> <span class="n">password</span><span class="o">.</span>
363 <span class="n">Old</span> <span class="n">keys</span> <span class="k">for</span> <span class="n">principal</span> <span class="s2">&quot;krbtgt/[email protected]&quot;</span> <span class="n">purged</span><span class="o">.</span>
364 </pre></div>
365 </div>
366 <p>After the KDC is restarted with the new <strong>supported_enctypes</strong>,
367 all user password changes and application keytab updates will not
368 generate DES keys by default.</p>
369 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span>contents-vnder-pressvre:~&gt; kpasswd [email protected]
370 Password for [email protected]: [enter old password]
371 Enter new password: [enter new password]
372 Enter it again: [enter new password]
373 Password changed.
374 contents-vnder-pressvre:~&gt; kadmin -r ZONE.MIT.EDU -q &#39;getprinc zonetest&#39;
375 [...]
376 Number of keys: 3
377 Key: vno 9, aes256-cts-hmac-sha1-96
378 Key: vno 9, aes128-cts-hmac-sha1-96
379 Key: vno 9, des3-cbc-sha1
380 [...]
381
382 [kaduk@glossolalia ~]$ kadmin -p [email protected] -r ZONE.MIT.EDU -k \
383 &gt; -t kaduk-zone.keytab -q &#39;ktadd -k kaduk-zone.keytab [email protected]&#39;
384 Authenticating as principal [email protected] with keytab kaduk-zone.keytab.
385 Entry for principal [email protected] with kvno 3, encryption type aes256-cts-hmac-sha1-96 added to keytab WRFILE:kaduk-zone.keytab.
386 Entry for principal [email protected] with kvno 3, encryption type aes128-cts-hmac-sha1-96 added to keytab WRFILE:kaduk-zone.keytab.
387 Entry for principal [email protected] with kvno 3, encryption type des3-cbc-sha1 added to keytab WRFILE:kaduk-zone.keytab.
388 </pre></div>
389 </div>
390 <p>Once all principals have been re-keyed, DES support can be disabled on the
391 KDC (<strong>allow_weak_crypto = false</strong>), and client machines can remove
392 <strong>allow_weak_crypto = true</strong> from their <a class="reference internal" href="../conf_files/krb5_conf.html#krb5-conf-5"><span class="std std-ref">krb5.conf</span></a> configuration
393 files, completing the migration. <strong>allow_weak_crypto</strong> takes precedence over
394 all places where DES enctypes could be explicitly configured. DES keys will
395 not be used, even if they are present, when <strong>allow_weak_crypto = false</strong>.</p>
396 </section>
397 <section id="support-for-legacy-services">
398 <h3>Support for legacy services<a class="headerlink" href="#support-for-legacy-services" title="Link to this heading">¶</a></h3>
399 <p>If there remain legacy services which do not support non-DES enctypes
400 (such as older versions of AFS), <strong>allow_weak_crypto</strong> must remain
401 enabled on the KDC. Client machines need not have this setting,
402 though—applications which require DES can use API calls to allow
403 weak crypto on a per-request basis, overriding the system krb5.conf.
404 However, having <strong>allow_weak_crypto</strong> set on the KDC means that any
405 principals which have a DES key in the database could still use those
406 keys. To minimize the use of DES in the realm and restrict it to just
407 legacy services which require DES, it is necessary to remove all other
408 DES keys. The realm has been configured such that at password and
409 keytab change, no DES keys will be generated by default. The task
410 then reduces to requiring user password changes and having server
411 administrators update their service keytabs. Administrative outreach
412 will be necessary, and if the desire to eliminate DES is sufficiently
413 strong, the KDC administrators may choose to randkey any principals
414 which have not been rekeyed after some timeout period, forcing the
415 user to contact the helpdesk for access.</p>
416 </section>
417 </section>
418 <section id="the-database-master-key">
419 <h2>The Database Master Key<a class="headerlink" href="#the-database-master-key" title="Link to this heading">¶</a></h2>
420 <p>This procedure does not alter <code class="docutils literal notranslate"><span class="pre">K/M&#64;REALM</span></code>, the key used to encrypt key
421 material in the Kerberos database. (This is the key stored in the stash file
422 on the KDC if stash files are used.) However, the security risk of
423 a single-DES key for <code class="docutils literal notranslate"><span class="pre">K/M</span></code> is minimal, given that access to material
424 encrypted in <code class="docutils literal notranslate"><span class="pre">K/M</span></code> (the Kerberos database) is generally tightly controlled.
425 If an attacker can gain access to the encrypted database, they likely
426 have access to the stash file as well, rendering the weak cryptography
427 broken by non-cryptographic means. As such, upgrading <code class="docutils literal notranslate"><span class="pre">K/M</span></code> to a stronger
428 encryption type is unlikely to be a high-priority task.</p>
429 <p>Is is possible to upgrade the master key used for the database, if
430 desired. Using <a class="reference internal" href="../admin_commands/kdb5_util.html#kdb5-util-8"><span class="std std-ref">kdb5_util</span></a>’s <strong>add_mkey</strong>, <strong>use_mkey</strong>, and
431 <strong>update_princ_encryption</strong> commands, a new master key can be added
432 and activated for use on new key material, and the existing entries
433 converted to the new master key.</p>
434 </section>
435 </section>
436
437
438 <div class="clearer"></div>
439 </div>
440 </div>
441 </div>
442 </div>
443 <div class="sidebar">
444
445 <h2>On this page</h2>
446 <ul>
447 <li><a class="reference internal" href="#">Retiring DES</a><ul>
448 <li><a class="reference internal" href="#history">History</a></li>
449 <li><a class="reference internal" href="#types-of-keys">Types of keys</a></li>
450 <li><a class="reference internal" href="#upgrade-procedure">Upgrade procedure</a><ul>
451 <li><a class="reference internal" href="#the-krbtgt-key-and-kdc-keys">The krbtgt key and KDC keys</a></li>
452 <li><a class="reference internal" href="#adding-strong-keys-to-application-servers">Adding strong keys to application servers</a></li>
453 <li><a class="reference internal" href="#adding-strong-keys-by-default">Adding strong keys by default</a></li>
454 <li><a class="reference internal" href="#removing-des-keys-from-usage">Removing DES keys from usage</a></li>
455 <li><a class="reference internal" href="#support-for-legacy-services">Support for legacy services</a></li>
456 </ul>
457 </li>
458 <li><a class="reference internal" href="#the-database-master-key">The Database Master Key</a></li>
459 </ul>
460 </li>
461 </ul>
462
463 <br/>
464 <h2>Table of contents</h2>
465 <ul class="current">
466 <li class="toctree-l1"><a class="reference internal" href="../../user/index.html">For users</a></li>
467 <li class="toctree-l1 current"><a class="reference internal" href="../index.html">For administrators</a><ul class="current">
468 <li class="toctree-l2"><a class="reference internal" href="../install.html">Installation guide</a></li>
469 <li class="toctree-l2"><a class="reference internal" href="../conf_files/index.html">Configuration Files</a></li>
470 <li class="toctree-l2"><a class="reference internal" href="../realm_config.html">Realm configuration decisions</a></li>
471 <li class="toctree-l2"><a class="reference internal" href="../database.html">Database administration</a></li>
472 <li class="toctree-l2"><a class="reference internal" href="../dbtypes.html">Database types</a></li>
473 <li class="toctree-l2"><a class="reference internal" href="../lockout.html">Account lockout</a></li>
474 <li class="toctree-l2"><a class="reference internal" href="../conf_ldap.html">Configuring Kerberos with OpenLDAP back-end</a></li>
475 <li class="toctree-l2"><a class="reference internal" href="../appl_servers.html">Application servers</a></li>
476 <li class="toctree-l2"><a class="reference internal" href="../host_config.html">Host configuration</a></li>
477 <li class="toctree-l2"><a class="reference internal" href="../backup_host.html">Backups of secure hosts</a></li>
478 <li class="toctree-l2"><a class="reference internal" href="../pkinit.html">PKINIT configuration</a></li>
479 <li class="toctree-l2"><a class="reference internal" href="../otp.html">OTP Preauthentication</a></li>
480 <li class="toctree-l2"><a class="reference internal" href="../spake.html">SPAKE Preauthentication</a></li>
481 <li class="toctree-l2"><a class="reference internal" href="../dictionary.html">Addressing dictionary attack risks</a></li>
482 <li class="toctree-l2"><a class="reference internal" href="../princ_dns.html">Principal names and DNS</a></li>
483 <li class="toctree-l2"><a class="reference internal" href="../enctypes.html">Encryption types</a></li>
484 <li class="toctree-l2"><a class="reference internal" href="../https.html">HTTPS proxy configuration</a></li>
485 <li class="toctree-l2"><a class="reference internal" href="../auth_indicator.html">Authentication indicators</a></li>
486 <li class="toctree-l2"><a class="reference internal" href="../admin_commands/index.html">Administration programs</a></li>
487 <li class="toctree-l2"><a class="reference internal" href="../../mitK5defaults.html">MIT Kerberos defaults</a></li>
488 <li class="toctree-l2"><a class="reference internal" href="../env_variables.html">Environment variables</a></li>
489 <li class="toctree-l2"><a class="reference internal" href="../troubleshoot.html">Troubleshooting</a></li>
490 <li class="toctree-l2 current"><a class="reference internal" href="index.html">Advanced topics</a><ul class="current">
491 <li class="toctree-l3 current"><a class="current reference internal" href="#">Retiring DES</a></li>
492 </ul>
493 </li>
494 <li class="toctree-l2"><a class="reference internal" href="../various_envs.html">Various links</a></li>
495 </ul>
496 </li>
497 <li class="toctree-l1"><a class="reference internal" href="../../appdev/index.html">For application developers</a></li>
498 <li class="toctree-l1"><a class="reference internal" href="../../plugindev/index.html">For plugin module developers</a></li>
499 <li class="toctree-l1"><a class="reference internal" href="../../build/index.html">Building Kerberos V5</a></li>
500 <li class="toctree-l1"><a class="reference internal" href="../../basic/index.html">Kerberos V5 concepts</a></li>
501 <li class="toctree-l1"><a class="reference internal" href="../../formats/index.html">Protocols and file formats</a></li>
502 <li class="toctree-l1"><a class="reference internal" href="../../mitK5features.html">MIT Kerberos features</a></li>
503 <li class="toctree-l1"><a class="reference internal" href="../../build_this.html">How to build this documentation from the source</a></li>
504 <li class="toctree-l1"><a class="reference internal" href="../../about.html">Contributing to the MIT Kerberos Documentation</a></li>
505 <li class="toctree-l1"><a class="reference internal" href="../../resources.html">Resources</a></li>
506 </ul>
507
508 <br/>
509 <h4><a href="../../index.html">Full Table of Contents</a></h4>
510 <h4>Search</h4>
511 <form class="search" action="../../search.html" method="get">
512 <input type="text" name="q" size="18" />
513 <input type="submit" value="Go" />
514 <input type="hidden" name="check_keywords" value="yes" />
515 <input type="hidden" name="area" value="default" />
516 </form>
517
518 </div>
519 <div class="clearer"></div>
520 </div>
521 </div>
522
523 <div class="footer-wrapper">
524 <div class="footer" >
525 <div class="right" ><i>Release: 1.22.1</i><br />
526 &copy; <a href="../../copyright.html">Copyright</a> 1985-2025, MIT.
527 </div>
528 <div class="left">
529
530 <a href="../../index.html" title="Full Table of Contents"
531 >Contents</a> |
532 <a href="index.html" title="Advanced topics"
533 >previous</a> |
534 <a href="../various_envs.html" title="Various links"
535 >next</a> |
536 <a href="../../genindex.html" title="General Index"
537 >index</a> |
538 <a href="../../search.html" title="Enter search criteria"
539 >Search</a> |
540 <a href="mailto:[email protected]?subject=Documentation__Retiring DES">feedback</a>
541 </div>
542 </div>
543 </div>
544
545 </body>
546 </html>