DELEGATE
The DELEGATE element specifies the Genero REST service in charge of
handling requests for access to applications.
Syntax
<DELEGATE service=name>
[<anyparameter1>any-value</anyparameter1>]
[<anyparameter2>any-value</anyparameter2>]
</DELEGATE>- name specifies the group and name of the Genero REST service.
- All other child attributes are optional and, if present, are passed as parameters to the REST service using HTTP headers.
AnyParameter in the configuration, in
the header may
become:x-fourjs-environment-parameter-anyparameterTherefore, it is not recommended to rely on case in the naming of parameters as there is no guarantee that it will be preserved. When working with HTTP headers in your Genero program code, make sure you allow for this by converting them to either upper or lower case.
Child elements
When working with a Single Sign-on (SSO) solution, child
elements of the DELEGATE element are specific to the identity provider (IdP). You
will need to add the appropriate tags to work with your IdP. These tags are documented by your
IdP.
Usage
You use this element to delegate the start of a Web application or a Web service to another Genero REST service in order to perform some controls before granting access and starting the application.
You may also use the element to configure the SSO log out options at the close of the application with, for example, redirection to a logout URL. However, this will depend on how fully your IdP follows the standard logout protocol, which varies depending on the IdP. For configuration examples see Configure SSO log out and Configure SAML SSO log out.
The Genero Application Server dispatcher passes the request to the REST service identified as the delegation service if the type of request is defined by the /ua/r or /ws/r path segments in the application URI. See How to implement delegation.