Configuring Proxy Connections

You can configure the connector to connect through a proxy server instead of connecting directly to the Spark service. When connecting through a proxy server, the connector supports basic authentication.

You provide the configuration information to the connector in the connection URL. For more information about the syntax of the connection URL, see Building the Connection URL .

To configure a proxy connection:

1. Set the UseProxy property to 1.
2. Set the ProxyHost property to the IP address or host name of your proxy server.
3. Set the ProxyPort property to the port that the proxy server uses to listen for client connections.
4. Optionally, set the ProxyIgnoreList property to a comma separated hostname.
5. For authentication with the proxy server:
   1. Using basic authentication:

      1. Set the ProxyAuth property to 1.
      2. Set the ProxyUID property to your user name for accessing the server.
      3. Set the ProxyPWD property to your password for accessing the server.

   2. Using proxy Kerberos authentication:

      1. Set the ProxyAuth property to 2.
      2. Optionally, set the ProxyKrbRealm property to your Kerberos realm.
      3. Optionally,Set the ProxyKrbHostFQDN property to the fully qualified domain name (FQDN) of your proxy server.
      4. Optionally, Set the ProxyKrbServiceName property to your Kerberos service name.
      5. Use KRB5_CONFIG environment variable to point to Kerberos configuration file. Alternatively, you can use the java system property java.security.krb5.conf to set the path to the Kerberos configuration file.

      Example using proxy Kerberos authentication:

      jdbc:databricks://[Host]:[Port];AuthMech=3;transportMode=http;httpPath=cliservice;UID=token;PWD=simba123;UseProxy=1;ProxyHost=kdc.databricks.com;ProxyPort=3128;ProxyAuth=2;ProxyKrbREALM=DATABRICKS.COM;