source: postlfs/security/mitkrb.xml@ f4b62235

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since f4b62235 was f4b62235, checked in by Xi Ruoyao <xry111@…>, 12 months ago

mitkrb: Bring back -j1 for test

On one of my systems, -j4 causes the test to fail :(.

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