Configuring Visualizer to Use a Proxy Server

NOTE: If your computer is not behind a proxy server, you can skip this section and move onto the next section: Launching Kony Visualizer.

When your system is a part of an internal network and connects to the internet using a proxy server, you need to modify the Visualizer configuration settings to bypass proxy server and access internet.

You can use one of the following methods to configure Visualizer to use a proxy server:

• Basic Proxy: Provides steps to configure your basic proxy settings to allow Kony Visualizer access the Internet.
• NTLM Proxy: Provides steps to configure your proxy settings to allow Kony Visualizer access internet.
• Custom NTLM Proxy: Provides steps to customize and configure proxy settings to allow Kony Visualizer access internet.

Basic Proxy

For enabling Visualizer use a Basic proxy, follow these steps:

1. Navigate to the Kony Visualizer installation folder > Config folder (ex. /Applications/KonyVisualizer/Config).

2. Open the proxy_config.js file.
3. Edit the following details. between the comments "USER EDITIABLE SECTION START" and "USER EDITIABLE SECTION END":

   //To enable proxy, change the following value to true.
   var ENABLE_PROXY = false; 
   
   //Provide null value.
   var NTLM_DOMAIN = 'kvisualizer.com'; 
   
   //Provide Basic server port number.
   var PROXY_PORT = 8080; 
   
   //Provide your Username.
   var PROXY_USER = 'vizuser'; 
   
   //Provide your password.
   var PROXY_PWD = 'Welcome@1';
   
   //Change the value to PTYPE.BASIC_PROXY.
   var PROXY_TYPE = PTYPE.BASIC_PROXY; 

   NOTE: For proxy settings, check with your network administrator.

4. Save the Proxy_config.js file.

NTLM Proxy

To configure Visualizer to use an NTLM proxy, follow these steps:

1. Navigate to the Kony Visualizer installation folder > Config folder (ex. Applications/KonyVisualizer/Config).
2. Open the proxy_config.js file.

3. Edit the following details between the comments : "USER EDITABLE SECTION START" and "USER EDITABLE SECTION END":

   //USER EDITABLE SECTION START
    /*
   In case of NTLM custom config only PROXY_TYPE and CNTLM_PORT 
   ProxyConfig paramaters are required. Rest can be left undefined.
   Custom CNTLM config can also be generated by using cntlmconf.sh 
   on mac
    e.g.
   ./cntlmconf.sh -u NTLMUSER -d DOMAIN -s PROXY-IP:PROXY-PORT
   
    */
   //To enable proxy, change the following value to true.
   var ENABLE_PROXY = false; 
   
   //Provide Proxy IP address.
   var PROXY_IP = 'XXX.XXX.XXX.XXX'; 
   
   //Provide NTLM Domain address.
   var NTLM_DOMAIN = XXXXXXX.com'; 
   
   //Provide NTLM server port number.
   var PROXY_PORT = 8080; 
   
   //Provide your username.
   
   Note: Do not provide the domain name in the username. 
   
   For example, if your username is user@domain.com, 
   enter the username as user.
   
   var PROXY_USER = 'XXXXXX'; 
   
   //Provide your password.
   var PROXY_PWD = 'XXXXXX';
   
   /*If the type of proxy used is basic, replace NTLM_PROXY
    with BASIC_PROXY.
   *\
   var PROXY_TYPE = PTYPE.NTLM_PROXY;
   
   //USER EDITABLE SECTION END
   

4. Save the proxy_config.js file.

Custom NTLM Proxy

To configure Visualizer to use a custom NTLM proxy, follow these steps:

1. Navigate to the Kony Visualizer installation folder > Config folder (ex. Applications/KonyVisualizer/Config).
2. Open the proxy_config.js file.
3. Edit the following details between the USER EDITABLE SECTION START and USER EDITABLE SECTION END:

   //USER EDITABLE SECTION START
    /*
   In case of NTLM custom config only PROXY_TYPE and CNTLM_PORT ProxyConfig paramaters are 
   required. Rest can be left undefined.
   Custom CNTLM config can also be generated by using cntlmconf.sh on mac
    e.g.
   ./cntlmconf.sh -u NTLMUSER -d DOMAIN -s PROXY-IP:PROXY-PORT
   
    */
   //To enable proxy, change the following value to true.
   var ENABLE_PROXY = false; 
   
   //Type Proxy IP address.
   var PROXY_IP = 'XXX.XXX.XXX.XXX'; 
   
   //Type NTLM Domain name.
   var NTLM_DOMAIN = 'XXXXXXX.com'; 
   
   //Type NTLM server port number.
   var PROXY_PORT = 8080; 
   
   //Type your Username. Note: If your user name is user@domain.com, 
   then enter the username asuseronly. Domain name is not required. 
   var PROXY_USER = 'XXXXXX'; 
   
   //Type your password.
   var PROXY_PWD = 'XXXXXX';
   
   //If the type of proxy used is basic, replace NTLM_PROXY with BASIC_PROXY.
   var PROXY_TYPE = PTYPE.NTLM_PROXY;
   //Change the value to false
   var GENERATE_NTLM_CONF = false;
   //USER EDITABLE SECTION END
   

4. Save and close the proxy_config.js file.
5. Navigate to the Kony Visualizer installation folder > nw folder> nw-mac folder (ex. Applications/KonyVisualizer/nw/nw_mac).

   NOTE: For some NTLM v1 and v2 configurations, the default generated cntlm.conf file may not work. In such cases, you need to customize your proxy settings.

6. Open the cntlm.conf file.
7. Modify the following parameters:

   Username    my_proxy_user;
   Domain my_proxy_domain.com;
   Proxy my_proxy_server:8080;
   

8. Save and close the cntlm.conf file.
9. To generate the profile, follow these steps:
   1. Open a Command Prompt window in the current folder.
   2. Execute cntlm.exe -c cntlm.conf -I -M http://xxxx.com.
   3. Type your NTLM password, if requested, to generate a profile.
   4. Copy the generated profile.
10. Reopen th ecntlm.conf file.
11. Append the profile details (copied from step 9). A portion of the cntlm.conf file after appending the parameters is shown below:

    Username my_proxy_user
    Domain my_proxy_domain.com
    Proxy my_proxy_server:8080
    NoProxy localhost, 127.0.0.*, 10.*, 192.168.*
    Gateway no
    Listen 3128
    Auth NTLMv2
    PassNTLMv2 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
    

12. Save the cntlm.conf file.

13. Move the cntlm.conf file to User Profile folder/user name/Kony Visualizer/vizdata (for example, /Users/<User name>/Kony Visualizer/vizdata).