Service Provider Types: Proxy


The Proxy type of Service Provider is used for locally defined service provider endpoints.  Eg. when a Service Provider does not support SAML, OAuth, OpenIDConnect, WS Federation or other IDHub-supported protocols.

IDHub will act as an intermediary between user, IDP and SP, as demonstrated in the diagram below.

Sequence Diagram


Field Description
Display Name User defined name of the Service Provider
URL Not used
Description User defined description of the Service Provider
Authentication Scheme Defines which IDP(s) that can authenticate this user.
Type "Proxy Locations"
Location URL Path (after the hostname) that indicates where the Service Provider is located.  
Hostname Hostname of the server (if another server than the Admin Portal Server is used). Subdomain and domainname.  
If not provided, this server hostname is used.

Cross-domain support

Due to the nature of how cookies work, it is only possible to have a SSO between subdomains of the same primary domain. 

By default, the session cookie gets written to the current domain. If you want to enable SSO between subdomains, it is required to set an additional variable in the gateway configuration.

file: /opt/trustbuilder/gateway/instances/<instance_name>/conf/root.conf.d/00_secure_gw.conf

add line:

set $domain   '';

mind the dot preceding the domain name

It also advised to assign one subdomain to handle the login, for example ''.

file: /opt/trustbuilder/gateway/instances/<instance_name>/conf/root.conf.d/00_secure_gw.conf

edit line:

set $login_url   '';

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request



Please sign in to leave a comment.