Add SAML SSO to a Genero Web application

Follow these steps to add SAML SSO to a Genero Web application.

This task must be performed in the .xcf application configuration file for the Genera Application Server.

Add the <DELEGATE service="SAMLServiceProvider"/> element to the application configuration (.xcf) file.

<?xml version="1.0"?>
<APPLICATION Parent="defaultgwc"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/3.10/cfextwa.xsd">
  <EXECUTION>
    <PATH>$(res.path.qa)/applications/myapp</PATH>
    <MODULE>App.42r</MODULE>
    <DELEGATE service="SAMLServiceProvider"/>
  </EXECUTION>
</APPLICATION>

With the above configuration and default JGAS configuration, the delegation points to the SAMLServiceProvider.xcf added to the Genero Archive (gar) file referencing the delegation REST Web service in the $FGLDIR.

For more information about the DELEGATE configuration element, see How to implement delegation.

The JGAS will handle the SAML protocol and start the Genero web application only when the user has been authenticated, otherwise an HTML error page is returned.