diff options
author | Russ Allbery <rra@stanford.edu> | 2006-09-13 23:52:00 +0000 |
---|---|---|
committer | Russ Allbery <rra@stanford.edu> | 2006-09-13 23:52:00 +0000 |
commit | 6172f4bfa2562a042c6dbd5b81d50d333a7793ef (patch) | |
tree | a93cdc3c47b684d2c6f0e99886850117201d07e6 /server | |
parent | dbf7d6d583b84bf9680ee0dda74fffbb2c6f38ce (diff) |
Rename to keytab-backend and fix the documentation. Change the name of the
temporary directory to /var/lib/keytabs.
Diffstat (limited to 'server')
-rwxr-xr-x | server/keytab-backend (renamed from server/kdc-backend) | 26 |
1 files changed, 13 insertions, 13 deletions
diff --git a/server/kdc-backend b/server/keytab-backend index 4568329..4e744d9 100755 --- a/server/kdc-backend +++ b/server/keytab-backend @@ -1,7 +1,7 @@ #!/usr/bin/perl our $ID = q$Id$; # -# kdc-backend -- Extract keytabs from the KDC without changing the key. +# keytab-backend -- Extract keytabs from the KDC without changing the key. # # This is a remctl backend that extracts existing keys from a KDC database # using kadmin.local. It requires a patched version of kadmin.local that @@ -9,7 +9,7 @@ our $ID = q$Id$; # /etc/krb5kdc/allow-extract that contains a list of regexes, one per line, # matching principals that may be extracted in this fashion. (Generally you # do not want to list user principals here.) It also expects to be able to -# write to a directory named /var/lib/kdc-backend; that's where it puts the +# write to a directory named /var/lib/keytabs; that's where it puts the # keytabs temporarily before sending them back to via remctl. # # remctl should handle authorization restrictions on this script. It doesn't @@ -48,7 +48,7 @@ our $CONFIG = '/etc/krb5kdc/allow-extract'; our $KADMIN = '/usr/sbin/kadmin.local'; # A temporary area into which keytabs should be written. -our $TMP = '/var/lib/kdc-backend'; +our $TMP = '/var/lib/keytabs'; ############################################################################## # Logging @@ -59,7 +59,7 @@ our $TMP = '/var/lib/kdc-backend'; sub fail { my $message = join ('', @_); syslog ('err', '%s', $message); - die "kdc-backend: $message\n"; + die "keytab-backend: $message\n"; } ############################################################################## @@ -68,7 +68,7 @@ sub fail { # Separately log our actions. remctl keeps some logs, but it won't tell us # whether the download is successful or not. -openlog ('kdc-backend', 'pid', 'auth'); +openlog ('keytab-backend', 'pid', 'auth'); # Set up a default identity if run from the command line. $ENV{REMUSER} = getpwnam ($<) || 'UNKNOWN' unless $ENV{REMUSER}; @@ -133,15 +133,15 @@ exit 0; =head1 NAME -kdc-backend - Extract keytabs from the KDC without changing the key +keytab-backend - Extract keytabs from the KDC without changing the key =head1 SYNOPSIS -B<kdc-backend> retrieve I<principal> +B<keytab-backend> retrieve I<principal> =head1 DESCRIPTION -B<kdc-backend> retrieves a keytab for an existing principal from the KDC +B<keytab-backend> retrieves a keytab for an existing principal from the KDC database without changing the current key. It allows generation of a keytab for a service without rekeying that service. It requires a B<kadmin.local> patched to support the B<-norandkey> option to B<ktadd>. @@ -160,7 +160,7 @@ software, limit as tightly as possible which principals can be downloaded in this fashion. Generally only shared service principals used on multiple systems should be made available in this way. -B<kdc-backend> does not do any authorization checks. Those should be done +B<keytab-backend> does not do any authorization checks. Those should be done by B<remctld> before it is called. =head1 FILES @@ -173,12 +173,12 @@ The configuration file that controls which principals can have their keytabs retrieved. Blank lines and lines starting with C<#>, as well as anything after C<#> on a line, are ignored. All other lines should be Perl regular expressions, one per line, that match principals whose keytabs can be -retrieved by B<kdc-backend>. Any principal that does not match one of those -regular expressions cannot be retrieved. +retrieved by B<keytab-backend>. Any principal that does not match one of +those regular expressions cannot be retrieved. -=item F</var/lib/kdc-backend> +=item F</var/lib/keytabs> -The temporary directory used for creating keytabs. B<kdc-backend> will +The temporary directory used for creating keytabs. B<keytab-backend> will create the keytab in this directory, make sure that was successful, and then delete the temporary file after the results have been sent to standard output. |