NetScaler 9000 Series

Transcription

1 NetScaler 9000 Series SSL VPN User s Guide for Windows platform only 180 Baytech Drive San Jose, CA Phone: , Fax: NetScaler Part No.:NSVPNUG60 Printed: January 2005

2 NETSCALER, INC., ALL RIGHTS RESERVED. NO PART OF THIS DOCUMENT MAY BE REPRODUCED OR TRANSMITTED IN ANY FORM OR BY ANY MEANS OR USED TO MAKE DERIVATIVE WORK (SUCH AS TRANSLATION, TRANSFORMATION, OR ADAPTATION) WITHOUT THE EXPRESS WRITTEN PERMISSION OF NETSCALER, INC. ALTHOUGH THE MATERIAL PRESENTED IN THIS DOCUMENT IS BELIEVED TO BE ACCURATE, IT IS PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE ALL RESPONSIBILITY FOR THE USE OR APPLICATION OF THE PRODUCT(S) DESCRIBED IN THIS MANUAL. NETSCALER, INC. OR ITS SUPPLIERS DO NOT ASSUME ANY LIABILITY THAT MAY OCCUR DUE TO THE USE OR APPLICATION OF THE PRODUCT(S) DESCRIBED IN THIS DOCUMENT. INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT NOTICE. COMPANIES, NAMES, AND DATA USED IN EXAMPLES ARE FICTITIOUS UNLESS OTHERWISE NOTED. The following information is for FCC compliance of Class A devices: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio-frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference, in which case users will be required to correct the interference at their own expense. Modifying the equipment without NetScaler s written authorization may result in the equipment no longer complying with FCC requirements for Class A digital devices. In that event, your right to use the equipment may be limited by FCC regulations, and you may be required to correct any interference to radio or television communications at your own expense. You can determine whether your equipment is causing interference by turning it off. If the interference stops, it was probably caused by the NetScaler 9000 Series equipment. If the NetScaler equipment causes interference, try to correct the interference by using one or more of the following measures: Move the NetScaler equipment to one side or the other of your equipment. Move the NetScaler equipment farther away from your equipment. Plug the NetScaler equipment into an outlet on a different circuit from your equipment. (Make sure the NetScaler equipment and your equipment are on circuits controlled by different circuit breakers or fuses.) Modifications to this product not authorized by NetScaler, Inc., could void the FCC approval and negate your authority to operate the product. BroadCom is a registered trademark of BroadCom Corporation. Fast Ramp, NetScaler, and NetScaler Request Switch are trademarks of NetScaler, Inc. Linux is a registered trademark of Linus Torvalds. Internet Explorer, Microsoft, PowerPoint, Windows and Windows product names such as Windows NT are trademarks or registered trademarks of the Microsoft Corporation. NetScape is a registered trademark of Netscape Communications Corporation. Red Hat is a trademark of Red Hat, Inc. Sun and Sun Microsystems are registered trademarks of Sun Microsystems, Inc. Other brand and product names may be registered trademarks or trademarks of their respective holders. Software covered by the following third party copyrights may be included with this product and will also be subject to the software license agreement: Copyright 1998 Carnegie Mellon University. All rights reserved. Copyright David L. Mills 1993, Copyright 1992, 1993, 1994, 1997 Henry Spencer. Copyright Jean-loup Gailly and Mark Adler. Copyright 1999, 2000 by Jef Poskanzer. All rights reserved. Copyright Markus Friedl, Theo de Raadt, Niels Provos, Dug Song, Aaron Campbell, Damien Miller, Kevin Steves. All rights reserved. Copyright 1982, 1985, 1986, , 1993 Regents of the University of California. All rights reserved. Copyright 1995 Tatu Ylonen, Espoo, Finland. All rights reserved. Copyright UNIX System Laboratories, Inc. Copyright 2001 Mark R V Murray. Copyright Eric Young. Copyright 1995,1996,1997,1998. Lars Fenneberg. Copyright Livingston Enterprises, Inc. Copyright 1992, 1993, 1994, The Regents of the University of Michigan and Merit Network, Inc. Copyright , RSA Data Security, Inc. Created Copyright 1998 Juniper Networks, Inc. All rights reserved. Copyright 2001, 2002 Networks Associates Technology, Inc. All rights reserved. Copyright (c) 2002 Networks Associates Technology, Inc. Copyright The Open LDAP Foundation. All Rights Reserved. Copyright 1999 Andrzej Bialecki. All rights reserved. Copyright 2000 The Apache Software Foundation. All rights reserved. Copyright (C) Robert A. van Engelen, Genivia inc. All Rights Reserved.

3 Contents Chapter 1 : NetScaler SSL VPN Overview NetScaler SSL VPN : Architecture NetScaler SSL VPN : Key Features Chapter 2 : Getting Started with NetScaler SSL VPN System Requirements Starting a NetScaler SSL VPN Session Using the SSL VPN Browser Plug-in Accessing Services 8 Using Portal Tools The Ping Tool The Tip and Help Tools Using Bookmarks 10 Accessing a Remote File System Top Panel Left Panel Right Panel Configuring the SSL VPN Browser Plug-in General Tab Tunnel Tab Compression Tab About Tab Accessing Help 23 Terminating the SSL VPN Session 23 Chapter 3 : Using Advanced Plug-in Features Forward Proxy Support Client Computer Security Check Windows Client Cleanup Windows Client Cleanup Dialog 4 Client Cleanup Item Listing Dialog 6 Chapter 4 : Troubleshooting the SSL VPN Browser Plug-in Debugging the SSL VPN Browser Plug-in NetScaler SSL VPN Session Error Codes Limitations NetScaler 9000 Series SSL VPN User s Guide i

4 5 : FAQs Appendix A Uninstalling the SSL VPN Browser Plug-in ii NetScaler 9000 Series SSL VPN User s Guide

5 1 : NetScaler SSL VPN Overview Chapter 1 NetScaler SSL VPN Overview The NetScaler SSL VPN is a secure remote access solution that provides point-to-point communication between remote users, such as mobile employees, partners, or resellers, and a private enterprise network. It does so by creating a secure SSL-based tunnel between a user s computer and the NetScaler 9000 system. This allows authorized remote users to gain access to critical business resources such as corporate intranets, shared file systems, native client/server applications, and terminal services. This chapter provides an overview of the NetScaler SSL VPN features. The following topics are described in this chapter: NetScaler SSL VPN : Architecture NetScaler SSL VPN : Key Features NetScaler 9000 Series SSL VPN User s Guide 1-1

6 1 : NetScaler SSL VPN Overview 1.0 NetScaler SSL VPN : Architecture When you log on to a Web site that is secured by the NetScaler SSL VPN, the NetScaler system instructs Internet Explorer to download the SSL VPN browser plug-in onto your computer. This plug-in is an ActiveX control that creates a secure channel of communication between your browser and the NetScaler system, and allows you to remotely access those resources you are authorized to use. Once the SSL VPN browser plug-in is downloaded, you will be prompted to permit it to execute. The plug-in will monitor network activity. When a TCP or UDP application, like Telnet or Microsoft Outlook, connects to a server in the company's private network, the plug-in will intercept the connection, secure it using SSL, and redirect it to the server via the NetScaler SSL VPN. The NetScaler system then reconnects the application to the server. The routing decision is made based on the routes configured in the NetScaler 9000 system. This is illustrated in the following figure. Figure 1 Interception of the SSL VPN browser plug-in As shown in Figure 1, the plug-in inserts itself between the application layer and the kernel. It connects to the NetScaler SSL VPN device using an SSL-encrypted connection. 1-2 NetScaler 9000 Series SSL VPN User s Guide

7 1 : NetScaler SSL VPN Overview 2.0 NetScaler SSL VPN : Key Features The NetScaler SSL VPN supports: SSL 2.0, SSL 3.0, and TLS 1.0 protocols 1024 bit encryption All TCP/UDP-based applications CIFS file system access through NetBios/Web Interface Client computer security check, whereby the SSL VPN browser plug-in ensures that certain personal firewalls and antivirus applications are running on the client computer Forward proxy and proxy authentication support Deletion of cached Internet files generated on a Windows client, after an SSL VPN session NetScaler 9000 Series SSL VPN User s Guide 1-3

8 1 : NetScaler SSL VPN Overview 1-4 NetScaler 9000 Series SSL VPN User s Guide

9 2 : Getting Started with NetScaler SSL VPN Chapter 2 Getting Started with NetScaler SSL VPN The preceding chapter covered the architectural details of the SSL VPN browser plug-in. In this chapter you will learn to use the plug-in. This chapter begins with a brief introduction to the system requirements for the plug-in. This is followed by detailed instructions on downloading and running the plug-in. The final section covers the various controls of the user interface. The following topics are described in this chapter: System Requirements Starting a NetScaler SSL VPN Session Using the SSL VPN Browser Plug-in NetScaler 9000 Series SSL VPN User s Guide 2-1

10 2 : Getting Started with NetScaler SSL VPN 1.0 System Requirements The system requirements for the SSL VPN browser plug-in are: Operating system: MS Windows 98, Windows 2000, Windows NT, Windows ME, Windows XP, or Windows 2003 Server. Web browser: Internet Explorer 5.5 and above. Note The Windows version of the plug-in does not support LINUX or Mac OS. When using the NetScaler SSL VPN with these platforms, your computer will automatically download and install the multi-platform version of the plug-in. For details on using the SSL VPN with these platforms, refer to the SSL VPN Users Guide for Windows, LINUX, Mac OS, and UNIX Platforms. 2-2 NetScaler 9000 Series SSL VPN User s Guide

11 2 : Getting Started with NetScaler SSL VPN 2.0 Starting a NetScaler SSL VPN Session As mentioned earlier, the NetScaler SSL VPN has been designed to provide remote users access to authorized resources on a private network, over a secure connection. To establish a secure connection, you must first log on to the SSL VPN Web site. Contact your system administrator for the URL to this Web site, and the login credentials. The typical format for such a URL is as follows: To log on to your company s SSL VPN Web site 1. Type the URL of your company s SSL VPN web site in the browser window. If your administrator has not configured a proper SSL certificate that identifies the server, the operating system will prompt you with a security alert asking your permission to access the NetScaler SSL VPN login window. Figure 1 The Security Alert window. The security alert indicates that there might be discrepancies in the certificate. For example: the certificate has expired. the domain name in the certificate does not match the domain name of the server. the certificate is not trusted. NetScaler 9000 Series SSL VPN User s Guide 2-3

12 2 : Getting Started with NetScaler SSL VPN Click the No button and contact your VPN administrator before continuing to access the SSL VPN. 2. Open an Internet Explorer window and enter the URL of the SSL VPN web site. The SSL VPN login page is displayed. Figure 2 SSL VPN Login page 3. Enter your username and password. 4. Click Go. When you log on to the SSL VPN system for the first time, a security warning is displayed as shown in the following figure. This warning prompts you to download the SSL VPN browser plug-in. 2-4 NetScaler 9000 Series SSL VPN User s Guide

13 2 : Getting Started with NetScaler SSL VPN Figure 3 Security warning 5. Click Yes. The Secure Remote Access Session window is displayed as shown in the following figure, and the plug-in begins to download. A "Loading..." message is displayed in this window. Figure 4 Session window with the Loading.. message 6. When the download has completed, the Secure Remote Access Session window displays the following message: "Closing this window will exit SSL VPN Session". This indicates that the SSL VPN session is now active. The portal page configured by the administrator is displayed in the main browser window, as shown in the following figure. NetScaler 9000 Series SSL VPN User s Guide 2-5

14 2 : Getting Started with NetScaler SSL VPN Figure 5 Session window with the portal page in the background Note If you are not automatically prompted to download the plug-in after successfully logging in, click the "Click here" hyperlink in the alternative page that is displayed. This alternative page is shown below. 2-6 NetScaler 9000 Series SSL VPN User s Guide

15 2 : Getting Started with NetScaler SSL VPN Figure 6 Download prompt page Note For details on working with a pop-up blocker, consult your system administrator. NetScaler 9000 Series SSL VPN User s Guide 2-7

16 2 : Getting Started with NetScaler SSL VPN 3.0 Using the SSL VPN Browser Plug-in The Secure Remote Access Session window is the graphical user interface to the SSL VPN browser plug-in. It allows you to access intranet sites, file systems, and mail. Closing the secure session window will end the session. As a result, you will be disconnected from the private network. Figure 7 Secure Remote Access Session window. The buttons on the Secure Remote Access Session window are described as follows: Services: Click this button to view the portal page. This page provides links to commonly accessed web sites on the corporate network. File Transfer: Click this button to download/upload files, from the network, via the web-based interface. Configuration: Click this button to configure the plug-in. Help: Click this button to access the help system. Logout: Click this button to log off from the SSL VPN session. 3.1 Accessing Services The Portal page is created based on the data configured by the administrator. The Portal page is shown in Figure 8. This page lists the most commonly accessed intranet web sites and file systems. The administrator configures the links visible under the Configured areas on this page. You can create your own bookmarks to appear under the Personal bookmark sections. The next section illustrates using this feature. Note Your VPN administrator may have customized the Portal page. So the appearance of the page may vary from what is shown in this guide. 2-8 NetScaler 9000 Series SSL VPN User s Guide

17 2 : Getting Started with NetScaler SSL VPN Figure 8 Portal page 3.2 Using Portal Tools The Portal page has several built in tools to assist you in using the SSL VPN. These tools include a ping interface for checking the accessibility of network hosts, tips, and a link to the SSL VPN User s guide. All of these tools can be found in the left pane on the Portal page as shown in the previous figure The Ping Tool The ping tool is used to check the accessibility of other computers on your intranet and on the Internet. This feature can help you in troubleshooting connectivity issues with your SSL VPN session in addition to determining whether or not a server which is hosting an intranet resource is answering on the network. To use this tool, enter the IP address or hostname of the computer you which to ping. Then click the Ping button. The tool will respond with a message immediately below the entry box with the result of the ping. NetScaler 9000 Series SSL VPN User s Guide 2-9

18 2 : Getting Started with NetScaler SSL VPN The Tip and Help Tools The Tip tool offers helpful hints on using the SSL VPN and its various features. The Help tool is used to access the SSL VPN User s Guide. The User s Guide includes not only instruction on using the SSL VPN but also lists error code explanations and other troubleshooting assistance. 3.3 Using Bookmarks The NetScaler SSL VPN Portal allows you to create your own set of links to commonly accessed resources. These bookmarks may be links to either web sites or network accessible file systems on your intranet. You may also create bookmarks to external web sites on your portal page. To create these bookmarks, click on the add links on the right side of the page. Figure 9 below shows the new page. In the Name field, enter the label to be used for your new link. In the Address Field enter either the uniform resource locator (URL) for the website you are creating a link to or the network path to the fileserver you wish to add a link for. Once done, select the Add button to apply the new link or Cancel to exit the window without making any changes. Figure 9 Add Bookmark Page 2-10 NetScaler 9000 Series SSL VPN User s Guide

19 2 : Getting Started with NetScaler SSL VPN Note The system automatically differentiates between website addresses (URLs) and network file system paths based on the format in which they are entered. Hence you do not need to specify which type of resource your link is for when you create it. 3.4 Accessing a Remote File System This page allows you to log on to the intranet and access shared resources. The following figure illustrates the various components of this page. Figure 10 File Transfer page. The following sections cover the various components of the File Transfer page. NetScaler 9000 Series SSL VPN User s Guide 2-11

20 2 : Getting Started with NetScaler SSL VPN Top Panel The top panel of the browser window displays a number of buttons that will allow you to perform various tasks, pertaining to the storage and transfer of files. Click this button to log on to the corporate network or a specific computer on that network. Click this button to navigate to the preceding folder in the folder tree. Click this button to refresh the contents of the active folder. Click this button to create a subfolder within the folder that is selected. Click this button to download the file from the remote server. Click this button to upload the file from the local client computer to a folder in the remote file server. Click this button to delete the file from the remote machine. Click this button to change the name of a file or folder, which is selected. Click this button to disconnect NetScaler SSL VPN from the remote server Left Panel The servers, their directories, and the directory structure are displayed in a tree format in the left panel as shown in the following figure. Click the + icon to view a subfolder NetScaler 9000 Series SSL VPN User s Guide

21 2 : Getting Started with NetScaler SSL VPN Figure 11 Left panel Right Panel The right panel displays the Login Server window. Use this window to log on to the file system on the intranet or an appropriate file server. To access the file system, leave the Login Server field blank or click the Network Neighborhood link in the left panel. To log on to a file server 1. Enter the IP address or the name of the server in the Address field. Note If you leave this field blank, you will be logged on to the file system on the intranet. Alternately, if you type \\servername\c$, you can access the hidden shared folders on the server. 2. Enter your Login ID in the Login field. NetScaler 9000 Series SSL VPN User s Guide 2-13

22 2 : Getting Started with NetScaler SSL VPN 3. Enter your password in the Password field. If you do not have a password, leave the field blank. 4. Enter a valid domain name. If you have not been assigned a domain, leave the field blank. The right panel now displays the subfolders and files as shown in the following figure. The location of the active folder is displayed in the Address field. Figure 12 Right panel To download a file from a remote server 1. Select the file. 2. Click the Download icon. The File Download window is displayed. 3. Click the Save button. The Save As dialog box is displayed as shown in the following figure NetScaler 9000 Series SSL VPN User s Guide

23 2 : Getting Started with NetScaler SSL VPN Figure 13 Save As dialog box 4. Navigate to the appropriate folder, and click the Save button to save the file. NetScaler 9000 Series SSL VPN User s Guide 2-15

24 2 : Getting Started with NetScaler SSL VPN To upload a file to the remote server 1. Select the file in the local machine. 2. Click to upload the file to the remote server. To remove a folder, subfolder, or file 1. Select the file, folder, or subfolder. 2. Click the Delete icon. The file is deleted from the remote machine. Note A parent folder that contains subfolders cannot be removed. To delete a parent folder with sub folders, you need to delete the sub folders first and then delete the parent folder. 3.5 Configuring the SSL VPN Browser Plug-in Use the Configuration window to configure the SSL VPN browser plug-in and monitor the status of the server. Figure 14 General tab The Configuration window is divided into several tabbed panes. The controls under each tab are described in the following sections NetScaler 9000 Series SSL VPN User s Guide

25 2 : Getting Started with NetScaler SSL VPN General Tab Runtime data pertaining to SSL VPN browser plug-in is displayed in the General Tab. This tab consists of the following group boxes: General Information Tunneled Connections General Information The fields within this group box are: Status: This label indicates whether SSL VPN browser plug-in is connected or not. Duration: This label shows the duration for which SSL VPN browser plug-in has been online. This duration is displayed in the hh:mm:ss format. Idle Time: This label indicates the duration for which SSL VPN browser plug-in has been idle. This duration is displayed in the hh:mm:ss format. User name: This label reflects the user name logged in to the current session. Bytes Sent: This label indicates the quantity of data, in bytes, that has been uploaded from SSL VPN browser plug-in to the NetScaler system. Bytes Received: This label indicates the quantity of data, in bytes, that has been downloaded from the NetScaler system through the SSL VPN browser plug-in Tunneled Connections This panel provides a snapshot of various parameters such as process ID, IP address of the server, bytes sent, bytes received, and connection duration time for a particular tunneled connection Tunnel Tab This tab consists of the following group boxes: Split Tunneling Domain/IP Conflict Network Conflict NetScaler 9000 Series SSL VPN User s Guide 2-17

26 2 : Getting Started with NetScaler SSL VPN Figure 15 Tunnel Tab Split Tunneling For security reasons, some corporations require that all the traffic pertaining to the end user pass through the SSL VPN when the end-user is connected to the corporate network. This is to ensure that a hacker logged on to the client PC is disconnected as soon as the SSL VPN comes up. Without this feature the hacker would be able to use the violated PC as a jumping off point to attack the corporate network. When Split Tunneling is enabled, the plug-in forces all intranet connections through the SSL VPN tunnel, while the Internet connections are directly routed to the external server. When Split Tunneling is disabled, the plug-in forces all connections -both internal and external - through the SSL VPN tunnel. This group box consists of two buttons Enable and Disable, to control split tunneling. If your administrator has disabled split tunneling, all items in this panel will be dimmed out, and you will not be allowed to perform any configuration tasks. If your administrator has enabled split tunneling, you will have control over this feature. To disable Split Tunneling, click the Disable button. Click the OK button to save your changes NetScaler 9000 Series SSL VPN User s Guide

27 2 : Getting Started with NetScaler SSL VPN Domain/IP Conflict This group box consists of controls that can be set to prevent domain conflicts. All DNS lookups are performed locally. When the lookup fails, the system resorts to a remote lookup on the intranet via the SSL VPN tunnel. In such cases, a local domain name might conflict with a domain name within the intranet. Such conflicting domain name(s) can be configured on the plug-in using the Configuration window. This ensures that a remote intranet lookup is performed prior to looking up that domain name locally. The following example illustrates this concept. A remote private network has a domain named "paris". A client, connecting to this network, also has a domain named "paris" in their local network. When you type in the browser window, the plug-in performs a domain name lookup. The plug-in then routes the connection to the local domain if the configured network subnet does not enforce the routing to the remote private network. Alternately, if the remote domain "paris" is configured in the Configuration window, the plug-in performs the domain name lookup in the remote private network. The connection is then tunneled to the remote private network if the configured network subnet enforces similar tunneling. You can add wildcard intranet domain suffixes, such as "*.mycompany.com". Note When split tunneling is disabled, the local domain is not included during the lookup and the Domain/IP Conflict pane is disabled. To add domain names/ip addresses that can be accessed in the remote private network 1. Enter the domain name/ip address of the host and click Add. 2. Click Apply to save the changes. To remove a domain names/ip address from the list 1. Deselect the domain name/ip address from the list. 2. Click Apply to save the changes. To remove all domain names/ip address from the list 1. Click Remove All. 2. Click Apply to save the changes NetScaler 9000 Series SSL VPN User s Guide 2-19

28 2 : Getting Started with NetScaler SSL VPN Network Conflict This group box consists of controls that can be set to prevent network conflicts. Currently, all connections that match the configured destination intranet subnets are routed to the remote private intranet network. It is possible that a remote user's machine or network might have a network identity (host with an IP address or a network subnet) that conflicts with a host or subnet in the remote private network. For example, consider a scenario where both the remote and local networks have a subnet IP address of with a netmask of The application needs to connect to the local network. To force this to happen, deselect the conflicting network subnet in the Configuration window. The plug-in routes all connections for that subnet to the local network. To connect to the same subnet on the remote network (default behavior), select the network subnet again in the Configuration/Tunnel window. Note When split tunneling is disabled, access to the local network is disabled. This group box is unavailable when split tunneling is disabled. To avoid Network Conflicts 1. Deselect the networks from the list of networks. 2. Click Apply to save the changes Trace Tab You can debug the plug-in by studying the traces that it generates when it is active. Use the options in this window to enable or disable the generation of a trace file. Once enabled, the plug-in writes traces to the file specified in the Trace Filename field NetScaler 9000 Series SSL VPN User s Guide

29 2 : Getting Started with NetScaler SSL VPN Figure 16 Trace Tab Compression Tab The compression tab displays statistics about the current SSL VPN session s TCP traffic compression rates, broken down by individual connections. The columns on this tab include the following statistics. Port: The port number the connection is communicating on. UncmpDataSize: Size of the data before compression is applied. CmpDataSize: The data size after compression is applied. Bandwidth Saving: The approximate bandwidth savings by the use of compression, expressed as a percentage. This is calculated by the compressed data size subtracted from the actual size, all divided by the actual data size. CmpRatio: The compression ratio based on actual data size versus the compressed data size. Note Bandwidth savings may occasionally show as a negative value. This happens most frequently with applications such as Telnet where transmitted data is sent in very small pieces and other applications where data is precompressed. Figure 17 below shows the Compression tab. NetScaler 9000 Series SSL VPN User s Guide 2-21

30 2 : Getting Started with NetScaler SSL VPN Figure 17 Compression Tab About Tab This window displays the version, supported features, and web site information for this SSL VPN session and software. Figure 18 About Tab 2-22 NetScaler 9000 Series SSL VPN User s Guide

31 2 : Getting Started with NetScaler SSL VPN 3.6 Accessing Help The Help window on the Secure Remote Session window displays the help system for the plug-in. To access this window, click the Help button. 3.7 Terminating the SSL VPN Session To log off from the SSL VPN session, close the Secure Remote Access Session window or click the Logout button. This will disconnect all active connections. All in-memory session cookies are deleted. If Client Clean up is enabled, the Client Clean up window is displayed. For details, refer to the next chapter. NetScaler 9000 Series SSL VPN User s Guide 2-23

32 2 : Getting Started with NetScaler SSL VPN 2-24 NetScaler 9000 Series SSL VPN User s Guide

33 3 : Using Advanced Plug-in Features Chapter 3 Using Advanced Plug-in Features This chapter introduces you to some of the advanced features of the SSL VPN browser plug-in. The first section covers the forward proxy settings for the plug-in. This is followed by a section that covers the Client Computer Security Check feature of the plug-in. The last section covers the procedure for enabling Client-side Cleanup. When enabled, this feature causes the plug-in to delete all the temporary files during the log off process. These files are generated during an SSL VPN operation on the client machine, and may pose a security threat. The following topics are described in this chapter: Forward Proxy Support Client Computer Security Check Windows Client Cleanup NetScaler 9000 Series SSL VPN User s Guide 3-1

34 3 : Using Advanced Plug-in Features 1.0 Forward Proxy Support Forward proxy servers support Internet access for a number of clients through a single server for security, caching, or filtering. If your network uses a Forward Proxy server, you need to configure your Web browser to point to that Forward Proxy server when accessing SSL VPN. When the plug-in runs on a computer, it begins to function as the Forward Proxy server. When the Forward Proxy server requires authentication, the following window is displayed. Figure 1 Forward proxy setting You need to enter an appropriate login name and password in this window for further action. If you enter an incorrect login name or password, the window will be displayed again. 3-2 NetScaler 9000 Series SSL VPN User s Guide

35 3 : Using Advanced Plug-in Features 2.0 Client Computer Security Check The SSL VPN administrator can configure the plug-in to enforce a security policy on the client computer. A security policy is typically meant to ensure that security applications are installed and running. Security applications typically include personal firewalls, anti-virus packages, and customized applications or services. The plug-in performs a security check to ensure that the security policy is adhered to. These checks can be performed against numerous aspects of your computer s operating system.netscaler system can also enforce the following security requirements: Installed files on the client file system Administrator specified services and processes Personal firewall software Anti-virus applications Internet security suites Customized applications or services These security checks can be performed once on login to the SSL VPN and also at periodic intervals during an active SSL VPN session as specified by the administrator.if a security check fails at any of these points, the plug-in will not be able to access the NetScaler SSL VPN, even if successfully authenticated. If you are currently logged in and a security check fails, you will be disconnected from the SSL VPN. When a security check fails, the plug-in will alert you to the failure, including the cause along with an error code. If you receive an error message such as this, make a note of it and contact your VPN administrator to rectify the failed security requirement on your computer as soon as possible. NetScaler 9000 Series SSL VPN User s Guide 3-3

36 3 : Using Advanced Plug-in Features 3.0 Windows Client Cleanup The temporary files generated on the client computer during an SSL VPN session, could pose a security threat. These files can be misused to obtain confidential information. To eliminate this threat, the SSL VPN browser plug-in supports the cleanup of the files after the SSL VPN session is closed. This feature, however, needs to be enabled by the system administrator. If the system administrator enables this feature, a client cleanup dialog window is displayed when you log off from the SSL VPN session. This feature is explained in this section. 3.1 Windows Client Cleanup Dialog When you select the Logout button from the Secure Remote Session window, you may be presented with the Client Cleanup dialog discussed here. If your VPN administrator has configured the SSL VPN to not present this dialog, you will not see it when you log out. Figure 2 Cleanup dialog box 3-4 NetScaler 9000 Series SSL VPN User s Guide

37 3 : Using Advanced Plug-in Features The system administrator can also configure the NetScaler system to delete some groups of files before this dialog box is displayed. In this scenario, the options corresponding to these configured groups are disabled when this dialog box is displayed. This dialog box provides four options. If you click the Cleanup button, the plug-in opens another dialog box (which is detailed shortly) that allows you to select individual files for removal based on the check boxes you select along the left side of this dialog box. If you click the View logfile button, you will be presented with a log of the cleanup mechanism s actions during this session. Selecting the Launch browser and Exit button, the session will log out and the Login page is displayed again. If you click the Exit button, the plug-in exits. The following sections explain the check box options in this window. Clean up browser cache, cookie, and temporary files When you select this option and click the Cleanup button, data that is stored in the browser cache is selected for deletion by the plug-in. Browser caching improves performance by storing local copies of data accessed via the Web. The NetScaler system supports the deletion of all cached files, which have been accessed/created during the SSL VPN session, and does not differentiate between files cached from the intranet or internet web sites. The plug-in also supports the cleanup of temporary files and cookies. Clean up history and browser typed URLs in the address bar When you select this option, all the URLs stored by the browser and history data added during this session are deleted by the plug-in. This requires that all browser windows be closed in order to clean up this information. Clean up password and auto complete information stored by IE Selecting this option will add all of the auto complete data that Internet Explorer stored during your session. This auto complete data includes any user credentials, user names and passwords, credit card numbers and any other data entered while filling in forms on web sites. NetScaler 9000 Series SSL VPN User s Guide 3-5

38 3 : Using Advanced Plug-in Features Close file transfer browser window When you select this option and click the Cleanup and Exit button, all the directory and file information, buffered by the File transfer browser, are deleted by the plug-in. This can also occur if the file transfer window is active when the SSL VPN session is terminated. Close this window before you exit the SSL VPN session. Clean up NetScaler ActiveX Browser Plug-in When you select this option and click the Cleanup and Exit button, the plug-in is deleted from the hard disc of the client computer. Clean up Client Authentication Certificate If SSL Client Certificate Authentication was used during your session, you would use this option to select residual certificates stored on your system by the SSL authentication process. Clean up application data created by IE Selecting this option will allow the cleanup process to remove all non-roaming classified (not stored on an external server) application data such as user preferences, temporary files, application state information, etc. that were created locally during the session. Close all applications, which have accessed the SSL VPN services When you select this option and click the Cleanup and Exit button, the plug-in closes certain processes. These processes correspond to the applications that access the SSL VPN service during the SSL VPN session. This will prevent the leakage of sensitive information buffered by the application. 3.2 Client Cleanup Item Listing Dialog When you select the Cleanup button from the Client Cleanup dialog, you will be presented with the window shown in Figure 3. The items that populate this dialog are shown based on the options you select from the previous Client Cleanup dialog. The listing is broken up in to two sections. The upper listing section includes all the browser cache, cookies, and URL files marked for deletion. The lower section lists all the other items selected for removal which are WIndows Registry Entries. 3-6 NetScaler 9000 Series SSL VPN User s Guide

39 3 : Using Advanced Plug-in Features Each item in these two listings has a checkbox before it that you may use to individually select and deselect items for clean up. The buttons on this page perform the following actions. Check All: Clicking this button will mark all items in the listings for removal. Uncheck All: Using this button will unmark all the items in the listings. Cleanup!: This button initiates the clean up procedure. Once you click this button, items marked for clean up will be permanently removed and you will be returned to the Client Cleanup dialog. Exit: This button exits the dialog, returning you to the Client Cleanup window. If you have not selected the Cleanup! button, no items will be removed when you click the exit button. Figure 3 Cleanup Item Listing Dialog NetScaler 9000 Series SSL VPN User s Guide 3-7

40 3 : Using Advanced Plug-in Features 3-8 NetScaler 9000 Series SSL VPN User s Guide

41 4 : Troubleshooting the SSL VPN Browser Plug-in Chapter 4 Troubleshooting the SSL VPN Browser Plug-in This chapter covers the troubleshooting of the SSL VPN browser plug-in. The following topics are described in this chapter: Debugging the SSL VPN Browser Plug-in NetScaler SSL VPN Session Error Codes NetScaler 9000 Series SSL VPN User s Guide 4-1

42 4 : Troubleshooting the SSL VPN Browser Plug-in 1.0 Debugging the SSL VPN Browser Plug-in You can configure the plug-in to run in debug mode. In this mode, the SSL VPN browser plug-in logs all of its major activities into an ASCII file. These ASCII files, also known as log files, are stored in the file system. On Windows 95/98/ME, you need to specify the names of these files in the following format: hooklog<num>.txt nssslvpn.txt Use the hooklog<num>.txt file for debugging the interception code and the nssslvpn.txt file for debugging the plug-in. On Windows NT/2000/XP/2003, you can specify the file name. The default filename is c:\nssslvpn.txt. You can use these log files to debug and troubleshoot the plug-in. Kindly mail the log files to NetScaler Support if you encounter any problems. To enable the creation of these files, select the Enable Client Trace option in the Trace pane of the Configuration window. 4-2 NetScaler 9000 Series SSL VPN User s Guide

43 4 : Troubleshooting the SSL VPN Browser Plug-in 2.0 NetScaler SSL VPN Session Error Codes The error codes, displayed by the NetScaler SSL VPN session window, are displayed in the following table. Error Code Table 1 Description Error codes displayed in the Session window Normal operation Internal error SSL VPN browser plug-in errors Browser errors Windows Client Side Cleanup errors Note All the 2xxx and 3xxx error messages are displayed in black. The following table lists the specific error codes displayed by the SSL VPN session. It also provides a description of these error codes. Table 2 Specific error codes displayed by the SSL VPN session Codes Message Explanation Action 0001 "Loading..." This message indicates that the plug-in is loading the configuration and the interception software before the SSL VPN session is ready to tunnel connections/data. None 0002 Closing this window will exit the SSL VPN session" This message indicates that the plug-in is functioning and it is ready to tunnel connections/ data to the NetScaler 9000 system. None NetScaler 9000 Series SSL VPN User s Guide 4-3

44 4 : Troubleshooting the SSL VPN Browser Plug-in 0003 "Closing this window will exit the SSL VPN session" This message indicates that the plug-in is functioning and the client system has been secured with appropriate security software. (e.g. anti-virus packages and personal firewall). The message also indicates that the plug-in is ready to tunnel connections/ data to the NetScaler 9000 system "Exiting..." This message is displayed when the user clicks the Logout button in the Secure Session window. The message indicates that the plug-in has begun to close the SSL VPN session "Internal Error, please report to admin" 1002 "Internal Error, please report to admin" 1003 "Internal Error, please report to admin" 1004 "Internal Error, please report to admin" Table 2 (Continued) Specific error codes displayed by the SSL VPN session Codes Message Explanation Action This message indicates that the plug-in has failed to open the interception file. This message indicates that the version of the plug-in and the version of the interception software do not match. This message indicates that the plug-in failed to allocate memory. This message indicates that the plug-in is unable to call the windows library function successfully. None None Reboot your computer, and log on to the windows account, which has administrative privileges. Log off from the SSL VPN session, cleanup the plug-in, and login again. Contact NetScaler Support to obtain the correct version. Log off from the SSL VPN session and login again. Report this problem to NetScaler Support. Report this problem to NetScaler support. 4-4 NetScaler 9000 Series SSL VPN User s Guide

45 4 : Troubleshooting the SSL VPN Browser Plug-in 1005 "Internal Error, please report to admin" 1006 "Internal Error, please report to admin" 1007 "Internal Error, please report to admin" 1008 "Internal Error, please report to admin" 1009 Reserved error code number Table 2 (Continued) Specific error codes displayed by the SSL VPN session Codes Message Explanation Action This message indicates that the plug-in failed to create the temporary interception file. This error occurs when the user does not possess Write permission in the Windows system directory. This message indicates that the plug-in failed to obtain the list of running applications when it tried to check whether a specific application was running. This message indicates that the plug-in in failed to check whether a particular security service was running. The security service could be a personal firewall or an anti-virus services. This message indicates that the SSL VPN client has a socket-handling problem. N/A 1010 "Login failed." Pocket PC client failed to login to the SSL VPN. Ensure that the windows account has been configured with the write permissions in the Windows System Directory, which is c:\windows\system32 or c:\windows\system. Contact the system administrator. Contact the system administrator. Ensure that the security service is running. Log off from the SSL VPN session and login again. N/A Make sure the correct username/password is provided. NetScaler 9000 Series SSL VPN User s Guide 4-5

46 4 : Troubleshooting the SSL VPN Browser Plug-in Table 2 (Continued) Specific error codes displayed by the SSL VPN session Codes Message Explanation Action 1011 "Failed to download configuration" 1012 "Failed to initialize plugin (num)." 2001 "SSL VPN session has been timed out" 2002 "Please install dsclient.exe" 2003 "SSLVPN configuration issue" 2004 "Need to install endpoint security software" 2005 "Need to upgrade endpoint security software" 2006 "Required security software is not activated" This error is displayed when the plugin fails to download the configuration form the VPN gateway after trying three times. The Plugin failed to initialize. The num value displays further error indicators. This message indicates that your SSL VPN session has timed out. This message indicates that the plug-in has not been able to detect dsclient.exe on the client machine. This software, from Microsoft Corp., enables SSL encryption/decryption for some Windows platforms. This message indicates that the CLI has not been configured correctly. This message indicates that at least one of the required endpoint security software packages is not installed. This message indicates that endpoint security software has not been upgraded. This message indicates that the an endpoint security software has not been activated. Make sure network is up and that the plugin has the same version as NetScaler kernel. Refer to Appendix A at the end of this guide for instructions on manually uninstalling the plugin. Uninstalling the plugin will force the correct plugin version to be downloaded from the NetScaler VPN gateway on next login. Close other unneeded applications. If the error persists, contact your VPN administrator or NetScaler. Click the Logout button on the Secure Remote Access Session window to log off from the SSL VPN session and login again. Contact the system administrator to download and install dsclient.exe on your Windows 98 or Windows 95 client computer. Contact the system administrator to configure SSL VPN correctly. Contact the system administrator to install the required security software. Contact the system administrator to upgrade the required security software. Run the required security software. 4-6 NetScaler 9000 Series SSL VPN User s Guide

47 4 : Troubleshooting the SSL VPN Browser Plug-in Table 2 (Continued) Specific error codes displayed by the SSL VPN session Codes Message Explanation Action 2007 "Hook doesn't match plug-in version" 2008 "Plug-in version mismatch" 2009 "Proxy requires unsupported authentication" 2010 "Proxy authentication failed, need to relogin." 2011 "Hook activation failed." 2012 "Failed to validate SSL Certification." 2013 "Failed to parse forward proxy setting." 2014 Need to stop software "XYZ" This message indicates that the interception code does not match the version of the plug-in. This message indicates that the the plug-in, which was downloaded, does not match the version of the NetScaler kernel. This message indicates that the plug-in has received an unsupported authentication method. This message indicates that you clicked the Cancel button for proxy authentication. The plugin failed to activate the network socket interception code. The plugin failed to validate the SSL Certificate. The plugin failed to parse the Internet Explorer forward proxy setting. The client security check detected that a disallowed software process is running. In the error message, the actual name of the detected software is displayed in place of XYZ. Logout and login again. Please log off from the Web site, remove the plug-in manually, and login again. Go to \Tools\Internet Options\Settings\View Objects\ and delete the "nsload Control" icon. Report the problem to NetScaler. Log off and log on again. Automatic installation of the plug-in requires administrative privilege. For non-administrative windows accounts, the plug-in must be manually installed. The incorrect SSL certificate is bound on the NetScaler VPN gateway. Correct the Internet Explorer configuration under Tools -> Internet Options -> Connections ' LAN Settings. Ensure that the correct configuration is in place. Stop the detected software process before logging in to the SSL VPN again. NetScaler 9000 Series SSL VPN User s Guide 4-7