source: postlfs/security/mitkrb.xml@ f236d3a

12.2 gimp3 lazarus trunk xry111/for-12.3 xry111/spidermonkey128
Last change on this file since f236d3a was 78ec1b9, checked in by Xi Ruoyao <xry111@…>, 3 months ago

mitkrb: Get rid of rpath

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