README.zxid-tas3
================
$Id: README.zxid-tas3,v 1.4 2009-10-18 12:39:10 sampo Exp $

ZXID is general purpose SSO and Identity Web Services project, see zxid.org

TAS3 - Trustable Architecture for Secure Shared Services - is an European
FP7 research project that has chosen to use SAML 2.0 and ID-WSF 2.0
and is using ZXID as one implementation of these technologies. See tas3.eu

The research leading to these results has received funding from the
European Community's Seventh Framework Programme (FP7/2007-2013) under
grant agreement number 216287 (TAS3 - Trusted Architecture for Securely
Shared Services - www.tas3.eu).

Since ZXID is important for TAS3 and vice versa, ZXID Makefile contains
some targets for producing ZXID specific packages

  make tas3maspkg   # T3-SSO-ZXID-MODAUTHSAML-V.VV.zip
  make tas3phppkg   # T3-SSO-ZXID-PHP-V.VV.zip
  make tas3javapkg  # T3-SSO-ZXID-JAVA-V.VV.zip
  make tas3idppkg   # T3-IDP-ZXID-V.VV.zip
  make tas3rel      # build all of the above
  make tas3copyrel  # scp release packages

https://portal.tas3.eu/pool/        -- Download from here
http://idpdemo.tas3.eu/cot/         -- Register your metadata here
http://idpdemo.tas3.eu/zxididp?o=B  -- Publicly available TAS3 demo IdP

<<dia: tas3-integration,,:bg,fg,comp,api,zxmod:: API and modules for SSO and web service call.>>

--Sampo

T3-IDP-ZXID Install
-------------------

Prerequisite:: you must have CGI capable web server, such as mini_httpd, Apache, or IIS.

1.  Download and unzip the package

2.  ldd zxididp

3.  Copy zxididp to document root of your web server

      cp zxididp /srv/www/htdocs   # OpenSUSE 10.2

4.  Create directory hierarchy

      mkdir /var/zxid
      chown webuser /var/zxid
      su webuser
      zxmkdir.sh /var/zxid/idp
      ls -alFR /var/zxid

5.  Create configuration file /var/zxid/idpzxid.conf

      URL=http://idp.tas3.pt:8081/zxididp
      PDP_ENA=1

6.  Create a user

      mkdir /var/zxid/idpuid/koerkki
      echo -n salainen >/var/zxid/idpuid/koerkki/.pw
      
7.  Configure web server to run the zxididp as a CGI script.
    
    On Apache edit httpd.conf (often in /etc/apache2/httpd.conf)

      <Location "/zxididp">
      Options ExecCGI
      SetHandler cgi-script
      </Location>

8.  Test it

      tail -f /var/tmp/zxid.stderr
      tail -f /var/log/apache2/error_log

    http://idp.tas3.pt:8081/zxididp?o=B

T3-ZXID-SRC Compile and Install
-------------------------------

After unzipping the package, unpack the tarball contained therein, and
read INSTALL.zxid contained in the tarball.

Mapping between TAS3 API and ZXID API
-------------------------------------

* Use zxidjava/libzxidjni.so instead of tas3jni.so
* import zxidjava.*; instead of import tas3.*;
* System.loadLibrary("tas3jni.so");  should become           
  System.loadLibrary("zxidjava/libzxidjni.so");
* In class names replace "tas3" with "zxidjni", for example

    tas3.wsp_validate()

  becomes

    zxidjni.wsp_validate()

--Sampo