Configuring Adeptia Suite behind Reverse Proxy/Load Balancer

Owned by Saurabh Gupta (Unlicensed)
Last updated: Jun 07, 2023 by Shruti Pasayat
1 min read

You can deploy SAML in scenarios where multiple Service Providers process SAML requests forwarded by a reverse-proxy or a load balancer. In order to configure SAML for deployment behind load balancer or reverse-proxy, please follow the below steps:

  1. Go to the .../<AdeptiaInstalledFolder>AdeptiaServer/ServerKernel/etc/saml.
  2. Open saml.properties in text editor.

  3. Set the IP address or domain name of Load Balancer as a value for the property SAML_SSO_METADATA_GENERATOR_ENTITY_BASE_URL in the following format:

    <protocol_name>://<IP_address_or_domain_name>/adeptia

    Where,

    <protocol_name> is the name of the protocol. For example, http or https.

    <ip_address or domain_name> is the IP address or domain name of the load balancer.

    For example, http://www.myserver.com

  4. Set the values for the following reverse-proxy/load balancer properties in the saml.properties file.

    Property Name
    		Example value
    Description
    SAML_SSO_CONTEXT_PROVIDER_LB_SCHEMEhttpName of the scheme (http or https).
    SAML_SSO_CONTEXT_PROVIDER_LB_SERVER_NAMEwww.myserver.comName of the server.
    SAML_SSO_CONTEXT_PROVIDER_LB_SERVER_PORT8080Port number of the server.
    SAML_SSO_CONTEXT_PROVIDER_LB_INCLUDE_SERVER_PORT_IN_REQUEST_URLfalseWhether to include server port number in the URL or not. It must be false.
    SAML_SSO_CONTEXT_PROVIDER_LB_CONTEXT_PATH/adeptiaPrefix of a URL path used to select the context(s) to which an incoming request is passed. A URL is in the format: http://hostname.com/contextPath/, where each of the path elements can be zero or more separated elements. It must be /adeptia.


  5. Save the file.