source: postlfs/security/mitkrb.xml@ 134224d2

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 9.0 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 134224d2 was 63945e0, checked in by Xi Ruoyao <xry111@…>, 5 years ago

krb5: test suite now uses Python 3

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