DELEGATE

The DELEGATE element specifies the Genero REST service the initial /ua/r or /ws/r request is forwarded to, in order to perform additional verification before starting the application or service.

Syntax

<DELEGATE service=name>
  [<anyparameter1>any-value</anyparameter1>]
  [<anyparameter2>any-value</anyparameter2>]
</DELEGATE>
  1. The service attribute must specify in the name the name of the Genero REST service in charge of handling requests for access to applications.
  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. The DELEGATE element is used for all Genero Web applications requiring Single sign-on (SSO).

The JGAS 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.

Parent elements

This element is a child of one of the following elements: