The included projects are for the purpose of autheticating with Atlassian's Jira and Confluence. These projects are largely based on work from the public onelogin github repo java-saml. For details on how to work with SAML and onelogin in general please refer to that project. Documentation for setting up a particular Atlassian project is included in each are of this repo. That is to say documentation for setting up and configuring Confluence is in the confluence directory. Documentation for Jira is in the Jira directories.
OneLogin will review and test changes proposed by the opensource community on a qarterly basis.
These projects are written in Java and the builds are based on Maven. Requirements for building include:
- A current version of Java
- A current version of Maven. (For details on Maven see https://maven.apache.org/.)
Builds have been tested with Java version 1.8.0_60 and Maven 3.3.3. The version of Java you choose to build with will be dependent on the requirements of your use case.
To build one of the Atlassian projects:
- Sync to the latest of onlogin/atlassian
- cd to the project you would like to build. For example confluence/version4
- run 'mvn clean install'
The build for confluence version4 may require you to add the customauth-conf jar file to your local maven repo. To do so run the following command from the version4 directory 'mvn install:install-file -Dfile=customauth-conf-0.4.jar -DgroupId=com.onelogin -DartifactId=customauth-conf -Dversion=0.4 -Dpackaging=jar'
The build for Jira version4 may require that you add the customauth-jira jar file to your local maven repo. To do so run the following command from the jira/version4 directory 'mvn install:install-file -Dfile=customauth-jira-0.4.jar -DgroupId=com.onelogin -DartifactId=customauth-jira -Dversion=0.4 -Dpackaging=jar'
The build for Jira version6 has an additional dependency, the latest OneLogin java-saml jar (java-saml-1.1.2.jar), from the onelogin/java-saml project on GitHub. So for building Jira version6 the steps are:
- Sync onelogin/java-saml
- Build onelogin/java-saml (it's also a Maven/Java project).
- Run 'mvn clean install' to place the java-saml-1.1.2.jar in your local Maven repository
- Next pull the lastest from onelogin/atlassian and run 'mvn install' from version6 to bulid your Jira version6 artifacts as above.