5 Step Start
Here you will find the instructions needed to get the Alpha code of the ID-WSF 2.0 ClientLib running and available on your machine, in 5 simple steps. Once you have gone through the Quick Start, you will be able to Authenticate with Conor Cahill's ID-WSF 2.0 Server and make Discovery Requests.
FOLLOW THE INSTRUCTIONS IN THE GRAY BOXES
STEP 1: Requirements
- A machine running Java 1.5 (Mac OS X, Linux, Unix, or MS Windows)
- eclipse IDE 3.2 or 3.3 (or NetBeans 6.0, or any other Java IDE that you are comfortable with, however, this documentation will assume eclipse)
- Subversion (in addition Subclipse, a nice GUI interface to subversion that runs in eclipse is helpful)
- Experience with Java Development
STEP 2: Get The OpenSAML Java Libraries
The ClientLib uses OpenSAML's Java XML Tooling, SOAP, and SAML2 Libraries. Source Access You may check the code out using subversion (svn) in a terminal if you are using a Mac OS X, Linux, or other Unix platform. Here we are checking the code out into the /mytemporaryprojectfolder folder.
$ cd /mytemporaryprojectfolder $ svn co https://svn.middleware.georgetown.edu/java-xmltooling/trunk java-xmltooling $ svn co https://svn.middleware.georgetown.edu/java-openws/trunk java-openws $ svn co https://svn.middleware.georgetown.edu/java-opensaml2/trunk java-opensaml2
STEP 3: Get The ClientLib
ClientLib Source Code is hosted on Sourceforge. You will not need an account to check the code out. However, if you wish to contribute, you will need an account, and you will need to contact me to be added as a developer (asa dot openliberty at zenn dot net). You may check the code out using subversion (svn) in a terminal if you are using a Mac OS X, Linux, or other Unix platform. Here we are checking the code out into the /mytemporaryprojectfolder folder.
$ cd /mytemporaryprojectfolder $ svn co https://openliberty.svn.sourceforge.net/svnroot/openliberty/ID_WSF_2_0/wsc/trunk/ openliberty
STEP 4: Import Into Eclipse (or your IDE)
Now you must bring the OpenSAML and openLiberty projects into your IDE workspace. Once done you may need to Configure the build path of the openLiberty project to include the 3 OpenSAML projects.
Import projects using eclipse:
1. File Import.. 2. select "General > Existing Projects into Workspace" 3. click the next button 4. select the projects 5. click finish
FINAL STEP: Run an Authentication and Discovery Test
Once you've dealt with all of your classpath issues ;) you are ready to run a test that runs through some Authentication Service (AS) queries, extracts a Discovery Endpoint Reference and and then makes a series of Discovery Service (DS) queries. This will be fun! All of the tests are live and connect to Conor Cahill's ID-WSF 2.0 WSP.
1. In eclipse navigate to the org.openliberty.wsc.test package 2. right click (or ctrl click) on ClientLibTest 3. select 'Run As' > 'JUnit Test'
NOTE: OpenSAML requires JAXP 1.3 and DOM3
You may need to endorse Xerces and Xalan. Do this by copying the jars from the java-xmltooling/thirdparty-lib xerces and xalan folders into your <java-home>/lib/endorsed folder. Sun documents this process as the Endorsed Standards Override Mechanism.