Debian Codegraph @

doc/admin/admin_commands/k5srvutil.rst

raw
1 .. _k5srvutil(1):
2
3 k5srvutil
4 =========
5
6 SYNOPSIS
7 --------
8
9 **k5srvutil** *operation*
10 [**-i**]
11 [**-f** *filename*]
12 [**-e** *keysalts*]
13
14 DESCRIPTION
15 -----------
16
17 k5srvutil allows an administrator to list keys currently in
18 a keytab, to obtain new keys for a principal currently in a keytab,
19 or to delete non-current keys from a keytab.
20
21 *operation* must be one of the following:
22
23 **list**
24 Lists the keys in a keytab, showing version number and principal
25 name.
26
27 **change**
28 Uses the kadmin protocol to update the keys in the Kerberos
29 database to new randomly-generated keys, and updates the keys in
30 the keytab to match. If a key's version number doesn't match the
31 version number stored in the Kerberos server's database, then the
32 operation will fail. If the **-i** flag is given, k5srvutil will
33 prompt for confirmation before changing each key. If the **-k**
34 option is given, the old and new keys will be displayed.
35 Ordinarily, keys will be generated with the default encryption
36 types and key salts. This can be overridden with the **-e**
37 option. Old keys are retained in the keytab so that existing
38 tickets continue to work, but **delold** should be used after
39 such tickets expire, to prevent attacks against the old keys.
40
41 **delold**
42 Deletes keys that are not the most recent version from the keytab.
43 This operation should be used some time after a change operation
44 to remove old keys, after existing tickets issued for the service
45 have expired. If the **-i** flag is given, then k5srvutil will
46 prompt for confirmation for each principal.
47
48 **delete**
49 Deletes particular keys in the keytab, interactively prompting for
50 each key.
51
52 In all cases, the default keytab is used unless this is overridden by
53 the **-f** option.
54
55 k5srvutil uses the :ref:`kadmin(1)` program to edit the keytab in
56 place.
57
58
59 ENVIRONMENT
60 -----------
61
62 See :ref:`kerberos(7)` for a description of Kerberos environment
63 variables.
64
65
66 SEE ALSO
67 --------
68
69 :ref:`kadmin(1)`, :ref:`ktutil(1)`, :ref:`kerberos(7)`