Man page generated from reStructuredText.
. . .nr rst2man-indent-level 0 . \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .rstReportMargin pre:
. RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .rstReportMargin post:
.. . RE indent \\n[an-margin]
old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1 new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.. kdb5_ldap_util - Kerberos configuration utility kdb5_ldap_util [-D user_dn [-w passwd]] [-H ldapuri] command [command_options] kdb5_ldap_util allows an administrator to manage realms, Kerberos services and ticket policies. NDENT 0.0

-r realm Specifies the realm to be operated on.

-D user_dn Specifies the Distinguished Name (DN) of the user who has sufficient rights to perform the operation on the LDAP server.

-w passwd Specifies the password of user_dn. This option is not recommended.

-H ldapuri Specifies the URI of the LDAP server. NINDENT By default, kdb5_ldap_util operates on the default realm (as specified in \%krb5.conf) and connects and authenticates to the LDAP server in the same manner as :ref:kadmind(8)\(ga would given the parameters in \%[dbdefaults] in \%kdc.conf.

NDENT 0.0 NDENT 3.5 create [-subtrees subtree_dn_list] [-sscope search_scope] [-containerref container_reference_dn] [-k mkeytype] [-kv mkeyVNO] [-M mkeyname] [-m|-P password|-sf stashfilename] [-s] [-maxtktlife max_ticket_life] [-maxrenewlife max_renewable_ticket_life] [ticket_flags] NINDENT NINDENT Creates realm in directory. Options: NDENT 0.0

-subtrees subtree_dn_list Specifies the list of subtrees containing the principals of a realm. The list contains the DNs of the subtree objects separated by colon (:).

-sscope search_scope Specifies the scope for searching the principals under the subtree. The possible values are 1 or one (one level), 2 or sub (subtrees).

-containerref container_reference_dn Specifies the DN of the container object in which the principals of a realm will be created. If the container reference is not configured for a realm, the principals will be created in the realm container.

-k mkeytype Specifies the key type of the master key in the database. The default is given by the master_key_type variable in \%kdc.conf.

-kv mkeyVNO Specifies the version number of the master key in the database; the default is 1. Note that 0 is not allowed.

-M mkeyname Specifies the principal name for the master key in the database. If not specified, the name is determined by the master_key_name variable in \%kdc.conf.

-m Specifies that the master database password should be read from the TTY rather than fetched from a file on the disk.

-P password Specifies the master database password. This option is not recommended.

-sf stashfilename Specifies the stash file of the master database password.

-s Specifies that the stash file is to be created.

-maxtktlife max_ticket_life (\%getdate time string) Specifies maximum ticket life for principals in this realm.

-maxrenewlife max_renewable_ticket_life (\%getdate time string) Specifies maximum renewable life of tickets for principals in this realm.

ticket_flags Specifies global ticket flags for the realm. Allowable flags are documented in the description of the add_principal command in \%kadmin. NINDENT Example: NDENT 0.0 NDENT 3.5 .EX kdb5_ldap_util -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu -r ATHENA.MIT.EDU create -subtrees o=org -sscope SUB Password for \(dqcn=admin,o=org\(dq: Initializing database for realm \(aqATHENA.MIT.EDU\(aq You will be prompted for the database Master Password. It is important that you NOT FORGET this password. Enter KDC database master key: Re-enter KDC database master key to verify: NINDENT NINDENT

NDENT 0.0 NDENT 3.5 modify [-subtrees subtree_dn_list] [-sscope search_scope] [-containerref container_reference_dn] [-maxtktlife max_ticket_life] [-maxrenewlife max_renewable_ticket_life] [ticket_flags] NINDENT NINDENT Modifies the attributes of a realm. Options: NDENT 0.0

-subtrees subtree_dn_list Specifies the list of subtrees containing the principals of a realm. The list contains the DNs of the subtree objects separated by colon (:). This list replaces the existing list.

-sscope search_scope Specifies the scope for searching the principals under the subtrees. The possible values are 1 or one (one level), 2 or sub (subtrees).

-containerref container_reference_dn Specifies the DN of the container object in which the principals of a realm will be created.

-maxtktlife max_ticket_life (\%getdate time string) Specifies maximum ticket life for principals in this realm.

-maxrenewlife max_renewable_ticket_life (\%getdate time string) Specifies maximum renewable life of tickets for principals in this realm.

ticket_flags Specifies global ticket flags for the realm. Allowable flags are documented in the description of the add_principal command in \%kadmin. NINDENT Example: NDENT 0.0 NDENT 3.5 .EX shell% kdb5_ldap_util -r ATHENA.MIT.EDU -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu modify +requires_preauth Password for \(dqcn=admin,o=org\(dq: shell% NINDENT NINDENT

NDENT 0.0 NDENT 3.5 view NINDENT NINDENT Displays the attributes of a realm. Example: NDENT 0.0 NDENT 3.5 .EX kdb5_ldap_util -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu -r ATHENA.MIT.EDU view Password for \(dqcn=admin,o=org\(dq: Realm Name: ATHENA.MIT.EDU Subtree: ou=users,o=org Subtree: ou=servers,o=org SearchScope: ONE Maximum ticket life: 0 days 01:00:00 Maximum renewable life: 0 days 10:00:00 Ticket flags: DISALLOW_FORWARDABLE REQUIRES_PWCHANGE NINDENT NINDENT NDENT 0.0 NDENT 3.5 destroy [-f] NINDENT NINDENT Destroys an existing realm. Options: NDENT 0.0

-f If specified, will not prompt the user for confirmation. NINDENT Example: NDENT 0.0 NDENT 3.5 .EX shell% kdb5_ldap_util -r ATHENA.MIT.EDU -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu destroy Password for \(dqcn=admin,o=org\(dq: Deleting KDC database of \(aqATHENA.MIT.EDU\(aq, are you sure? (type \(aqyes\(aq to confirm)? yes OK, deleting database of \(aqATHENA.MIT.EDU\(aq... shell% NINDENT NINDENT

NDENT 0.0 NDENT 3.5 list NINDENT NINDENT Lists the names of realms under the container. Example: NDENT 0.0 NDENT 3.5 .EX shell% kdb5_ldap_util -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu list Password for \(dqcn=admin,o=org\(dq: ATHENA.MIT.EDU OPENLDAP.MIT.EDU MEDIA-LAB.MIT.EDU shell% NINDENT NINDENT NDENT 0.0 NDENT 3.5 stashsrvpw [-f filename] name NINDENT NINDENT Allows an administrator to store the password for service object in a file so that KDC and Administration server can use it to authenticate to the LDAP server. Options: NDENT 0.0

-f filename Specifies the complete path of the service password file. By default, /usr/local/var/service_passwd is used.

name Specifies the name of the object whose password is to be stored. If \%krb5kdc or \%kadmind are configured for simple binding, this should be the distinguished name it will use as given by the ldap_kdc_dn or ldap_kadmind_dn variable in \%kdc.conf. If the KDC or kadmind is configured for SASL binding, this should be the authentication name it will use as given by the ldap_kdc_sasl_authcid or ldap_kadmind_sasl_authcid variable. NINDENT Example: NDENT 0.0 NDENT 3.5 .EX kdb5_ldap_util stashsrvpw -f /home/andrew/conf_keyfile cn=service-kdc,o=org Password for \(dqcn=service-kdc,o=org\(dq: Re-enter password for \(dqcn=service-kdc,o=org\(dq: NINDENT NINDENT

NDENT 0.0 NDENT 3.5 create_policy [-maxtktlife max_ticket_life] [-maxrenewlife max_renewable_ticket_life] [ticket_flags] policy_name NINDENT NINDENT Creates a ticket policy in the directory. Options: NDENT 0.0

-maxtktlife max_ticket_life (\%getdate time string) Specifies maximum ticket life for principals.

-maxrenewlife max_renewable_ticket_life (\%getdate time string) Specifies maximum renewable life of tickets for principals.

ticket_flags Specifies the ticket flags. If this option is not specified, by default, no restriction will be set by the policy. Allowable flags are documented in the description of the add_principal command in \%kadmin.

policy_name Specifies the name of the ticket policy. NINDENT Example: NDENT 0.0 NDENT 3.5 .EX kdb5_ldap_util -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu -r ATHENA.MIT.EDU create_policy -maxtktlife \(dq1 day\(dq -maxrenewlife \(dq1 week\(dq -allow_postdated +needchange -allow_forwardable tktpolicy Password for \(dqcn=admin,o=org\(dq: NINDENT NINDENT

NDENT 0.0 NDENT 3.5 modify_policy [-maxtktlife max_ticket_life] [-maxrenewlife max_renewable_ticket_life] [ticket_flags] policy_name NINDENT NINDENT Modifies the attributes of a ticket policy. Options are same as for create_policy. Example: NDENT 0.0 NDENT 3.5 .EX kdb5_ldap_util -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu -r ATHENA.MIT.EDU modify_policy -maxtktlife \(dq60 minutes\(dq -maxrenewlife \(dq10 hours\(dq +allow_postdated -requires_preauth tktpolicy Password for \(dqcn=admin,o=org\(dq: NINDENT NINDENT NDENT 0.0 NDENT 3.5 view_policy policy_name NINDENT NINDENT Displays the attributes of the named ticket policy. Example: NDENT 0.0 NDENT 3.5 .EX kdb5_ldap_util -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu -r ATHENA.MIT.EDU view_policy tktpolicy Password for \(dqcn=admin,o=org\(dq: Ticket policy: tktpolicy Maximum ticket life: 0 days 01:00:00 Maximum renewable life: 0 days 10:00:00 Ticket flags: DISALLOW_FORWARDABLE REQUIRES_PWCHANGE NINDENT NINDENT NDENT 0.0 NDENT 3.5 destroy_policy [-force] policy_name NINDENT NINDENT Destroys an existing ticket policy. Options: NDENT 0.0

-force Forces the deletion of the policy object. If not specified, the user will be prompted for confirmation before deleting the policy.

policy_name Specifies the name of the ticket policy. NINDENT Example: NDENT 0.0 NDENT 3.5 .EX kdb5_ldap_util -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu -r ATHENA.MIT.EDU destroy_policy tktpolicy Password for \(dqcn=admin,o=org\(dq: This will delete the policy object \(aqtktpolicy\(aq, are you sure? (type \(aqyes\(aq to confirm)? yes ** policy object \(aqtktpolicy\(aq deleted. NINDENT NINDENT

NDENT 0.0 NDENT 3.5 list_policy NINDENT NINDENT Lists ticket policies. Example: NDENT 0.0 NDENT 3.5 .EX kdb5_ldap_util -D cn=admin,o=org -H ldaps://ldap-server1.mit.edu -r ATHENA.MIT.EDU list_policy Password for \(dqcn=admin,o=org\(dq: tktpolicy tmppolicy userpolicy NINDENT NINDENT See \%kerberos for a description of Kerberos environment variables. \%kadmin, \%kerberos MIT 1985-2025, MIT Generated by docutils manpage writer.
.