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>
  1. name specifies the group and name of the Genero REST service.
  2. All other child attributes are optional and, if present, are passed as parameters to the REST service using HTTP headers.
Important: Some Web servers convert all HTTP header names to lowercase. For example, a parameter called AnyParameter in the configuration, in the header may become:
x-fourjs-environment-parameter-anyparameter

Therefore, 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 OpenID Connect 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.

Parent elements