| 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)` |