Crowd 1.1 : 3.2.1 Integrating Crowd with Apache or Subversion
This page last changed on Jun 12, 2007 by justen.stepka@atlassian.com.
IntroductionThis documentation describes how to configure Crowd to authenticate HTTP Authentication requests made to an Apache webserver.
Prerequisites
Installation and ConfigurationThe following instructions are for Unix systems. If you're running Apache on Windows, see the notes below. Installing required Perl ModulesThe easiest way to install the required Perl modules is to download them from CPAN (using the links above) and install them as follows: tar xvzf Cache-Cache-1.05.tar.gz cd Cache-Cache-1.05 perl Makefile.PL make make install See http://search.cpan.org/~jhi/perl-5.8.0/pod/perlmodinstall.pod for a detailed description of the various ways of installing Perl modules on your system. Installing the Apache::CrowdAuth Perl ModuleDownload the Apache-CrowdAuth-0.04.zip file and extract and install it as follows: unzip Apache-CrowdAuth-0.04.zip cd Apache-CrowdAuth-0.04 perl Makefile.PL make make install Configuring ApacheEnsure that mod_perl is enabled.Your Apache config file should contain a line like the following: LoadModule perl_module modules/mod_perl.so Many common distributions of Apache come with mod_perl preconfigured. Configure AuthenticationTo tell Apache to use Crowd to authenticate requests for a particular location, edit the Apache config file to add the following commands to a <Location> or <Directory> section. Alias /crowd/ "/var/crowd/" <Directory "/var/crowd/"> . . . AuthName crowd AuthType Basic PerlAuthenHandler Apache::CrowdAuth PerlSetVar CrowdAppName appname PerlSetVar CrowdAppPassword apppassword PerlSetVar CrowdSOAPURL http://localhost:8095/crowd/services/SecurityServer PerlSetVar CrowdCacheEnabled on PerlSetVar CrowdCacheLocation /tmp/CrowdAuth PerlSetVar CrowdCacheExpiry 300 require valid-user . . . </Directory>
Subversion IntegrationIf you are using Apache to manage access to a subversion repository (instructions), you can use the same configuration method to delegate user authentication to Crowd. Example: <Location /svn> # Uncomment this to enable the repository, DAV svn # Set this to the path to your repository SVNPath /var/lib/svn AuthName crowd AuthType Basic PerlAuthenHandler Apache::CrowdAuth PerlSetVar CrowdAppName subversion PerlSetVar CrowdAppPassword svn PerlSetVar CrowdSOAPURL http://localhost:8080/crowd/services/SecurityServer require valid-user # The following three lines allow anonymous read, but make # committers authenticate themselves. <LimitExcept GET PROPFIND OPTIONS REPORT> Require valid-user </LimitExcept> </Location> Note that Apache will have to be restarted before any changes to its config files will take effect. Troubleshooting
Apache Log Error Messages
Installing Perl, mod_perl and Perl Modules on Windows
(The following instructions assume you are using ActivePerl as your Perl environment).
Installing Perl Modules on WindowsAll the required modules (Digest::SHA1, Error, Cache::FileCache, SOAP:Lite) are available through the Perl Package Manager utility. Installing Apache::CrowdAuth on WindowsExtract Apache-CrowdAuth-0.04.zip using Winzip or equivalent... cd Apache-CrowdAuth-0.04 perl Makefile.PL nmake nmake install When editing the httpd.conf file and adding the mod_perl.so module to Apache, you may need to add the following line above the LoadModule line LoadFile "C:/Perl/bin/perl58.dll" LoadModule perl_module modules/mod_perl.so This LoadFile line points to the perl58.dll in your Perl install directory. Related Topics
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
![]() |
Document generated by Confluence on Jun 20, 2007 20:58 |