Crowd : 4.2 - Integrating Crowd with Apache
This page last changed on Mar 06, 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 the SOAP::Lite Perl ModuleSOAP::Lite is a Perl library for managing SOAP calls. It is used by the CrowdAuth module to talk to the Crowd server. The easiest way to install SOAP::Lite is via CPAN, by running the following command. perl -MCPAN -e 'install SOAP::Lite' Alternatively, you can download and install the package manually. Installing the Apache::CrowdAuth Perl ModuleDownload the Apache-CrowdAuth-0.03.tar.gz file and extract and install it as follows: tar xvzf Apache-CrowdAuth-0.03.tar.gz cd Apache-CrowdAuth-0.03 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:8080/crowd/services/SecurityServer 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 SOAP::Lite on WindowsUse the cpan shell C:\ cpan cpan> install SOAP::Lite Installing Apache::CrowdAuth on WindowsExtract Apache-CrowdAuth-0.03.tar.gz using Winzip or equivalent... cd Apache-CrowdAuth-0.03 perl Makefile.PL nmake nmake install ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
![]() |
Document generated by Confluence on Mar 08, 2007 18:50 |