Debian Codegraph @

doc/html/user/pwd_mgmt.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>Password management &#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="Ticket management" href="tkt_mgmt.html" />
20 <link rel="prev" title="For users" 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="For users"
33 accesskey="P">previous</a> |
34 <a href="tkt_mgmt.html" title="Ticket management"
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__Password management">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="password-management">
54 <h1>Password management<a class="headerlink" href="#password-management" title="Link to this heading">¶</a></h1>
55 <p>Your password is the only way Kerberos has of verifying your identity.
56 If someone finds out your password, that person can masquerade as
57 you—send email that comes from you, read, edit, or delete your files,
58 or log into other hosts as you—and no one will be able to tell the
59 difference. For this reason, it is important that you choose a good
60 password, and keep it secret. If you need to give access to your
61 account to someone else, you can do so through Kerberos (see
62 <a class="reference internal" href="#grant-access"><span class="std std-ref">Granting access to your account</span></a>). You should never tell your password to anyone,
63 including your system administrator, for any reason. You should
64 change your password frequently, particularly any time you think
65 someone may have found out what it is.</p>
66 <section id="changing-your-password">
67 <h2>Changing your password<a class="headerlink" href="#changing-your-password" title="Link to this heading">¶</a></h2>
68 <p>To change your Kerberos password, use the <a class="reference internal" href="user_commands/kpasswd.html#kpasswd-1"><span class="std std-ref">kpasswd</span></a> command.
69 It will ask you for your old password (to prevent someone else from
70 walking up to your computer when you’re not there and changing your
71 password), and then prompt you for the new one twice. (The reason you
72 have to type it twice is to make sure you have typed it correctly.)
73 For example, user <code class="docutils literal notranslate"><span class="pre">david</span></code> would do the following:</p>
74 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">shell</span><span class="o">%</span> <span class="n">kpasswd</span>
75 <span class="n">Password</span> <span class="k">for</span> <span class="n">david</span><span class="p">:</span> <span class="o">&lt;-</span> <span class="n">Type</span> <span class="n">your</span> <span class="n">old</span> <span class="n">password</span><span class="o">.</span>
76 <span class="n">Enter</span> <span class="n">new</span> <span class="n">password</span><span class="p">:</span> <span class="o">&lt;-</span> <span class="n">Type</span> <span class="n">your</span> <span class="n">new</span> <span class="n">password</span><span class="o">.</span>
77 <span class="n">Enter</span> <span class="n">it</span> <span class="n">again</span><span class="p">:</span> <span class="o">&lt;-</span> <span class="n">Type</span> <span class="n">the</span> <span class="n">new</span> <span class="n">password</span> <span class="n">again</span><span class="o">.</span>
78 <span class="n">Password</span> <span class="n">changed</span><span class="o">.</span>
79 <span class="n">shell</span><span class="o">%</span>
80 </pre></div>
81 </div>
82 <p>If <code class="docutils literal notranslate"><span class="pre">david</span></code> typed the incorrect old password, he would get the
83 following message:</p>
84 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">shell</span><span class="o">%</span> <span class="n">kpasswd</span>
85 <span class="n">Password</span> <span class="k">for</span> <span class="n">david</span><span class="p">:</span> <span class="o">&lt;-</span> <span class="n">Type</span> <span class="n">the</span> <span class="n">incorrect</span> <span class="n">old</span> <span class="n">password</span><span class="o">.</span>
86 <span class="n">kpasswd</span><span class="p">:</span> <span class="n">Password</span> <span class="n">incorrect</span> <span class="k">while</span> <span class="n">getting</span> <span class="n">initial</span> <span class="n">ticket</span>
87 <span class="n">shell</span><span class="o">%</span>
88 </pre></div>
89 </div>
90 <p>If you make a mistake and don’t type the new password the same way
91 twice, kpasswd will ask you to try again:</p>
92 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">shell</span><span class="o">%</span> <span class="n">kpasswd</span>
93 <span class="n">Password</span> <span class="k">for</span> <span class="n">david</span><span class="p">:</span> <span class="o">&lt;-</span> <span class="n">Type</span> <span class="n">the</span> <span class="n">old</span> <span class="n">password</span><span class="o">.</span>
94 <span class="n">Enter</span> <span class="n">new</span> <span class="n">password</span><span class="p">:</span> <span class="o">&lt;-</span> <span class="n">Type</span> <span class="n">the</span> <span class="n">new</span> <span class="n">password</span><span class="o">.</span>
95 <span class="n">Enter</span> <span class="n">it</span> <span class="n">again</span><span class="p">:</span> <span class="o">&lt;-</span> <span class="n">Type</span> <span class="n">a</span> <span class="n">different</span> <span class="n">new</span> <span class="n">password</span><span class="o">.</span>
96 <span class="n">kpasswd</span><span class="p">:</span> <span class="n">Password</span> <span class="n">mismatch</span> <span class="k">while</span> <span class="n">reading</span> <span class="n">password</span>
97 <span class="n">shell</span><span class="o">%</span>
98 </pre></div>
99 </div>
100 <p>Once you change your password, it takes some time for the change to
101 propagate through the system. Depending on how your system is set up,
102 this might be anywhere from a few minutes to an hour or more. If you
103 need to get new Kerberos tickets shortly after changing your password,
104 try the new password. If the new password doesn’t work, try again
105 using the old one.</p>
106 </section>
107 <section id="granting-access-to-your-account">
108 <span id="grant-access"></span><h2>Granting access to your account<a class="headerlink" href="#granting-access-to-your-account" title="Link to this heading">¶</a></h2>
109 <p>If you need to give someone access to log into your account, you can
110 do so through Kerberos, without telling the person your password.
111 Simply create a file called <a class="reference internal" href="user_config/k5login.html#k5login-5"><span class="std std-ref">.k5login</span></a> in your home directory.
112 This file should contain the Kerberos principal of each person to whom
113 you wish to give access. Each principal must be on a separate line.
114 Here is a sample .k5login file:</p>
115 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">jennifer</span><span class="nd">@ATHENA</span><span class="o">.</span><span class="n">MIT</span><span class="o">.</span><span class="n">EDU</span>
116 <span class="n">david</span><span class="nd">@EXAMPLE</span><span class="o">.</span><span class="n">COM</span>
117 </pre></div>
118 </div>
119 <p>This file would allow the users <code class="docutils literal notranslate"><span class="pre">jennifer</span></code> and <code class="docutils literal notranslate"><span class="pre">david</span></code> to use your
120 user ID, provided that they had Kerberos tickets in their respective
121 realms. If you will be logging into other hosts across a network, you
122 will want to include your own Kerberos principal in your .k5login file
123 on each of these hosts.</p>
124 <p>Using a .k5login file is much safer than giving out your password,
125 because:</p>
126 <ul class="simple">
127 <li><p>You can take access away any time simply by removing the principal
128 from your .k5login file.</p></li>
129 <li><p>Although the user has full access to your account on one particular
130 host (or set of hosts if your .k5login file is shared, e.g., over
131 NFS), that user does not inherit your network privileges.</p></li>
132 <li><p>Kerberos keeps a log of who obtains tickets, so a system
133 administrator could find out, if necessary, who was capable of using
134 your user ID at a particular time.</p></li>
135 </ul>
136 <p>One common application is to have a .k5login file in root’s home
137 directory, giving root access to that machine to the Kerberos
138 principals listed. This allows system administrators to allow users
139 to become root locally, or to log in remotely as root, without their
140 having to give out the root password, and without anyone having to
141 type the root password over the network.</p>
142 </section>
143 <section id="password-quality-verification">
144 <h2>Password quality verification<a class="headerlink" href="#password-quality-verification" title="Link to this heading">¶</a></h2>
145 <p>TODO</p>
146 </section>
147 </section>
148
149
150 <div class="clearer"></div>
151 </div>
152 </div>
153 </div>
154 </div>
155 <div class="sidebar">
156
157 <h2>On this page</h2>
158 <ul>
159 <li><a class="reference internal" href="#">Password management</a><ul>
160 <li><a class="reference internal" href="#changing-your-password">Changing your password</a></li>
161 <li><a class="reference internal" href="#granting-access-to-your-account">Granting access to your account</a></li>
162 <li><a class="reference internal" href="#password-quality-verification">Password quality verification</a></li>
163 </ul>
164 </li>
165 </ul>
166
167 <br/>
168 <h2>Table of contents</h2>
169 <ul class="current">
170 <li class="toctree-l1 current"><a class="reference internal" href="index.html">For users</a><ul class="current">
171 <li class="toctree-l2 current"><a class="current reference internal" href="#">Password management</a></li>
172 <li class="toctree-l2"><a class="reference internal" href="tkt_mgmt.html">Ticket management</a></li>
173 <li class="toctree-l2"><a class="reference internal" href="user_config/index.html">User config files</a></li>
174 <li class="toctree-l2"><a class="reference internal" href="user_commands/index.html">User commands</a></li>
175 </ul>
176 </li>
177 <li class="toctree-l1"><a class="reference internal" href="../admin/index.html">For administrators</a></li>
178 <li class="toctree-l1"><a class="reference internal" href="../appdev/index.html">For application developers</a></li>
179 <li class="toctree-l1"><a class="reference internal" href="../plugindev/index.html">For plugin module developers</a></li>
180 <li class="toctree-l1"><a class="reference internal" href="../build/index.html">Building Kerberos V5</a></li>
181 <li class="toctree-l1"><a class="reference internal" href="../basic/index.html">Kerberos V5 concepts</a></li>
182 <li class="toctree-l1"><a class="reference internal" href="../formats/index.html">Protocols and file formats</a></li>
183 <li class="toctree-l1"><a class="reference internal" href="../mitK5features.html">MIT Kerberos features</a></li>
184 <li class="toctree-l1"><a class="reference internal" href="../build_this.html">How to build this documentation from the source</a></li>
185 <li class="toctree-l1"><a class="reference internal" href="../about.html">Contributing to the MIT Kerberos Documentation</a></li>
186 <li class="toctree-l1"><a class="reference internal" href="../resources.html">Resources</a></li>
187 </ul>
188
189 <br/>
190 <h4><a href="../index.html">Full Table of Contents</a></h4>
191 <h4>Search</h4>
192 <form class="search" action="../search.html" method="get">
193 <input type="text" name="q" size="18" />
194 <input type="submit" value="Go" />
195 <input type="hidden" name="check_keywords" value="yes" />
196 <input type="hidden" name="area" value="default" />
197 </form>
198
199 </div>
200 <div class="clearer"></div>
201 </div>
202 </div>
203
204 <div class="footer-wrapper">
205 <div class="footer" >
206 <div class="right" ><i>Release: 1.22.1</i><br />
207 &copy; <a href="../copyright.html">Copyright</a> 1985-2025, MIT.
208 </div>
209 <div class="left">
210
211 <a href="../index.html" title="Full Table of Contents"
212 >Contents</a> |
213 <a href="index.html" title="For users"
214 >previous</a> |
215 <a href="tkt_mgmt.html" title="Ticket management"
216 >next</a> |
217 <a href="../genindex.html" title="General Index"
218 >index</a> |
219 <a href="../search.html" title="Enter search criteria"
220 >Search</a> |
221 <a href="mailto:[email protected]?subject=Documentation__Password management">feedback</a>
222 </div>
223 </div>
224 </div>
225
226 </body>
227 </html>