| 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 — 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 'getprinc krbtgt/ZONE.MIT.EDU'</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 'getprinc kadmin/admin'</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 'getprinc kadmin/changepw'</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">></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 "cpw -e ${enctypes} -randkey \</span> |
| 171 |
<span class="o">></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">"</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">"krbtgt/[email protected]"</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@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 'getprinc krbtgt/ZONE.MIT.EDU'</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@REALM</span></code> |
| 213 |
and <code class="docutils literal notranslate"><span class="pre">kadmin/changepw@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">></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 "cpw -e ${enctypes} -randkey \</span> |
| 223 |
<span class="o">></span> <span class="n">kadmin</span><span class="o">/</span><span class="n">admin</span><span class="s2">"</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">"kadmin/[email protected]"</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 "cpw -e ${enctypes} -randkey \</span> |
| 227 |
<span class="o">></span> <span class="n">kadmin</span><span class="o">/</span><span class="n">changepw</span><span class="s2">"</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">"kadmin/[email protected]"</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">></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">></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">"ktadd -e $</span><span class="si">{enctypes}</span><span class="s2"> </span><span class="se">\</span> |
| 251 |
<span class="s2">> -k /etc/zephyr/krb5.keytab zephyr/[email protected]"</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">&&</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 "cpw -randkey -keepold \</span> |
| 354 |
<span class="o">></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">"</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">"krbtgt/[email protected]"</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 'purgekeys krbtgt/ZONE.MIT.EDU'</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">"krbtgt/[email protected]"</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:~> 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:~> kadmin -r ZONE.MIT.EDU -q 'getprinc zonetest' |
| 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 |
> -t kaduk-zone.keytab -q 'ktadd -k kaduk-zone.keytab [email protected]' |
| 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@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 |
© <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> |