5 Step Start

From OpenLiberty.org Wiki
Jump to: navigation, search

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 
 

   

Contents

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.

OpenAz