Skip to main content
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Resolver Proxies

    To configure a resolver proxy profile, you must have the following role:
    • General System Administrator
    To enable off-campus users to access full text services at different vendor sites, you must define a proxy server, which is used to authenticate these users.

    The Alma Link Resolver responds to an incoming OpenURL and changes it to an electronic link by automatically including additional proxy information in the resolved URL. Some institutions use a single proxy server, in which case one proxy profile should be defined. If an institution uses several proxy servers, a proxy profile should be defined for each proxy server. You must then define the relevant proxy for each electronic collection, service, or portfolio.

    When distributing access to electronic resources through the Network Zone to members, proxies must be managed in the Institution Zone rather than the Network Zone. The Institution Zone proxy will override any proxy defined in a Network Zone collection.

    See the following for additional proxy information:

    Proxy Relationships

    The following table presents a description of the relationships between the proxy-enabled setting for electronic collections, services, and portfolios. Portfolios inherit the proxy-enabled setting from the service-level, proxy-enabled setting to which they are attached. As a result, you do not need to set a portfolio-level, proxy-enabled setting unless you want it to be something different from the service-level setting (in which case, you would leave the Proxy selected field on the service level blank). The electronic collection proxy-enabled settings are not inherited by portfolios.
    Proxy Relationships
    Proxy Enabled for Electronic Collection Level Proxy Enabled for Service Level Proxy Enabled for Portfolio Level Proxy Enabled Setting Results
    N N N Redirected to resource
    N N Y Redirected to proxy login
    N Y N Redirected to proxy login
    Portfolio inherits service setting
    N Y Y
    The electronic collection does not inherit proxy settings from the service or portfolios. If a proxy profile is selected on the service level, portfolios inherit the proxy setting from the service level. To set the proxy for the portfolio level, leave the Proxy selected field of the service-level setting blank.
    Y N N Redirected to the resource
    The Electronic Collection proxy is not inherited by the service or portfolio level
    Y N Y Redirected to proxy login
    Y Y N Redirected to proxy login
    Portfolio inherits the service setting
    Y Y Y Redirected to proxy login

    Configuring a Proxy

    To configure a resolver proxy definition type of integration profile:
    1. On the Integration Profile List page (Configuration Menu > General > External Systems > Integration Profiles), select Add Integration Profile. The first page of the integration profile wizard appears.

    2. Select Resolver Proxy for Integration Type.

    3. Enter a name (Code) for the profile you are defining and, optionally, enter a description.

    4. Select Default if you want the profile you are defining to be the default proxy definition profile. (If you previously defined another profile as the default profile, clear the Default selection in the other profile before selecting Default in this profile). If the proxy is set as the default, and Actions (see below) is set to Always, then this proxy is used for resolving any resource, even resources that do not have ProxyEnabled=Yes.

    5. Select Next. The second page of the wizard appears.


      Resolver Proxy Integration Profile – Step 2 (Proxy Definitions)
    6. Select the type of proxy server that you want to configure for this profile.

      There is no option to enter multiple IP addresses. The "Proxy IP" field should hold the proxy server IP address and not some allowed IP range. In case the OpenUrl request will come from this IP address, the proxy will not be added to the target Url, and this is to avoid looping. 

      The following options are available:

      • Biblio-Pam – This server proxy uses the following URL structure:

        The <Biblio-PAM URL> portion of the structure is the vendor-provided URL from Biblio-PAM.

        The <shortened target URL> is the target URL without the http:// or https://.

        • https://<Biblio-PAM URL>/http/<shortened target URL>

        • https://<Biblio-PAM URL>/https/<shortened target URL>

      • EZProxy – This option uses the following URL structure where $@ is the placeholder for the target URL:
        See EZProxy URL Database for more information.
      • HAN – This option uses the following URL structure:
        • http://<HAN server>/hanapi/?hash=<HASH>
        Enter the http://<HAN server> portion for the Proxy url parameter.
        The remainder of the URL structure is constructed by Alma and appended to the portion of the URL that you entered in the Proxy url parameter.
        For the HAN proxy server type, you need to enter a Salt parameter. The Salt parameter is a free text field that may contain any alpha-numeric value. The value that you enter must identically match the salt value in the HAN proxy server configuration in your HAN account. When you create the HAN salt value in your HAN account, copy it to the Salt parameter in Alma.
      • LIBProxy

      • OpenAthens - This option uses the following URL structure:

        "http://" + {base_url}+ "." + {PROXY_URL} + {URL_PARAMETERS};

        For example:

        Target_url =

        Proxy_url =

        Resulting URL:

      • OpenAthens Redirector – This option uses the following URL structure:
        • https://<OpenAthens Redirector URL>?url=<encoded target URL>
        The <OpenAthens Redirector URL> portion of the structure is the vendor-provided URL from OpenAthens.
        Enter<your domain> for the Proxy url parameter.
        The ?url= portion of the URL is added by Alma.
        The <encoded target URL> is the target URL in its encoded form.
        Note that even though Redirector is not a proxy server, the Alma proxy server configuration can be used.
      • WAM
        Note that you should omit the 0- at the beginning of your proxy URL.
    7. Enter the proxy URL as provided by the vendor (including http:// or https://) and the proxy IP address.

    8. Select one of the following values for Use Proxy:

      • Always – The proxy is used for any resolving.

        If this proxy is selected as default, it is used for any resolving, even for resources (services, collections, or portfolios) with EnableProxy=No.

        If this proxy is not selected as default, it is used for resources where EnableProxy=Yes and this proxy is selected.

        This configuration overrides the configuration in the Network Zone.
      • Never – This proxy is never used for resolving, even if it is enabled and selected for a particular resource.

      • Selective – This proxy is used for resources where EnableProxy=Yes and this proxy is selected (this is equivalent to selecting Always for a non-default proxy).

        Even if this proxy is selected as the default, it must be added to the resource explicitly.

    9. Select Save. The profile is saved.