source: postlfs/security/mitkrb.xml@ e10e1a8e

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 9.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since e10e1a8e was e10e1a8e, checked in by Pierre Labastie <pieere@…>, 4 years ago

MIT Kerberos V5-1.17.1
Qt5-5.14.0
Qtwebengine-5.14.0

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@22472 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 31.6 KB
RevLine 
[b4b71892]1<?xml version="1.0" encoding="ISO-8859-1"?>
[6732c094]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
[b4b71892]4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
[c82398b2]7 <!ENTITY mitkrb-download-http "https://kerberos.org/dist/krb5/&mitkrb-major-version;/krb5-&mitkrb-version;.tar.gz">
[fa47d680]8 <!ENTITY mitkrb-download-ftp " ">
[e10e1a8e]9 <!ENTITY mitkrb-md5sum "417d654c72526ac51466e7fe84608878">
[7e288ef6]10 <!ENTITY mitkrb-size "8.4 MB">
[e10e1a8e]11 <!ENTITY mitkrb-buildsize "143 MB (add 26 MB for tests)">
12 <!ENTITY mitkrb-time "1 SBU (add 5.6 SBU for tests)">
[b4b71892]13]>
14
[f91ceaa]15<sect1 id="mitkrb" xreflabel="MIT Kerberos V5-&mitkrb-version;">
[93c27d5]16 <?dbhtml filename="mitkrb.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
[f91ceaa]23 <title>MIT Kerberos V5-&mitkrb-version;</title>
[93c27d5]24
25 <indexterm zone="mitkrb">
[f91ceaa]26 <primary sortas="a-MIT-Kerberos">MIT Kerberos V5</primary>
[93c27d5]27 </indexterm>
28
29 <sect2 role="package">
[f91ceaa]30 <title>Introduction to MIT Kerberos V5</title>
[93c27d5]31
[fa47d680]32 <para>
33 <application>MIT Kerberos V5</application> is a free implementation
34 of Kerberos 5. Kerberos is a network authentication protocol. It
35 centralizes the authentication database and uses kerberized
36 applications to work with servers or services that support Kerberos
37 allowing single logins and encrypted communication over internal
38 networks or the Internet.
39 </para>
[93c27d5]40
[6030130]41 &lfs90_checked;
[597a2890]42
[93c27d5]43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
[fa47d680]46 <para>
47 Download (HTTP): <ulink url="&mitkrb-download-http;"/>
48 </para>
[93c27d5]49 </listitem>
[29d1c248]50 <listitem>
[fa47d680]51 <para>
52 Download (FTP): <ulink url="&mitkrb-download-ftp;"/>
53 </para>
[29d1c248]54 </listitem>
[93c27d5]55 <listitem>
[fa47d680]56 <para>
57 Download MD5 sum: &mitkrb-md5sum;
58 </para>
[93c27d5]59 </listitem>
60 <listitem>
[fa47d680]61 <para>
62 Download size: &mitkrb-size;
63 </para>
[93c27d5]64 </listitem>
65 <listitem>
[fa47d680]66 <para>
67 Estimated disk space required: &mitkrb-buildsize;
68 </para>
[93c27d5]69 </listitem>
70 <listitem>
[fa47d680]71 <para>
72 Estimated build time: &mitkrb-time;
73 </para>
[93c27d5]74 </listitem>
75 </itemizedlist>
[af22057]76
[002a109]77<!-- Patch is not needed for this version, but don't remove this.
[d24ce70c]78 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
79 <itemizedlist spacing="compact">
80 <listitem>
81 <para>
82 Patch required on systems with IPv4 only enabled:
83 <ulink url="&patch-root;/mitkrb-&mitkrb-version;-fix_ipv4_only-1.patch"/>
84 </para>
85 </listitem>
86 </itemizedlist>
[002a109]87-->
[d24ce70c]88
[f91ceaa]89 <bridgehead renderas="sect3">MIT Kerberos V5 Dependencies</bridgehead>
[93c27d5]90
91 <bridgehead renderas="sect4">Optional</bridgehead>
[fa47d680]92 <para role="optional">
[bf7a21dd]93 <xref linkend="dejagnu"/> (for full test coverage),
94 <xref linkend="gnupg2"/> (to authenticate the package),
[fa47d680]95 <xref linkend="keyutils"/>,
[debb0893]96 <xref linkend="openldap"/>,
[0f46f6c]97 <xref linkend="rpcbind"/> (used during the testsuite), and
98 <xref linkend="valgrind"/> (used during the test suite)
[fa47d680]99 </para>
[93c27d5]100
101 <note>
[fa47d680]102 <para>
103 Some sort of time synchronization facility on your system (like
104 <xref linkend="ntp"/>) is required since Kerberos won't authenticate
105 if there is a time difference between a kerberized client and the
106 KDC server.
107 </para>
[93c27d5]108 </note>
[af22057]109
[3597eb6]110 <para condition="html" role="usernotes">User Notes:
[fa47d680]111 <ulink url="&blfs-wiki;/mitkrb"/>
112 </para>
[93c27d5]113 </sect2>
114
115 <sect2 role="installation">
[f91ceaa]116 <title>Installation of MIT Kerberos V5</title>
[93c27d5]117
[002a109]118<!-- PATCH IS REJECTED - ALREADY PATCHED
[d24ce70c]119 <para>
120 If your system is configured to support only IPv4, apply the following
121 patch:
122 </para>
123
124<screen><userinput>patch -p1 -i ../mitkrb-&mitkrb-version;-fix_ipv4_only-1.patch</userinput></screen>
[002a109]125-->
[d24ce70c]126
[fa47d680]127 <para>
128 Build <application>MIT Kerberos V5</application> by running the
129 following commands:
130 </para>
[93c27d5]131
[af21cbe2]132<screen><userinput>cd src &amp;&amp;
[f22b905]133
134sed -i -e 's@\^u}@^u cols 300}@' tests/dejagnu/config/default.exp &amp;&amp;
135sed -i -e '/eq 0/{N;s/12 //}' plugins/kdb/db2/libdb2/test/run.test &amp;&amp;
[096aa70]136
[bf7a21dd]137./configure --prefix=/usr \
138 --sysconfdir=/etc \
139 --localstatedir=/var/lib \
[256e1e84]140 --with-system-et \
141 --with-system-ss \
[6e08e9c0]142 --with-system-verto=no \
[597a2890]143 --enable-dns-for-realm &amp;&amp;
[93c27d5]144make</userinput></screen>
145
[fa47d680]146 <para>
[096aa70]147 To test the build, issue as the <systemitem
[f22b905]148 class="username">root</systemitem> user: <command>make -k check</command>.
[096aa70]149 You need at least <xref linkend="tcl"/>, which is used to drive the
150 testsuite. Furthermore, <xref linkend="dejagnu"/> must be available for
151 some of the tests to run. If you have a former version of MIT Kerberos V5
[bf7a21dd]152 installed, it may happen that the test suite pick up the installed
[096aa70]153 versions of the libraries, rather than the newly built ones. If so, it is
[e10e1a8e]154 better to run the tests after the installation.
[fa47d680]155 </para>
[f91ceaa]156
[fa47d680]157 <para>
158 Now, as the <systemitem class="username">root</systemitem> user:
159 </para>
[93c27d5]160
161<screen role="root"><userinput>make install &amp;&amp;
[f91ceaa]162
[096aa70]163for f in gssapi_krb5 gssrpc k5crypto kadm5clnt kadm5srv \
164 kdb5 kdb_ldap krad krb5 krb5support verto ; do
165
166 find /usr/lib -type f -name "lib$f*.so*" -exec chmod -v 755 {} \;
[ea6894f]167done &amp;&amp;
[98dd5b8]168
[2799196]169mv -v /usr/lib/libkrb5.so.3* /lib &amp;&amp;
170mv -v /usr/lib/libk5crypto.so.3* /lib &amp;&amp;
[f91ceaa]171mv -v /usr/lib/libkrb5support.so.0* /lib &amp;&amp;
172
[2799196]173ln -v -sf ../../lib/libkrb5.so.3.3 /usr/lib/libkrb5.so &amp;&amp;
174ln -v -sf ../../lib/libk5crypto.so.3.1 /usr/lib/libk5crypto.so &amp;&amp;
[597a2890]175ln -v -sf ../../lib/libkrb5support.so.0.1 /usr/lib/libkrb5support.so &amp;&amp;
[f91ceaa]176
[98dd5b8]177mv -v /usr/bin/ksu /bin &amp;&amp;
178chmod -v 755 /bin/ksu &amp;&amp;
179
180install -v -dm755 /usr/share/doc/krb5-&mitkrb-version; &amp;&amp;
[ea6894f]181cp -vfr ../doc/* /usr/share/doc/krb5-&mitkrb-version;</userinput></screen>
[af22057]182
[93c27d5]183 </sect2>
184
185 <sect2 role="commands">
186 <title>Command Explanations</title>
[af22057]187
[debb0893]188 <para>
[6d2ead8]189 The first sed increases the width of the virtual terminal used for some
190 tests to prevent some spurious text in the output which is taken as a
191 failure. The second <command>sed</command> removes a test that is known
192 to fail.
[debb0893]193 </para>
194
[fa47d680]195 <para>
[f1d7196]196 <parameter>--localstatedir=/var/lib</parameter>: This option is
[4453848]197 used so that the Kerberos variable run-time data is located in
198 <filename class="directory">/var/lib</filename> instead of
199 <filename class="directory">/usr/var</filename>.
[fa47d680]200 </para>
[256e1e84]201
[fa47d680]202 <para>
[256e1e84]203 <parameter>--with-system-et</parameter>: This switch causes the build
[fa47d680]204 to use the system-installed versions of the error-table support
205 software.
206 </para>
207
208 <para>
[256e1e84]209 <parameter>--with-system-ss</parameter>: This switch causes the build
[fa47d680]210 to use the system-installed versions of the subsystem command-line
211 interface software.
212 </para>
213
[6e08e9c0]214 <para>
[f1d7196]215 <parameter>--with-system-verto=no</parameter>: This switch fixes a bug in
[6e08e9c0]216 the package: it does not recognize its own verto library installed
217 previously. This is not a problem, if reinstalling the same version,
218 but if you are updating, the old library is used as system's one,
219 instead of installing the new version.
220 </para>
221
[fa47d680]222 <para>
[f1d7196]223 <parameter>--enable-dns-for-realm</parameter>: This switch allows
[4453848]224 realms to be resolved using the DNS server.
[fa47d680]225 </para>
226
227 <para>
[2f12da13]228 <option>--with-ldap</option>: Use this switch if you want to compile the
[096aa70]229 <application>OpenLDAP</application> database backend module.
230 </para>
231
232 <para>
233 <command>mv -v /usr/lib/libk... /lib </command> and
234 <command>ln -v -sf ../../lib/libk... /usr/lib/libk...</command>:
235 Move critical libraries to the
236 <filename class="directory">/lib</filename> directory so that they are
[fa47d680]237 available when the <filename class="directory">/usr</filename>
238 filesystem is not mounted.
239 </para>
240
241 <para>
[096aa70]242 <command>find /usr/lib -type f -name "lib$f*.so*" -exec chmod -v 755 {} \;</command>:
243 This command changes the permisison of installed libraries.
244 </para>
245
246 <para>
247 <command>mv -v /usr/bin/ksu /bin</command>: Moves the
248 <command>ksu</command> program to the
249 <filename class="directory">/bin</filename> directory so that it is
250 available when the <filename class="directory">/usr</filename>
251 filesystem is not mounted.
[fa47d680]252 </para>
[93c27d5]253
254 </sect2>
255
256 <sect2 role="configuration">
[f91ceaa]257 <title>Configuring MIT Kerberos V5</title>
[af22057]258
[93c27d5]259 <sect3 id="krb5-config">
260 <title>Config Files</title>
261
[fa47d680]262 <para>
263 <filename>/etc/krb5.conf</filename> and
264 <filename>/var/lib/krb5kdc/kdc.conf</filename>
265 </para>
[93c27d5]266
267 <indexterm zone="mitkrb krb5-config">
[597a2890]268 <primary sortas="e-etc-krb5.conf">/etc/krb5.conf</primary>
[93c27d5]269 </indexterm>
270
271 <indexterm zone="mitkrb krb5-config">
272 <primary sortas="e-var-lib-krb5kdc-kdc.conf">/var/lib/krb5kdc/kdc.conf</primary>
273 </indexterm>
274
275 </sect3>
276
277 <sect3>
278 <title>Configuration Information</title>
279
280 <sect4>
281 <title>Kerberos Configuration</title>
282
[f91ceaa]283 <tip>
[fa47d680]284 <para>
285 You should consider installing some sort of password checking
286 dictionary so that you can configure the installation to only
287 accept strong passwords. A suitable dictionary to use is shown in
288 the <xref linkend="cracklib"/> instructions. Note that only one
289 file can be used, but you can concatenate many files into one. The
290 configuration file shown below assumes you have installed a
291 dictionary to <filename>/usr/share/dict/words</filename>.
292 </para>
[f91ceaa]293 </tip>
294
[fa47d680]295 <para>
296 Create the Kerberos configuration file with the following
297 commands issued by the <systemitem class="username">root</systemitem>
298 user:
299 </para>
[93c27d5]300
[597a2890]301<screen role="root"><userinput>cat &gt; /etc/krb5.conf &lt;&lt; "EOF"
302<literal># Begin /etc/krb5.conf
[dc04b84]303
[b4b71892]304[libdefaults]
[ea6bb02]305 default_realm = <replaceable>&lt;EXAMPLE.ORG&gt;</replaceable>
[b4b71892]306 encrypt = true
307
308[realms]
[ea6bb02]309 <replaceable>&lt;EXAMPLE.ORG&gt;</replaceable> = {
310 kdc = <replaceable>&lt;belgarath.example.org&gt;</replaceable>
311 admin_server = <replaceable>&lt;belgarath.example.org&gt;</replaceable>
[f91ceaa]312 dict_file = /usr/share/dict/words
[b4b71892]313 }
314
315[domain_realm]
[ea6bb02]316 .<replaceable>&lt;example.org&gt;</replaceable> = <replaceable>&lt;EXAMPLE.ORG&gt;</replaceable>
[b4b71892]317
318[logging]
[d24ce70c]319 kdc = SYSLOG:INFO:AUTH
320 admin_server = SYSLOG:INFO:AUTH
321 default = SYSLOG:DEBUG:DAEMON
[b4b71892]322
[597a2890]323# End /etc/krb5.conf</literal>
[93c27d5]324EOF</userinput></screen>
325
[fa47d680]326 <para>
327 You will need to substitute your domain and proper hostname for the
328 occurrences of the <replaceable>&lt;belgarath&gt;</replaceable> and
[ea6bb02]329 <replaceable>&lt;example.org&gt;</replaceable> names.
[fa47d680]330 </para>
331
332 <para>
333 <option>default_realm</option> should be the name of your
334 domain changed to ALL CAPS. This isn't required, but both
335 <application>Heimdal</application> and MIT recommend it.
336 </para>
337
338 <para>
339 <option>encrypt = true</option> provides encryption of all traffic
340 between kerberized clients and servers. It's not necessary and can
341 be left off. If you leave it off, you can encrypt all traffic from
342 the client to the server using a switch on the client program
343 instead.
344 </para>
345
346 <para>
347 The <option>[realms]</option> parameters tell the client programs
348 where to look for the KDC authentication services.
349 </para>
350
351 <para>
352 The <option>[domain_realm]</option> section maps a domain to a realm.
353 </para>
354
355 <para>
356 Create the KDC database:
357 </para>
[93c27d5]358
[ea6bb02]359<screen role="root"><userinput>kdb5_util create -r <replaceable>&lt;EXAMPLE.ORG&gt;</replaceable> -s</userinput></screen>
[93c27d5]360
[fa47d680]361 <para>
[601a838]362 Now you should populate the database with principals
[fa47d680]363 (users). For now, just use your regular login name or
364 <systemitem class="username">root</systemitem>.
365 </para>
[93c27d5]366
367<screen role="root"><userinput>kadmin.local
[bf7a21dd]368<prompt>kadmin.local:</prompt> add_policy dict-only
369<prompt>kadmin.local:</prompt> addprinc -policy dict-only <replaceable>&lt;loginname&gt;</replaceable></userinput></screen>
[93c27d5]370
[fa47d680]371 <para>
372 The KDC server and any machine running kerberized
373 server daemons must have a host key installed:
374 </para>
[93c27d5]375
[ea6bb02]376<screen role="root"><userinput><prompt>kadmin.local:</prompt> addprinc -randkey host/<replaceable>&lt;belgarath.example.org&gt;</replaceable></userinput></screen>
[93c27d5]377
[fa47d680]378 <para>
379 After choosing the defaults when prompted, you will have to
380 export the data to a keytab file:
381 </para>
[93c27d5]382
[ea6bb02]383<screen role="root"><userinput><prompt>kadmin.local:</prompt> ktadd host/<replaceable>&lt;belgarath.example.org&gt;</replaceable></userinput></screen>
[93c27d5]384
[fa47d680]385 <para>
386 This should have created a file in
387 <filename class="directory">/etc</filename> named
388 <filename>krb5.keytab</filename> (Kerberos 5). This file should
389 have 600 (<systemitem class="username">root</systemitem> rw only)
390 permissions. Keeping the keytab files from public access is crucial
391 to the overall security of the Kerberos installation.
392 </para>
[93c27d5]393
[fa47d680]394 <para>
395 Exit the <command>kadmin</command> program (use
396 <command>quit</command> or <command>exit</command>) and return
397 back to the shell prompt. Start the KDC daemon manually, just to
398 test out the installation:
399 </para>
[93c27d5]400
[fa47d680]401<screen role="root"><userinput>/usr/sbin/krb5kdc</userinput></screen>
[93c27d5]402
[fa47d680]403 <para>
404 Attempt to get a ticket with the following command:
405 </para>
[93c27d5]406
[3597eb6]407<screen><userinput>kinit <replaceable>&lt;loginname&gt;</replaceable></userinput></screen>
[93c27d5]408
[fa47d680]409 <para>
410 You will be prompted for the password you created. After you
411 get your ticket, you can list it with the following command:
412 </para>
[93c27d5]413
414<screen><userinput>klist</userinput></screen>
415
[fa47d680]416 <para>
417 Information about the ticket should be displayed on the
418 screen.
419 </para>
[93c27d5]420
[fa47d680]421 <para>
422 To test the functionality of the keytab file, issue the
423 following command:
424 </para>
[93c27d5]425
426<screen><userinput>ktutil
[597a2890]427<prompt>ktutil:</prompt> rkt /etc/krb5.keytab
[93c27d5]428<prompt>ktutil:</prompt> l</userinput></screen>
429
[fa47d680]430 <para>
431 This should dump a list of the host principal, along with
432 the encryption methods used to access the principal.
433 </para>
[93c27d5]434
[fa47d680]435 <para>
436 At this point, if everything has been successful so far, you
437 can feel fairly confident in the installation and configuration of
438 the package.
439 </para>
[93c27d5]440
441 </sect4>
[b4b71892]442
[93c27d5]443 <sect4>
444 <title>Additional Information</title>
445
[fa47d680]446 <para>
[bf7a21dd]447 For additional information consult the <ulink
448 url="http://web.mit.edu/kerberos/www/krb5-&mitkrb-major-version;/#documentation">
449 documentation for krb5-&mitkrb-version;</ulink> on which the above
[fa47d680]450 instructions are based.
451 </para>
[93c27d5]452
453 </sect4>
454
455 </sect3>
[6aeeb90]456
[d9d26317]457 <sect3 id="mitkrb-init">
[f586237]458 <title><phrase revision="sysv">Init Script</phrase>
459 <phrase revision="systemd">Systemd Unit</phrase></title>
[d9d26317]460
[f586237]461 <para revision="sysv">
[d9d26317]462 If you want to start <application>Kerberos</application> services
463 at boot, install the <filename>/etc/rc.d/init.d/krb5</filename> init
[f586237]464 script included in the <xref linkend="bootscripts"/> package using
[d9d26317]465 the following command:
466 </para>
467
[f586237]468 <para revision="systemd">
469 If you want to start <application>Kerberos</application> services
470 at boot, install the <filename>krb5.service</filename> unit included in
471 the <xref linkend="systemd-units"/> package using the following command:
472 </para>
473
[d9d26317]474 <indexterm zone="mitkrb mitkrb-init">
475 <primary sortas="f-krb5">krb5</primary>
476 </indexterm>
477
478<screen role="root"><userinput>make install-krb5</userinput></screen>
479
480 </sect3>
481
[93c27d5]482 </sect2>
483
484 <sect2 role="content">
[fa47d680]485
[93c27d5]486 <title>Contents</title>
[ec578e6]487 <para></para>
[af22057]488
[93c27d5]489 <segmentedlist>
490 <segtitle>Installed Programs</segtitle>
491 <segtitle>Installed Libraries</segtitle>
492 <segtitle>Installed Directories</segtitle>
493
494 <seglistitem>
[fa47d680]495 <seg>
[0d7900a]496 gss-client, gss-server, k5srvutil, kadmin, kadmin.local,
[bf7a21dd]497 kadmind, kdb5_ldap_util (optional), kdb5_util, kdestroy, kinit, klist,
[e10e1a8e]498 kpasswd, kprop, kpropd, kproplog, krb5-config, krb5-send-pr, krb5kdc,
[0d7900a]499 ksu, kswitch, ktutil, kvno, sclient, sim_client, sim_server,
[b7a300f7]500 sserver, uuclient, and uuserver
[fa47d680]501 </seg>
502 <seg>
[af21cbe2]503 libgssapi_krb5.so, libgssrpc.so, libk5crypto.so, libkadm5clnt_mit.so,
504 libkadm5clnt.so, libkadm5srv_mit.so, libkadm5srv.so, libkdb_ldap.so
505 (optional), libkdb5.so, libkrad.so, libkrb5.so, libkrb5support.so,
[6e08e9c0]506 libverto.so, and some plugins under the /usr/lib/krb5 tree
[fa47d680]507 </seg>
508 <seg>
[ad22690]509 /usr/include/{gssapi,gssrpc,kadm5,krb5},
[0d7900a]510 /usr/lib/krb5,
[096aa70]511 /usr/share/{doc/krb5-&mitkrb-version;,examples/krb5},
512 /var/lib/krb5kdc, and
[e10e1a8e]513 /run/krb5kdc
[fa47d680]514 </seg>
[93c27d5]515 </seglistitem>
516 </segmentedlist>
517
518 <variablelist>
519 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
520 <?dbfo list-presentation="list"?>
521 <?dbhtml list-presentation="table"?>
522
[73fe507]523 <varlistentry id="gss-client">
524 <term><command>gss-client</command></term>
525 <listitem>
526 <para>
527 is a GSSAPI test client.
528 </para>
529 <indexterm zone="mitkrb gss-client">
530 <primary sortas="b-gss-client">gss-client</primary>
531 </indexterm>
532 </listitem>
533 </varlistentry>
534
535 <varlistentry id="gss-server">
536 <term><command>gss-server</command></term>
537 <listitem>
538 <para>
539 is a GSSAPI test server.
540 </para>
541 <indexterm zone="mitkrb gss-server">
542 <primary sortas="b-gss-server">gss-server</primary>
543 </indexterm>
544 </listitem>
545 </varlistentry>
546
[93c27d5]547 <varlistentry id="k5srvutil">
548 <term><command>k5srvutil</command></term>
549 <listitem>
[fa47d680]550 <para>
551 is a host keytable manipulation utility.
552 </para>
[93c27d5]553 <indexterm zone="mitkrb k5srvutil">
554 <primary sortas="b-k5srvutil">k5srvutil</primary>
555 </indexterm>
556 </listitem>
557 </varlistentry>
558
[fa47d680]559 <varlistentry id="kadmin">
[93c27d5]560 <term><command>kadmin</command></term>
561 <listitem>
[fa47d680]562 <para>
[0f46f6c]563 is an utility used to make modifications
[fa47d680]564 to the Kerberos database.
565 </para>
566 <indexterm zone="mitkrb kadmin">
[93c27d5]567 <primary sortas="b-kadmin">kadmin</primary>
568 </indexterm>
569 </listitem>
570 </varlistentry>
571
[28370fe]572 <varlistentry id="kadmin.local">
573 <term><command>kadmin.local</command></term>
574 <listitem>
575 <para>
[0f46f6c]576 is an utility similar to <command>kadmin</command>, but if the
[28370fe]577 database is db2, the local client <command>kadmin.local</command>,
578 is intended to run directly on the master KDC without Kerberos
579 authentication.
580 </para>
581 <indexterm zone="mitkrb kadmin.local">
582 <primary sortas="b-kadmin.local">kadmin.local</primary>
583 </indexterm>
584 </listitem>
585 </varlistentry>
586
[fa47d680]587 <varlistentry id="kadmind">
[93c27d5]588 <term><command>kadmind</command></term>
589 <listitem>
[fa47d680]590 <para>
591 is a server for administrative access
592 to a Kerberos database.
593 </para>
594 <indexterm zone="mitkrb kadmind">
[93c27d5]595 <primary sortas="b-kadmind">kadmind</primary>
596 </indexterm>
597 </listitem>
598 </varlistentry>
599
[73fe507]600 <varlistentry id="kdb5_ldap_util">
601 <term><command>kdb5_ldap_util (optional)</command></term>
602 <listitem>
603 <para>
604 allows an administrator to manage realms, Kerberos services
605 and ticket policies.
606 </para>
607 <indexterm zone="mitkrb kdb5_ldap_util">
608 <primary sortas="b-kdb5_ldap_util">kdb5_ldap_util</primary>
609 </indexterm>
610 </listitem>
611 </varlistentry>
612
[93c27d5]613 <varlistentry id="kdb5_util">
614 <term><command>kdb5_util</command></term>
615 <listitem>
[fa47d680]616 <para>
617 is the KDC database utility.
618 </para>
[93c27d5]619 <indexterm zone="mitkrb kdb5_util">
620 <primary sortas="b-kdb5_util">kdb5_util</primary>
621 </indexterm>
622 </listitem>
623 </varlistentry>
624
[fa47d680]625 <varlistentry id="kdestroy">
[93c27d5]626 <term><command>kdestroy</command></term>
627 <listitem>
[fa47d680]628 <para>
629 removes the current set of tickets.
630 </para>
631 <indexterm zone="mitkrb kdestroy">
[93c27d5]632 <primary sortas="b-kdestroy">kdestroy</primary>
633 </indexterm>
634 </listitem>
635 </varlistentry>
636
[fa47d680]637 <varlistentry id="kinit">
[93c27d5]638 <term><command>kinit</command></term>
639 <listitem>
[fa47d680]640 <para>
641 is used to authenticate to the Kerberos server as a
642 principal and acquire a ticket granting ticket that can
643 later be used to obtain tickets for other services.
644 </para>
645 <indexterm zone="mitkrb kinit">
[93c27d5]646 <primary sortas="b-kinit">kinit</primary>
647 </indexterm>
648 </listitem>
649 </varlistentry>
650
[fa47d680]651 <varlistentry id="klist">
[93c27d5]652 <term><command>klist</command></term>
653 <listitem>
[fa47d680]654 <para>
655 reads and displays the current tickets in
656 the credential cache.
657 </para>
658 <indexterm zone="mitkrb klist">
[93c27d5]659 <primary sortas="b-klist">klist</primary>
660 </indexterm>
661 </listitem>
662 </varlistentry>
663
[fa47d680]664 <varlistentry id="kpasswd">
[93c27d5]665 <term><command>kpasswd</command></term>
666 <listitem>
[fa47d680]667 <para>
668 is a program for changing Kerberos 5 passwords.
669 </para>
670 <indexterm zone="mitkrb kpasswd">
[93c27d5]671 <primary sortas="b-kpasswd">kpasswd</primary>
672 </indexterm>
673 </listitem>
674 </varlistentry>
675
676 <varlistentry id="kprop">
677 <term><command>kprop</command></term>
678 <listitem>
[fa47d680]679 <para>
680 takes a principal database in a specified format and
681 converts it into a stream of database records.
682 </para>
[93c27d5]683 <indexterm zone="mitkrb kprop">
684 <primary sortas="b-kprop">kprop</primary>
685 </indexterm>
686 </listitem>
687 </varlistentry>
688
689 <varlistentry id="kpropd">
690 <term><command>kpropd</command></term>
691 <listitem>
[fa47d680]692 <para>
693 receives a database sent by <command>kprop</command>
694 and writes it as a local database.
695 </para>
[93c27d5]696 <indexterm zone="mitkrb kpropd">
697 <primary sortas="b-kpropd">kpropd</primary>
698 </indexterm>
699 </listitem>
700 </varlistentry>
701
[73fe507]702 <varlistentry id="kproplog">
703 <term><command>kproplog</command></term>
704 <listitem>
705 <para>
706 displays the contents of the KDC database update log to standard
707 output.
708 </para>
709 <indexterm zone="mitkrb kproplog">
710 <primary sortas="b-kproplog">kproplog</primary>
711 </indexterm>
712 </listitem>
713 </varlistentry>
714
[f91ceaa]715 <varlistentry id="krb5-config-prog2">
[93c27d5]716 <term><command>krb5-config</command></term>
717 <listitem>
[fa47d680]718 <para>
719 gives information on how to link programs against
720 libraries.
721 </para>
[f91ceaa]722 <indexterm zone="mitkrb krb5-config-prog2">
723 <primary sortas="b-krb5-config">krb5-config</primary>
[93c27d5]724 </indexterm>
725 </listitem>
726 </varlistentry>
727
728 <varlistentry id="krb5kdc">
729 <term><command>krb5kdc</command></term>
730 <listitem>
[fa47d680]731 <para>
732 is the <application>Kerberos 5</application> server.
733 </para>
[93c27d5]734 <indexterm zone="mitkrb krb5kdc">
735 <primary sortas="b-krb5kdc">krb5kdc</primary>
736 </indexterm>
737 </listitem>
738 </varlistentry>
739
[28370fe]740 <varlistentry id="krb5-send-pr">
741 <term><command>krb5-send-pr</command></term>
[73fe507]742 <listitem>
743 <para>
[2f12da13]744 sends a problem report (PR) to a central support site.
[73fe507]745 </para>
[28370fe]746 <indexterm zone="mitkrb krb5-send-pr">
747 <primary sortas="b-krb-send-pr">krb5-send-pr</primary>
[73fe507]748 </indexterm>
749 </listitem>
750 </varlistentry>
751
[93c27d5]752 <varlistentry id="ksu">
753 <term><command>ksu</command></term>
754 <listitem>
[fa47d680]755 <para>
756 is the super user program using Kerberos protocol.
757 Requires a properly configured
758 <filename>/etc/shells</filename> and
759 <filename>~/.k5login</filename> containing principals
760 authorized to become super users.
761 </para>
[93c27d5]762 <indexterm zone="mitkrb ksu">
763 <primary sortas="b-ksu">ksu</primary>
764 </indexterm>
765 </listitem>
766 </varlistentry>
767
[597a2890]768 <varlistentry id="kswitch">
769 <term><command>kswitch</command></term>
770 <listitem>
[fa47d680]771 <para>
[0d7900a]772 makes the specified credential cache the
773 primary cache for the collection, if a cache
[fa47d680]774 collection is available.
775 </para>
[597a2890]776 <indexterm zone="mitkrb kswitch">
777 <primary sortas="b-kswitch">kswitch</primary>
778 </indexterm>
779 </listitem>
780 </varlistentry>
781
[fa47d680]782 <varlistentry id="ktutil">
[93c27d5]783 <term><command>ktutil</command></term>
784 <listitem>
[fa47d680]785 <para>
786 is a program for managing Kerberos keytabs.
787 </para>
788 <indexterm zone="mitkrb ktutil">
[93c27d5]789 <primary sortas="b-ktutil">ktutil</primary>
790 </indexterm>
791 </listitem>
792 </varlistentry>
793
794 <varlistentry id="kvno">
795 <term><command>kvno</command></term>
796 <listitem>
[fa47d680]797 <para>
798 prints keyversion numbers of Kerberos principals.
799 </para>
[93c27d5]800 <indexterm zone="mitkrb kvno">
801 <primary sortas="b-kvno">kvno</primary>
802 </indexterm>
803 </listitem>
804 </varlistentry>
805
[597a2890]806 <varlistentry id="sclient">
807 <term><command>sclient</command></term>
[93c27d5]808 <listitem>
[fa47d680]809 <para>
[2f12da13]810 is used to contact a sample server and authenticate to it
[fa47d680]811 using Kerberos 5 tickets, then display the server's
812 response.
813 </para>
[597a2890]814 <indexterm zone="mitkrb sclient">
815 <primary sortas="b-sclient">sclient</primary>
[93c27d5]816 </indexterm>
817 </listitem>
818 </varlistentry>
819
[73fe507]820 <varlistentry id="sim_client">
821 <term><command>sim_client</command></term>
822 <listitem>
823 <para>
824 is a simple UDP-based sample client program, for
825 demonstration.
826 </para>
827 <indexterm zone="mitkrb sim_client">
828 <primary sortas="b-sim_client">sim_client</primary>
829 </indexterm>
830 </listitem>
831 </varlistentry>
832
833 <varlistentry id="sim_server">
834 <term><command>sim_server</command></term>
835 <listitem>
836 <para>
837 is a simple UDP-based server application, for
838 demonstration.
839 </para>
840 <indexterm zone="mitkrb sim_server">
841 <primary sortas="b-sim_server">sim_server</primary>
842 </indexterm>
843 </listitem>
844 </varlistentry>
845
[597a2890]846 <varlistentry id="sserver">
847 <term><command>sserver</command></term>
[93c27d5]848 <listitem>
[fa47d680]849 <para>
850 is the sample Kerberos 5 server.
851 </para>
[597a2890]852 <indexterm zone="mitkrb sserver">
853 <primary sortas="b-sserver">sserver</primary>
[93c27d5]854 </indexterm>
855 </listitem>
856 </varlistentry>
857
[73fe507]858 <varlistentry id="uuclient">
859 <term><command>uuclient</command></term>
860 <listitem>
861 <para>
[2f12da13]862 is another sample client.
[73fe507]863 </para>
864 <indexterm zone="mitkrb uuclient">
865 <primary sortas="b-uuclient">uuclient</primary>
866 </indexterm>
867 </listitem>
868 </varlistentry>
869
870 <varlistentry id="uuserver">
871 <term><command>uuserver</command></term>
872 <listitem>
873 <para>
[2f12da13]874 is another sample server.
[73fe507]875 </para>
876 <indexterm zone="mitkrb uuserver">
877 <primary sortas="b-uuserver">uuserver</primary>
878 </indexterm>
879 </listitem>
880 </varlistentry>
881
882
[fa47d680]883 <varlistentry id="libgssapi_krb5">
[3ff3b9b]884 <term><filename class="libraryfile">libgssapi_krb5.so</filename></term>
[93c27d5]885 <listitem>
[fa47d680]886 <para>
[2f12da13]887 contains the Generic Security Service Application Programming
[fa47d680]888 Interface (GSSAPI) functions which provides security services
889 to callers in a generic fashion, supportable with a range of
890 underlying mechanisms and technologies and hence allowing
891 source-level portability of applications to different
892 environments.
893 </para>
894 <indexterm zone="mitkrb libgssapi_krb5">
[f91ceaa]895 <primary sortas="c-libgssapi_krb5">libgssapi_krb5.so</primary>
[93c27d5]896 </indexterm>
897 </listitem>
898 </varlistentry>
899
[fa47d680]900 <varlistentry id="libkadm5clnt">
[3ff3b9b]901 <term><filename class="libraryfile">libkadm5clnt.so</filename></term>
[93c27d5]902 <listitem>
[fa47d680]903 <para>
904 contains the administrative authentication and password checking
905 functions required by Kerberos 5 client-side programs.
906 </para>
907 <indexterm zone="mitkrb libkadm5clnt">
[f91ceaa]908 <primary sortas="c-libkadm5clnt">libkadm5clnt.so</primary>
[93c27d5]909 </indexterm>
910 </listitem>
911 </varlistentry>
912
[fa47d680]913 <varlistentry id="libkadm5srv">
[3ff3b9b]914 <term><filename class="libraryfile">libkadm5srv.so</filename></term>
[93c27d5]915 <listitem>
[fa47d680]916 <para>
[2f12da13]917 contains the administrative authentication and password
[fa47d680]918 checking functions required by Kerberos 5 servers.
919 </para>
920 <indexterm zone="mitkrb libkadm5srv">
[f91ceaa]921 <primary sortas="c-libkadm5srv">libkadm5srv.so</primary>
[93c27d5]922 </indexterm>
923 </listitem>
924 </varlistentry>
925
926 <varlistentry id="libkdb5">
[3ff3b9b]927 <term><filename class="libraryfile">libkdb5.so</filename></term>
[93c27d5]928 <listitem>
[fa47d680]929 <para>
930 is a Kerberos 5 authentication/authorization database
931 access library.
932 </para>
[93c27d5]933 <indexterm zone="mitkrb libkdb5">
[f91ceaa]934 <primary sortas="c-libkdb5">libkdb5.so</primary>
[93c27d5]935 </indexterm>
936 </listitem>
937 </varlistentry>
938
[bf7a21dd]939 <varlistentry id="libkrad">
940 <term><filename class="libraryfile">libkrad.so</filename></term>
941 <listitem>
942 <para>
943 contains the internal support library for RADIUS functionality.
944 </para>
945 <indexterm zone="mitkrb libkrad">
946 <primary sortas="c-libkrad">libkrad.so</primary>
947 </indexterm>
948 </listitem>
949 </varlistentry>
950
[fa47d680]951 <varlistentry id="libkrb5">
[3ff3b9b]952 <term><filename class="libraryfile">libkrb5.so</filename></term>
[93c27d5]953 <listitem>
[fa47d680]954 <para>
955 is an all-purpose <application>Kerberos 5</application> library.
956 </para>
957 <indexterm zone="mitkrb libkrb5">
[f91ceaa]958 <primary sortas="c-libkrb5">libkrb5.so</primary>
[93c27d5]959 </indexterm>
960 </listitem>
961 </varlistentry>
962
963 </variablelist>
[af22057]964
[93c27d5]965 </sect2>
[1dce143]966
967</sect1>
Note: See TracBrowser for help on using the repository browser.