Bug 794362 (JBEPP-1406)

project_key: JBEPP

Looking at http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platform/5.2/html-single/Reference_Guide/index.html#sect-Reference_Guide-SSO_Single_Sign_On_ I am seeing these problems in SSO section.

1) I think that all things related to OpenSSO should be all in one section (in similar way like it is for CAS and JOSSO). Right now, they are divided into more sections:
17.7.5. OpenSSO
17.7.6. Modifying the OpenSSO server
17.7.7. Setup the OpenSSO Client
17.7.8. Setup the portal to redirect to OpenSSO

These all should be in one section "OpenSSO", which should be 17.7.5 . following section 17.7.6 should be about SPNEGO. See current GateIn reference guide how it is here right now.





2) SPNEGO part

2.1) Section "Clients" is duplicated. See section "17.7.9.2 Clients" and "17.7.9.4 Clients". I think that section 17.7.9.4 should be removed.

2.2) 17.7.9.3. JBoss Enterprise Portal Platform Configuration - All the paths and configuration files for SPNEGO section of EPP reference guide should be updated from GateIn reference guide. This is not the case right now. It seems that some sections (especially configuration files) were not correctly merged from GateIn documentation from commit https://source.jboss.org/viewrep/GateIn/portal/trunk/docs/reference-guide/en-US/modules/AuthenticationAndIdentity/SSO.xml?r1=8015&r2=8017 .

I am seeing it can be because in GateIn reference guide are all configuration files aded directly to SSO.xml documentation source file, where in EPP documentation it points to external files (like ../../extras/Authentication_Identity_SSO/default125.xml ). Things which should be updated from GateIn docs are:

2.2.1) deployers/jbossweb.deployer/META-INF/war-deployers-jboss-beans.xml configuration file in step 2 of "Procedure 17.21. Advanced SPNEGO Configuration"

2.2.2) deploy/gatein.ear/META-INF/gatein-jboss-beans.xml in step 4 of "Procedure 17.21. Advanced SPNEGO Configuration"

2.2.3) gatein.ear/02portal.war/WEB-INF/web.xml - Both part with authentication and part with HTTP filters are not correct in EPP docs. There is also some text missing in comparison to GateIn docs (about possibility to enable/disable fallback to FORM authentication)

2.2.4) In EPP startup command (Step 7) should be "-c default" instead of "-c spnego" as previous steps are editing configuration files in default configuration. 

It seems that some Paths to configuration files were also not updated correctly from GateIn docs in Spnego section. Please check GateIn reference guide and update paths according to it if possible.