Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Maven coordinates for Shibboleth code artifacts can be found by browsing our Nexus release repository. Selecting a particular "jar" artifact will display the Maven dependency content required to insert. It's advisable to specify IdP or OpenSAML versions corresponding to the lowest minor version you need to support in your extension.

As multi-module projects, both OpenSAML and the IdP contain a large number of individual artifacts, and your dependencies will be directly to the specific API modules you need, not to the "whole" project. Per the Java Product Version Policy, you should not be establishing non-test dependencies on modules containing only implementation classes unless you're prepared to give up compatibility assumptions across versions. Implementation classes can change incompatibly, even in a simple patch.

...

To get the OpenSAML code, if necessary:

  1. Check out the OpenSAML project (see Source Code Access).

  2. Change to the opensaml-parent directory.

  3. Build and install the project using 'mvn -DskipTests -Dmaven.javadoc.disable=1 clean install'. If you want to include the unit testing or javadoc phases, adjust accordingly.

To get the Identity Provider code:

  1. Check out the Identity Provider project (see Source Code Access).

  2. Change to the idp-parent directory.

  3. Build and install the project using 'mvn -DskipTests -Dmaven.javadoc.disable=1 clean install'. If you want to include the unit testing or javadoc phases, adjust accordingly.

Now you can begin working with the project in whatever development environment you choose.

...

To get the OpenSAML code:

  1. Check out the OpenSAML project (see Source Code Access). Note, this "top-level" project isn't a Java project so it won't show up in the Package Explorer.

  2. In the Package Explorer right click and select Import -> Maven -> Existing Maven Project and select opensaml-parent as the root directory.

To get the Identity Provider code:

  1. Check out the Identity Provider project (see Source Code Access). Note, this "top-level" project isn't a Java project so it won't show up in the Package Explorer.

  2. In the Package Explorer right click and select Import -> Maven -> Existing Maven Project and select idp-parent as the root directory.

The java-idp-testbed project can also be checked out and imported, and it contains an Eclipse launch script to run the testbed as a Java application.

...