Configuring TWiki for use with Shibboleth

  1. install the CGI::Session Perl package, it its not already available on your system. It is available here from CPAN. Bizarrely, it does not contain any installation instructions. Use the standard install process for a Perl package:
    1. perl Makefile.PL
    2. make
    3. make test
    4. make install
  2. Install and configure TWiki. Be sure to use TWiki20040902. Follow the directions here.
  3. Download and install the TWiki Session Plugin available here
  4. Se sure to chmod 755 bin/logon
  5. Apply the Shibboleth related patches
    1. lib/TWiki.pm
    2. lib/TWiki/Plugins/SessionPlugin.pm
    3. data/Main/webleftbar.txt. Actually, I can't seem to get this patch to work. Instead, just replace your WebLeftBar.txt file with this one. Lines 2-4 are new; that's the only change.
  6. create a bin/.htaccess file to protect logon (NOTE: change path to error template). Sample available here.
  7. Setup so new webs get proper webleftbar (not done yet)