Use a Proxy Server

If your network configuration uses a proxy server, you can configure Kony Visualizer to recognize it, whether it is a Basic or NTLM proxy. If yours is an NTLM proxy server, you must follow the procedures for both the Basic proxy and the NTLM proxy.

Basic Proxy Configuration

NTLM Proxy Configuration

Basic Proxy Configuration

Configuring Kony Visualizer to recognize a Basic proxy server involves the following procedures:

Add Proxy Information to the Eclipse Initialization File

Configure the Proxy Server in Kony Visualizer

Configure a Manual Proxy for Your Computer

Add Proxy Information to the Eclipse Initialization File

Kony Visualizer uses Eclipse, an open-source integrated development environment (IDE), for some of its underlying functionality. To use Kony Visualizer with a proxy server, you need to modify the Eclipse initialization file.

To add proxy information to the Eclipse initialization file, do the following:

1. If it is currently open, close Kony Visualizer.
2. Using your computer's file explorer, navigate to the Eclipse initialization file.
• On the Mac, the file name is eclipse-orig.ini. It is located within the Eclipse.app folder, and can be accessed using the Show Package Contents command.
  You can access the eclipse.ini file by doing the following:
  a. Navigate to the Kony Visualizer Enterprise installation path.
  b.Right click Kony_Visualizer-Enterpries and select Show Package Contents.
  c. Navigate to Content > MACOS. Open the eclipse.ini in a text editor.
  
• On a Windows computer, the file name is eclipse.ini, and is located at the following location:

<VisualizerEnterpriseInstallFolder>\_Kony Visualizer_installation

3. Using a text editor, open the Eclipse initialization file.
4. Add the following entries to the file:

-Dkony.http.proxyHost=xxx.xxx.xxx.xxx
-Dkony.http.proxyPort=xxxx
-Dkony.http.proxyUser=xxxxxx
-Dkony.http.proxyPassword=xxxxxx
-Dkony.noProxy=xxx.x.x.x

Important: Configure Dkony.noProxy only if you want to bypass the proxy for the localhost domain.

For example:

-Dkony.http.proxyHost=10.0.0.100/host.example.com
-Dkony.http.proxyPort=8880
-Dkony.http.proxyUser=HannahSmith
-Dkony.http.proxyPassword=3y*ANjScw8BH
-Dkony.noProxy=127.0.0.1,localhost

Important: For an NTLM proxy server, use the following values for the proxyHost and the proxyPort:
-Dkony.http.proxyHost=127.0.0.1
-Dkony.http.proxyPort=3128


5. Save and close the file.
6. Restart Kony Visualizer.

Configure the Proxy Server in Kony Visualizer

The following procedure configures Kony Visualizer to recognize the proxy server.

To configure the proxy server in Kony Visualizer, do the following:

1. In Kony Visualizer, on the Window menu, click Preferences.
2. From the left pane of the dialog box, double-click General, and then click Network Connections. Doing so displays the Network Connections options in the right pane.
3. Set Active Provider to Manual.
4. In the Proxy entries table, select the HTTP schema, and then click Edit.
5. In the Host text box, enter the proxyHost value that you added to the Eclipse configuration file.

Important: For an NTLM proxy server, the Host value should be 127.0.0.1.

6. In the Port text box, enter the proxyPort value that you added to the Eclipse configuration file.

Important: For an NTLM proxy server, the Port value should be 3128.

7. Click OK.

Configure a Manual Proxy for Your Computer

In addition to configuring Eclipse and Kony Visualizer to recognize the proxy server, your operating system needs to be configured, as well. Doing so differs between Mac and Windows computers.

Configure a Manual Proxy for a Mac

Configure a Manual Proxy for Windows

Configure a Manual Proxy for a Mac

To configure a manual proxy for a Mac, do the following:

1. Click the Apple menu, next click System Preferences, and then click Network.
2. From the list, select the network service you are using, such as Wi-Fi or Ethernet.
3. Click Advanced, and then click Proxies.
4. From the Select a protocol to configure list, clear the check box for Auto Proxy Discovery and Automatic Proxy Configuration.
5. From the Select a protocol to configure list, check the check box for Web Proxy (HTTP).
6. With Web Proxy (HTTP) selected, in the Web Proxy Server text box, enter the proxyHost value that you added to the Eclipse configuration file.

Important: For an NTLM proxy server, the Web Proxy Server value should be 127.0.0.1.

7. In the accompanying port text box, enter the proxyPort value that you added to the Eclipse configuration file.

Important: For an NTLM proxy server, the Port value should be 3128.

8. Repeat steps 5 through 7 for the Secure Web Proxy (HTTPS) protocol and the FTP Proxy protocol.
9. Check the Exclude simple host names check box.
10. Click OK.

Configure a Manual Proxy for Windows

To configure a manual proxy for Windows, do the following:

1. Click the Start menu, and then click Settings (for Windows 10) or Control Panel (for Windows 7 and earlier).
2. In the search box, type Internet options, and then press Enter.
3. From the search results, click Internet options. Doing so brings up the Internet Properties dialog box.
4. Click the Connections tab, and then click LAN Settings.



5. Clear the Automatically detect settings check box.
6. Under Proxy server, check the check box for using a proxy server for your LAN.
7. In the Address text box, enter the proxyHost value that you added to the Eclipse configuration file.

Important: For an NTLM proxy server, the Address value should be 127.0.0.1.

8. In the Port text box, enter the proxyPort value that you added to the Eclipse configuration file.

Important: For an NTLM proxy server, the Port value should be 3128.

9. Check the check box for Bypass proxy server for local addresses.

Your settings should look something like this (settings shown are for an NTLM proxy server):



10. Click OK, and then click OK again.

NTLM Proxy Configuration

To configure Kony Visualizer to recognize an NTLM proxy server, you must follow all the procedures related to both the Basic proxy and the NTLM proxy. If you have not yet followed the procedures for a Basic proxy, see Basic Proxy Configuration. Once you have done so, completing the NTLM proxy configuration involves two additional tasks.

Run a Cntlm Process

Allow CONNECT Requests from Non-SSL Connections and Ports

White-List Essential Domains

Run a Cntlm Process

Cntlm is an HTTP proxy that efficiently provides NTLM authentication on the fly. Cntlm integrates TCP/IP port forwarding, SOCKS5 proxy mode, and standalone proxy configuration to allow intranet, Internet, and corporate web server access with NTLM protection.

You run the Cntlm process configured with the proper NTLM host and port information, and any additional needed authentication data.

For more information, refer to the following links:

The Cntlm Authentication Proxy web site

Download Cntlm

Cntlm Documentation

Allow CONNECT Requests from Non-SSL Connections and Ports

By default, proxies such as Squid and ISA do not allow http CONNECT requests from non-SSL connections and ports it deems unsafe. As a result, the proxy server has to be explicitly configured to allow such connections and ports. To do so, contact your system administrator and request that CONNECT requests from non-SSL connections and ports be allowed.

White-List Essential Domains

Kony Visualizer access particular domains that the proxy server must be configured to allow. Contact your system administrator and request that the following domains be white-listed:

https://manage.kony.com
https://api.kony.com
https://visualization.kony.com
https://prototypetransit.kony.com.s3.amazonaws.com
https://accounts.auth.konycloud.com

 

 

 

 

Rev	Author	Edits
7.2	NMK	NMK

Copyright © 2013 Kony, Inc. All rights reserved.