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 group and 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). For examples of application configurations using Single sign-on (SSO), see the Single Sign-On User Guide

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 examples, see Configure OpenID Connect SSO log out or Configure SAML SSO log out pages in the Single Sign-On User Guide

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.

Parent elements

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