= Proxy =
[[PageOutline]]

Proxy is a project that consists of a few sub-projects that deal with authentication issues. The central sub-project is the !SimpleProxyLib, which is used by all the other modules.

!SimpleProxyLib is a library I put together after I wrote [http://grix.vpac.org grix]. It's value is not really as a library but as a collection of code that shows how to deal with x509/certificate/proxy related stuff in a grid environment. So, if you need to create a local proxy in your code or you need to get a delegated proxy from a !MyProxy server or you have to deal with voms within your (java) application !SimpleProxyLib might be of interest for you. I wrote it because I found it really hard to figure out all this stuff or to find documentation and thought it would be good to have a kind of "example code" repository.

== swiss-proxy-knife ==

The swiss-proxy-knife is a tool that allows you to do all kinds of proxy operations from the commandline: 

 * create a local proxy
 * get a delegated !MyProxy
 * get a slcs-certificate
 * convert any of the above to a voms-proxy
 * delegate a proxy to !MyProxy
 * store a proxy to the default location on your desktop computer

For more infomation, have a look here: SwissProxyKnife

== How to build it from source == 

{{{
# check out the source code using subversion
svn co https://projects.arcs.org.au/svn/grix/trunk/proxy

# change into the root directory
cd proxy

# build it:

mvn clean
mvn -Dmaven.test.skip=true install

# now, let's package it up...
mvn package assembly:assembly
}}}

If you use the package in one of your projects, you'll also need to include the bouncy-castle security provider in the classpath.

== Import the project into Eclipse ==

=== Requirements ===

 * Eclipse (preferable version >= 3.4
 * svn plugin (I'm using subclipse)
 * m2eclipse plugin (maven plugin for eclipse)
 * groovy plugin for eclipse (optional. For swiss-proxy-knife project)

=== How to import the project ===

 1. File -> Import -> Maven -> Check out Maven Projects from SCM -> Next
 2. SCM URL: svn https://projects.arcs.org.au/svn/grix/trunk -> Next
 3. Finish

Optional from here on (only if you want to build the swiss-proxy-knife project):
 4. Right-click swiss-proxy-knife project. Build Path -> Configure Build Path...
 5. Source tab: Add folder -> Select swiss-proxy-knife/src/main/groovy -> OK
 6. Source tab: Default output folder -> "swiss-proxy-knife/bin-groovy" -> OK -> Yes