kadmin_util(8) [osx man page]
kadmin_util(8) BSD System Manager's Manual kadmin_util(8) NAME
kadmin_util -- Kerberos -- Open Directory Single Sign On SYNOPSIS
kadmin_util -a principal_name -d principal_name [-r REALM] [-h] [-p] [-v debug_level] DESCRIPTION
kadmin_util is a tool for managing the access control list used by kadmind to control which users have the ability to modify the Kerberos database of user information. It will look at the acl_file item in the realm section of the kdc config file to determine which acl files to update. -a principal_name Adds the given principal name to the acl file with administrator privs. -d principal_name Removes the given principal name from the acl. (-a & -d are mutually exclusinve) -h Send a HUP signal to kadmind if the update completes without errors -p Write the output error to standard out in an XML Plist format -r REALM Denotes which realm to update. If this parameter is omitted, kadmin_util will operate on the first realm it finds in the kdc config file. To operate on all the available realms use '*' for the realm name -v debug_level Sets the debug level (1 = progress >1 for more detail) EXAMPLES
To add adminuser@REALM.COM to the acl file as kerberos administrator for realm REALM.COM kadmin_util -a adminuser@REALM.COM -r REALM.COM To remove adminuser@REALM.COM from all the realms serviced by this kdc (you need the quotes around the * to keep the shell from substituting filenames) kadmin_util -d adminuser@REALM.COM -r '*' FILES
/var/db/krb5kdc/kadm5.acl the standard acl file location /var/db/krb5kdc/kdc.conf the default kdc config file DIAGNOSTICS
You can add -v debug_level to any kadmin_util command. Debug level 1 provides status information, higher levels add progressivly more levels of detail. NOTES
The kadmin_util tool is used by the Apple Single Sign On system to set up a KDC integrated with the rest of the Single Sign On components. SEE ALSO
DirectoryService(1), kerberos(1), kadmind(8), kerberosautoconfig(8), krbservicesetup(8), krb5kdc(8), sso_util(8) Darwin June 2, 2019 Darwin
Check Out this Related Man Page
KPROPD(8) MIT Kerberos KPROPD(8) NAME
kpropd - Kerberos V5 slave KDC update server SYNOPSIS
kpropd [-r realm] [-a acl_file] [-f slave_dumpfile] [-F principal_database] [-p kdb5_util_prog] [-P port] [-d] DESCRIPTION
The kpropd command runs on the slave KDC server. It listens for update requests made by the kprop(8) program. If incremental propagation is enabled, it periodically requests incremental updates from the master KDC. When the slave receives a kprop request from the master, kpropd accepts the dumped KDC database and places it in a file, and then runs kdb5_util(8) to load the dumped database into the active database which is used by krb5kdc(8). This allows the master Kerberos server to use kprop(8) to propagate its database to the slave servers. Upon a successful download of the KDC database file, the slave Kerberos server will have an up-to-date KDC database. Where incremental propagation is not used, kpropd is commonly invoked out of inetd(8) as a nowait service. This is done by adding a line to the /etc/inetd.conf file which looks like this: kprop stream tcp nowait root /usr/local/sbin/kpropd kpropd kpropd can also run as a standalone daemon. This is required for incremental propagation. But this is also useful for debugging purposes. Incremental propagation may be enabled with the iprop_enable variable in kdc.conf(5). If incremental propagation is enabled, the slave periodically polls the master KDC for updates, at an interval determined by the iprop_slave_poll variable. If the slave receives updates, kpropd updates its log file with any updates from the master. kproplog(8) can be used to view a summary of the update entry log on the slave KDC. If incremental propagation is enabled, the principal kiprop/slavehostname@REALM (where slavehostname is the name of the slave KDC host, and REALM is the name of the Kerberos realm) must be present in the slave's keytab file. kproplog(8) can be used to force full replication when iprop is enabled. OPTIONS
-r realm Specifies the realm of the master server. -f file Specifies the filename where the dumped principal database file is to be stored; by default the dumped database file is /var/ker- beros/krb5kdc/from_master. -p Allows the user to specify the pathname to the kdb5_util(8) program; by default the pathname used is /usr/sbin/kdb5_util. -S [DEPRECATED] Enable standalone mode. Normally kpropd is invoked by inetd(8) so it expects a network connection to be passed to it from inetd(8). If the -S option is specified, or if standard input is not a socket, kpropd will put itself into the background, and wait for connections on port 754 (or the port specified with the -P option if given). -d Turn on debug mode. In this mode, if the -S option is selected, kpropd will not detach itself from the current job and run in the background. Instead, it will run in the foreground and print out debugging messages during the database propagation. -P Allow for an alternate port number for kpropd to listen on. This is only useful in combination with the -S option. -a acl_file Allows the user to specify the path to the kpropd.acl file; by default the path used is /var/kerberos/krb5kdc/kpropd.acl. ENVIRONMENT
kpropd uses the following environment variables: o KRB5_CONFIG o KRB5_KDC_PROFILE FILES
kpropd.acl Access file for kpropd; the default location is /usr/local/var/krb5kdc/kpropd.acl. Each entry is a line containing the principal of a host from which the local machine will allow Kerberos database propagation via kprop(8). SEE ALSO
kprop(8), kdb5_util(8), krb5kdc(8), inetd(8) AUTHOR
MIT COPYRIGHT
1985-2013, MIT 1.11.3 KPROPD(8)