How to configure Loandesk
=========================

Create a configuration file that looks something like:

	#! /usr/bin/perl /usr/lib/cgi-bin/xyzzy

	Application UvT::Loandesk

	# not needed: loandesk does not serve content
	ContentDir /etc/loandesk/content
	# XHTML templates
	TemplateDir /etc/loandesk/templates
	FragmentDir /etc/loandesk/fragments

	# iPort Authbroker for external users
	AuthBrokerHost authbroker.example.com
	# port defaults to 4033
	AuthBrokerPort 1234

	# For A-Select users
	LoandeskAselectID loandesk

	# secret is used to secure cookies.
	# generate using (e.g.) makepasswd --chars=64
	LoandeskSecret
	LoandeskMPS http://pica.example.com:4034/pica3
	# nonces are used to confirm the user's intention
	LoandeskNonceExpiry 5m

	# to look up employeeNumber
	LDAPServer ldap://ldap.example.com
	LDAPBase dc=example,dc=com

How to configure Apache
=======================

Enable mod_fcgid and add a snippet like this to your
vhost definition:

	Alias /favicon.ico /var/www/favicon.ico
	Alias /robots.txt /var/www/robots.txt
	Alias /loandesk.js /usr/share/loandesk/www/loandesk.js
	Alias /loandesk.css /usr/share/loandesk/www/loandesk.css
	ScriptAlias / /etc/xyzzy/loandesk.cfg/

or:

	Alias /loandesk.js /usr/share/loandesk/www/loandesk.js
	Alias /loandesk.css /usr/share/loandesk/www/loandesk.css
	ScriptAlias /loandesk /etc/xyzzy/loandesk.cfg

and in either case:

	<Directory /etc/xyzzy/>
		Options none
		AllowOverride none
		Order deny,allow
		Allow from all
		SetHandler fcgid-script
	</Directory>

	<Directory /usr/share/loandesk/www/>
		Options none
		AllowOverride none
		Order deny,allow
		Allow from all
	</Directory>

-- 
$Id: README 32091 2010-08-05 14:59:50Z wsl $
$URL: https://infix.uvt.nl/its-id/trunk/sources/loandesk/README $
