openbsd-ports/www/mod_auth_kerb/files
alek fdd166745c Import mod_auth_kerb 5.0rc6
This is the Apache Kerberos authentication module. It
allows any Apache web-server to become a Kerberos client
for authentication requests.

From Chris Kuethe <ckuethe@ualberta.ca>
2005-11-03 16:23:13 +00:00
..
mod_auth_kerb-enable Import mod_auth_kerb 5.0rc6 2005-11-03 16:23:13 +00:00
README Import mod_auth_kerb 5.0rc6 2005-11-03 16:23:13 +00:00

$OpenBSD: README,v 1.1.1.1 2005/11/03 16:23:13 alek Exp $

If you haven't already run the module enabler, you can manually enable
Kerberos support by adding the following lines into httpd.conf near the
other authentication modules.

	# user authentication using kerberos
	LoadModule auth_kerb_module /usr/lib/apache/modules/mod_auth_kerb.so

To require Kerberos authenication for a directory (or file or location),
enclose that location in a block that looks like this. The mod_auth_kerb
documenation is a bit sketchy yet, but this was taken from a working openbsd
machine using mod_auth_kerb. Only the names have been changed to protect
the realm. Obviously, you must have working Kerberos before this module can
do anything useful.

	# A Kerberos Authenticated Directory
	<Directory /var/www/htdocs/private>
		AuthType Kerberos
		AuthName "Kerberos Userid and Password"
		KrbMethodNegotiate off
		KrbMethodK5Passwd on
		KrbAuthRealms YOUR.REALM
		KrbVerifyKDC on
		Krb5Keytab /var/www/conf/httpd.keytab
		KrbServiceName http
		require valid-user
	</Directory>

It is suggested that you create a keytab for httpd that is readable but not
writeable by apache, and has no relation to your other Kerberos keys. One
way to do this:

	ktutil -k /var/www/conf/httpd.keytab add -V 1 -e des-cbc-crc \
		-w PASSWORD -p http/host.domain.tld@REALM.TLD
	chown root:www /var/www/conf/httpd.keytab
	chmod 0440 /var/www/conf/httpd.keytab

Thus, if httpd is ever convinced to give access to the keytab, it will be
unable to make changes to the keytab, and will be unable to do anything more
than serve up its own keytab (which is bad enough).