You are here: Administrator's Guide > Securing FME Server > Using FME Server with a Proxy Server

Using FME Server with a Proxy Server

A proxy server is a computer on your LAN that allows you to connect to external servers without compromising the security of your internal network. If you are consuming FME Server Web Services and your organization uses a proxy server on your network, you can configure FME Server to connect through the proxy.

1. Set Up the Proxy Server Connection

To connect FME Server to a proxy server, follow the appropriate set of instructions, depending on the Windows account that is running the FME Server System Services:

Note: To determine the account that is running the FME Server System Services, run services.msc. In the Services dialog, the account that is running any of the FME Server-related services is listed under Log On As.

2. Make the FME Engines Aware of the Proxy Server

  1. Run the Windows Command Prompt as administrator, and navigate to: $(FME_SERVER_HOME)\Server\fme
  2. Run the following commands:
  3. fme.exe APPLY_SETTINGS SYSTEM "Proxy/Proxy Setting" "Use System Proxy"

    fme.exe APPLY_SETTINGS SYSTEM "Proxy/Proxy Authentication Method" "<Basic|Digest|NTLM>"

    fme.exe APPLY_SETTINGS SYSTEM "Proxy/Proxy Server Require Authentication" "true"

    fme.exe APPLY_SETTINGS SYSTEM "Proxy/Proxy Username" "<UserName>"

    fme.exe APPLY_SETTINGS SYSTEM "Proxy/Proxy Password" "fme_encrypt(<password>)"

    Where:

    • <Basic|Digest|NTLM> is Basic, Digest, or NTLM, depending on the authentication method used by the proxy server. If not specified, Basic is assumed.
    • <UserName> is the user name for running the proxy server.
    • <password> is the password for the proxy server account.

3. Restart the FME Server Engines (Windows Service)

After configuring, restart the FME Server Engines (Windows Service). For more information, see Starting and Stopping FME Server Manually.

    Specifying Custom Proxy Maps

    You can specify custom proxy maps in addition to, or instead of, using the system proxy. A custom proxy map allows you to map access to specific URLs through an alternative proxy on your system. Use a custom proxy map if you need to bypass your network's default rules or system proxy settings in order to access these URLs.

    The following syntax specifies how to map access to one or more URLs through a custom proxy. Repeat all parameters for each URL, as shown:

    fme.exe APPLY_SETTINGS SYSTEM "Proxy/Custom Proxy Map" "<Source_URL>,<Proxy_URL>,<Proxy_Port>,<Requires_Authentication>,<UserName>,fme_encrypt(<Password>),<Authentication_Method>[,<Source_URL>,<Proxy_URL>,<Proxy_Port>,<Requires_Authentication>,<UserName>,fme_encrypt(<Password>),<Authentication_Method>]"

    Where:

    • <Source_URL> is the URL you want to access. The URL must be an exact match with the URL in the request; for example, http://www.lib.uwaterloo.ca/locations/umd/digitization_project/Roads_NTDB.zip.
    • <Proxy_URL> is the URL of the proxy server on your system that will handle requests to the <Source_URL>.
    • <Proxy_Port> is the port number on the proxy server through which requests are handled.
    • <Requires_Authentication> is true or false, depending on whether the proxy server requires authentication to access. If true, provide <UserName>, <Password>, and <Authentication_Method> (Basic, Digest, or NTLM).

    Other Notes

    To use a proxy server without authentication, instead specify:

    fme.exe APPLY_SETTINGS SYSTEM "Proxy/Proxy Server Require Authentication" "false"

    To stop using the proxy server, run:

    fme.exe APPLY_SETTINGS SYSTEM "Proxy/Proxy Setting" "No Proxy"