README.txt
This enables SSO for JIRA/Confluence and other apps utlizing Atlassian Seraph.
Install:
- Copy the OpenAM client sdk to atlassian-jira/WEB-INF/lib/
- Create/copy an AMConfig.properties to atlassian-jira/WEB-INF/classes/ (or somewhere in the classpath)
- Copy this projects jar to atlassian-jira/WEB-INF/lib/
- edit atlassian-jira/WEB-INF/classes/seraph-config.xml:
login.url
http://yourlogin.yourdomain.com/openam/UI/Login?goto=${originalurl}
link.login.url
http://yourlogin.yourdomain.com/openam/UI/Login?goto=${originalurl}
logout.url
http://yourlogin.yourdomain.com/openam/UI/Logout
In older versions of Jira comment out this line
<!-- COMMENT OUT THIS LINE authenticator class="com.atlassian.seraph.auth.DefaultAuthenticator"/-->
In newer versions of Jira you will need to comment out this line:
<!--
<authenticator class="com.atlassian.crowd.integration.seraph.JIRAAuthenticator"/>
-->
For very old versions of Jira, add this line.
For recent versions of Jira, add this line.
You will need to restart JIRA for changes to take effect.
- You will need to do one of two things:
1) If you have a public JIRA, you're done. Although you will still see the login form so you
may want to remove that template.
2) If you have a private JIRA and always to be redirected to SSO - see no login form/links -
add to atlassian-jira/WEB-INF/classes/seraph-paths.xml:
/*
user
Confluence 3.0+:
Installation is much the same for Confluence.
Install:
- Copy the OpenAM client sdk to atlassian-confluence/WEB-INF/lib/
- Create/copy an AMConfig.properties to atlassian-confluence/WEB-INF/classes/ (or somewhere in the classpath)
- Copy this projects jar to atlassian-confluence/WEB-INF/lib/
- edit atlassian-confluence/WEB-INF/classes/seraph-config.xml:
Update the login.url, link.login.url and logout.url parameters as before.
Comment out this line.
<!-- <authenticator class="com.atlassian.confluence.user.ConfluenceAuthenticator"/> -->
replace with this:
You will need to restart Confluence for changes to take effect.
- Use com.sun.identity.provider.seraph.OpenSsoConfluenceAuthenticator
- Thanks to Casey.BUTTERWORTH at suncorp.com.au
* https://opensso.dev.java.net/servlets/ReadMsg?listName=users&msgNo=11574
Build:
- Use maven 2.x