doc/html/basic/stash_file_def.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   2   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3
   4
   5 <html xmlns="http://www.w3.org/1999/xhtml">
   6   <head>
   7     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   8
   9     <title>stash file &mdash; MIT Kerberos Documentation</title>
  10
  11     <link rel="stylesheet" href="../_static/agogo.css" type="text/css" />
  12     <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
  13     <link rel="stylesheet" href="../_static/kerb.css" type="text/css" />
  14
  15     <script type="text/javascript">
  16       var DOCUMENTATION_OPTIONS = {
  17         URL_ROOT:    '../',
  18         VERSION:     '1.15.1',
  19         COLLAPSE_INDEX: false,
  20         FILE_SUFFIX: '.html',
  21         HAS_SOURCE:  true
  22       };
  23     </script>
  24     <script type="text/javascript" src="../_static/jquery.js"></script>
  25     <script type="text/javascript" src="../_static/underscore.js"></script>
  26     <script type="text/javascript" src="../_static/doctools.js"></script>
  27     <link rel="author" title="About these documents" href="../about.html" />
  28     <link rel="copyright" title="Copyright" href="../copyright.html" />
  29     <link rel="top" title="MIT Kerberos Documentation" href="../index.html" />
  30     <link rel="up" title="Kerberos V5 concepts" href="index.html" />
  31     <link rel="next" title="Supported date and time formats" href="date_format.html" />
  32     <link rel="prev" title="replay cache" href="rcache_def.html" />
  33   </head>
  34   <body>
  35     <div class="header-wrapper">
  36         <div class="header">
  37
  38
  39             <h1><a href="../index.html">MIT Kerberos Documentation</a></h1>
  40
  41             <div class="rel">
  42
  43         <a href="../index.html" title="Full Table of Contents"
  44             accesskey="C">Contents</a> |
  45         <a href="rcache_def.html" title="replay cache"
  46             accesskey="P">previous</a> |
  47         <a href="date_format.html" title="Supported date and time formats"
  48             accesskey="N">next</a> |
  49         <a href="../genindex.html" title="General Index"
  50             accesskey="I">index</a> |
  51         <a href="../search.html" title="Enter search criteria"
  52             accesskey="S">Search</a> |
  53     <a href="mailto:krb5-bugs@mit.edu?subject=Documentation__stash file">feedback</a>
  54             </div>
  55         </div>
  56     </div>
  57
  58     <div class="content-wrapper">
  59       <div class="content">
  60         <div class="document">
  61
  62       <div class="documentwrapper">
  63         <div class="bodywrapper">
  64           <div class="body">
  65
  66   <div class="section" id="stash-file">
  67 <span id="stash-definition"></span><h1>stash file<a class="headerlink" href="#stash-file" title="Permalink to this headline">¶</a></h1>
  68 <p>The stash file is a local copy of the master key that resides in
  69 encrypted form on the KDC&#8217;s local disk.  The stash file is used to
  70 authenticate the KDC to itself automatically before starting the
  71 <a class="reference internal" href="../admin/admin_commands/kadmind.html#kadmind-8"><em>kadmind</em></a> and <a class="reference internal" href="../admin/admin_commands/krb5kdc.html#krb5kdc-8"><em>krb5kdc</em></a> daemons (e.g., as part of the
  72 machine&#8217;s boot sequence).  The stash file, like the keytab file (see
  73 <a class="reference internal" href="../admin/install_appl_srv.html#keytab-file"><em>The keytab file</em></a>) is a potential point-of-entry for a break-in, and
  74 if compromised, would allow unrestricted access to the Kerberos
  75 database.  If you choose to install a stash file, it should be
  76 readable only by root, and should exist only on the KDC&#8217;s local disk.
  77 The file should not be part of any backup of the machine, unless
  78 access to the backup data is secured as tightly as access to the
  79 master password itself.</p>
  80 <div class="admonition note">
  81 <p class="first admonition-title">Note</p>
  82 <p class="last">If you choose not to install a stash file, the KDC will prompt you for the master key each time it starts up.
  83 This means that the KDC will not be able to start automatically, such as after a system reboot.</p>
  84 </div>
  85 </div>
  86
  87
  88           </div>
  89         </div>
  90       </div>
  91         </div>
  92         <div class="sidebar">
  93     <h2>On this page</h2>
  94     <ul>
  95 <li><a class="reference internal" href="#">stash file</a></li>
  96 </ul>
  97
  98     <br/>
  99     <h2>Table of contents</h2>
 100     <ul class="current">
 101 <li class="toctree-l1"><a class="reference internal" href="../user/index.html">For users</a></li>
 102 <li class="toctree-l1"><a class="reference internal" href="../admin/index.html">For administrators</a></li>
 103 <li class="toctree-l1"><a class="reference internal" href="../appdev/index.html">For application developers</a></li>
 104 <li class="toctree-l1"><a class="reference internal" href="../plugindev/index.html">For plugin module developers</a></li>
 105 <li class="toctree-l1"><a class="reference internal" href="../build/index.html">Building Kerberos V5</a></li>
 106 <li class="toctree-l1 current"><a class="reference internal" href="index.html">Kerberos V5 concepts</a><ul class="current">
 107 <li class="toctree-l2"><a class="reference internal" href="ccache_def.html">Credential cache</a></li>
 108 <li class="toctree-l2"><a class="reference internal" href="keytab_def.html">keytab</a></li>
 109 <li class="toctree-l2"><a class="reference internal" href="rcache_def.html">replay cache</a></li>
 110 <li class="toctree-l2 current"><a class="current reference internal" href="">stash file</a></li>
 111 <li class="toctree-l2"><a class="reference internal" href="date_format.html">Supported date and time formats</a></li>
 112 </ul>
 113 </li>
 114 <li class="toctree-l1"><a class="reference internal" href="../formats/index.html">Protocols and file formats</a></li>
 115 <li class="toctree-l1"><a class="reference internal" href="../mitK5features.html">MIT Kerberos features</a></li>
 116 <li class="toctree-l1"><a class="reference internal" href="../build_this.html">How to build this documentation from the source</a></li>
 117 <li class="toctree-l1"><a class="reference internal" href="../about.html">Contributing to the MIT Kerberos Documentation</a></li>
 118 <li class="toctree-l1"><a class="reference internal" href="../resources.html">Resources</a></li>
 119 </ul>
 120
 121     <br/>
 122     <h4><a href="../index.html">Full Table of Contents</a></h4>
 123     <h4>Search</h4>
 124     <form class="search" action="../search.html" method="get">
 125       <input type="text" name="q" size="18" />
 126       <input type="submit" value="Go" />
 127       <input type="hidden" name="check_keywords" value="yes" />
 128       <input type="hidden" name="area" value="default" />
 129     </form>
 130         </div>
 131         <div class="clearer"></div>
 132       </div>
 133     </div>
 134
 135     <div class="footer-wrapper">
 136         <div class="footer" >
 137             <div class="right" ><i>Release: 1.15.1</i><br />
 138                 &copy; <a href="../copyright.html">Copyright</a> 1985-2017, MIT.
 139             </div>
 140             <div class="left">
 141
 142         <a href="../index.html" title="Full Table of Contents"
 143             >Contents</a> |
 144         <a href="rcache_def.html" title="replay cache"
 145             >previous</a> |
 146         <a href="date_format.html" title="Supported date and time formats"
 147             >next</a> |
 148         <a href="../genindex.html" title="General Index"
 149             >index</a> |
 150         <a href="../search.html" title="Enter search criteria"
 151             >Search</a> |
 152     <a href="mailto:krb5-bugs@mit.edu?subject=Documentation__stash file">feedback</a>
 153             </div>
 154         </div>
 155     </div>
 156
 157   </body>
 158 </html>