  MOD_CASPACE INSTALLATION OVERVIEW

  Requiements
  ===========

  o Apache2 Web Server (2.0.x or better)
  o WSO2 WSF/C (1.0 or better)
    - This can be replaced by Apache Axis2/C + Apache Rampart/C

  Unix
  ====
  
  $ ./configure --with-apache2=APACHE2_HOME --with-wsfc=WSFC_HOME
  $ make
  $ cp .libs/libmod_cspace.so APACHE_MODULES_DIR/
    
  NOTES: * Replace APACHE2_HOME and WSFC_HOME respcetively with the Apache2
           install directory and WSO2 WSF/C install directory. In either case,
           lib/ and include/ directories must be direct childrens of the
           directories that you have specified.

         * Replace APACHE_MODULES_DIR with the directory where you want your
           module to reside. Usually this is with the other modules in
           /usr/lib/apache2/modules/

         * It is possible for you to use Apache Axis2/C and Apache Rampart/C
           instead of using WSO2 WSF/C. Provide the Axis2/C repo path to the 
           --with-wsfc parameter in that case.
  
  Win32
  =====

  Use the nmake script or the Visual Studio project inside the build/win32
  directory.

  Using nmake
  -----------
 
  Change the configure.in file. It is well documented, so read the comments
  given for each parameter and configure them appropriately.

  > make all
  > copy modules\mod_cspace.so APACHE_MODULES_DIR\
  
  NOTES: * Replace APACHE_MODULES_DIR with the directory where you want your
           module to reside. Usually this is with the other modules in
           /usr/lib/apache2/modules/

  Using VS project
  ----------------

  Set up WSO2 WSF/C and Apache2 library paths and include paths.
  Build using the GUI.

  Configuration
  =============
  
  Minimal configuration required to enable cardspace on Apache2 server is as
  follows. Note that this assumes that a PHP-like framework is in place to
  provide session management.

  LoadModule cspace_module modules/mod_cspace.so
  <Location /identity/>
      UseCardSpaceAuth
      CardSpaceTVS url_to_token_verifier_service
  </Location>

  For a complete list of configuration options please refer to the 
  MOD_CSPACE_GUIDE or
  http://wso2.org/project/solutions/identity/1.0-beta/docs/mod-cspace-config.html
