Remote Access Portal
From UntangleWiki
Please Note: Most of the features discussed in this User Guide are available in the Open Source version of the Untangle Server software; however, some features are only available in the Professional Package. For a current listing of features and pricing, have a look at the Untangle Price List.
Remote Access Portal is currently only available in the Professional Package.
About Remote Access Portal
The Remote Access Portal provides a web portal for end-users to easily access internal network resources (if you're an Administrator, consider using PC Remote instead):
- Web servers (Intranet)
- Web mail
- File servers (network shares)
- Desktops
- Quarantined email
The Remote Access Portal is a client-less SSL VPN that provides a secure remote access from anywhere to a company's intranet through a regular web browser. Remote Access Portal is a great choice for remote access to desktops, web-based applications including email, and file sharing.
The portal home page is divided into two sections as shown in Figure, Example Portal Home Page:
- Bookmarks. Shows users bookmarks to resources.
- Applications. Shows a list of applications available to users. Portal Applications are web applications available to portal users. Currently, Network File Browser is the only available application.
When bookmark management is enabled, users can add and delete their own bookmarks using the plus and minus buttons. The maximize window button, enables users to increase the size of the current application. The home button returns the user to the home page, and the logout button, logs the user out of the portal.
Setting Up Remote Access Portal
Remote Access Portal offers many features to customize portals. However, in under 5 minutes you can set up a basic portal that enables all employees to access network resources.
Before You Begin:
Glance at the example outlined in Creating a Remote Access Portal for Angelic Resumes, Inc.
Task Go to 1. (Optional) Map your Untangle Server's public IP address to a domain name. Enables portal users can access the Remote Access Portal using the Untangle Server's domain name, rather than the IP address.
Configuring Untangle Server To Use Dynamic DNS 2. Install and turn on the Remote Access Portal. Installing Software Products Downloaded from the Library 3. Enable remote access to the Untangle Server. Enabling Remote Access To Untangle Server 4. If your Untangle Server does not have a public IP address, port forward from a public IP. Redirecting External and Internal Traffic 5. Install a certificate so that users do not encounter certificate warnings when they connect to the Remote Access Portal. About Digital Certificates 6. Ensure that each portal user has an account on the Local LDAP Server or on the Active Directory server. About User Access and Authentication 7. If you intend to create an RDP bookmark (Deciding When To Create a RDP Bookmark or VNC Bookmark) to a remote desktop, do one of the following :
- If the remote desktop is a Windows computer, complete the preparation steps.
- If the remote desktop is a Mac enable Remote Desktop Protocol (RDP).
Windows:
(Windows) Preparing To Create RDP Bookmarks.
Mac:
Apple RDP Tutorial. Note: For Macs, you only need to enable RDP, so only perform the initial step. Remote Access Portal does the remaining work for you.8. If you intend to create a VNC bookmark (Deciding When To Create a RDP Bookmark or VNC Bookmark) to a remote desktop, download and install the VNC server. Preparing To Create VNC Bookmarks 9. If you intend to create a bookmark to a network share, ensure that the portal users that you want to access that network share have permissions to that share. Otherwise, users will be denied access to that network share when they click on the network share bookmark.
Refer to your file server's operating system documentation or your NAS device's documentation.
10. (Optional) If you intend to create a portal group, create that portal group. You need a portal group if you do not want to make all networks resources (bookmarks) available to all users.
11. Add portal users to the Remote Access Portal. Adding Portal Users 12. Create the portal bookmarks, and customize the portal's look-and-feel. 13. Log on to the Remote Access Portal, and click on the bookmarks that you created to ensure that they are working properly.
(Windows) Preparing To Create RDP Bookmarks
Perform this procedure if the remote desktop is a Windows computer. If you have a Mac, go to Apple RDP Tutorial.
Note: For Macs, you only need to enable RDP, so only perform the initial step. Remote Access Portal does the remaining working for you.
The Untangle Server supports remote desktop control through Remote Desktop Protocol (RDP). RDP enables you to use any computer’s (client) mouse and keyboard to interact with another computer (host) through the Internet and in real-time. RDP enables you to transfer files between these two computers. You can also run the host’s applications on the client computer without having software installed on the client computer. Before you create desktop bookmarks using Remote Access Portal, perform the following steps:
Task Go to 1. Determine that your operating system supports RDP. Remote Desktop Protocol (RDP). Windows XP Home and Windows 98 versions do not support RDP. Windows RDP Requirements 2. Enable remote access to your Windows PC. Enabling Remote Desktop Control To Windows PC 3. If you have a Windows firewall, configure Windows Firewall to allow access. Configuring Windows Firewall To Allow Access
Enabling Remote Access To Windows PC
Perform this procedure on the host computer. The computer at the temporary location is the client computer. The computer at the remote location is the host computer.
To enable remote desktop control:
- Ensure that you are signed in as Administrator.
- On the host computer, click Start > Control Panel, and double-click on the System icon.
- Click the Remote tab, select the Allow users to connect remotely to this computer check box, and click OK. The computer is now enabled to allow remote access.
Configuring Windows Firewall To Allow Access
Perform this procedure on the host computer. Use this procedure if you intend to use Windows Firewall on the host computer. The computer at the temporary location is the client computer. The computer at the remote location is the host computer.
To set up Windows Firewall to allow exceptions:
- On the host computer, click Start > Control Panel, and double-click on the Security Center icon.
- Under Manage security settings for, click Windows Firewall.
- If selected, clear the Don't allow exceptions check box.
- Click the Exceptions tab, and select the Remote Desktop check box.
- Click OK, and then close the Windows Security Center window. Your host computer is now set up to allow remote access.
- Close the Control Panel.
Next Step:
- Creating Portal Bookmarks and Customizing Portal Home Page
- Example: Creating an RDP Bookmark To a Desktop
Preparing To Create VNC Bookmarks
There are a number of VNC products on the market (for example, RealVNC). However, all essentially enable you to interact with a computer remotely. VNC is valuable if you want multiple users to interact with the same computer remotely.
Task Go to 1. Determine that your VNC product supports your operating system. RealVNC 2. Download the VNC Server on the computer that you want to log on to remotely. VNC Enterprise Edition 3. Install the VNC Server. 4. Configure the VNC Server.
Configuring VNC Server
The easiest way to configure the VNC Server is to specify a password and turn off encryption. This procedure assumes that you're using RealVNC, though all VNC products are very similar.
To configure VNC Server:
- Launch the VNC Server service.
- Provide a password for authentication. Users that want to log on to the desktop that runs VNC will need to type this password.
Next Step:
- Creating Portal Bookmarks and Customizing Portal Home Page
- Example: Creating a VNC Bookmark To a Desktop
Adding Portal Users
The Remote Access Portal automatically creates on demand portal accounts for all users in the User Directory. To disable this default, clear the Create Accounts On Demand From User Directory check box in the Global Settings tab > Page Setup.
- If the check box is selected, when a user authenticates with the User Directory but does not have a portal account, the Untangle Server automatically creates a portal account.
- If the check box is cleared, only users with a portal account can log in, even if that user can authenticate with the User Directory.
Before You Begin:
- Ensure that each portal user has an account on the Local LDAP Server or on the Active Directory server. To learn what happens if the account doesn't exist, go to About User Access and User Authentication.
- (Optional) Create groups. Go to Creating Portal Groups.
To add a portal user:
- From Remote Access Portal, click the Users tab.
- Click on the green plus (+) button to add a new entry. A new row appears.
- Click on the [no user id/login] button. The Portal Question window appears.
- In the Select an existing user: drop-down list, select the user to whom you want to give Remote Access Portal access, then click Proceed. If you have configured both Local Directory (LDAP) and Active Directory (AD), you can identify users by the tag at the end of the user’s name:
- (Active Directory). Represents users that authenticate using Active Directory.
- (local). Represents users that authenticate using Local Directory.
- (Optional) Add the user to a group by selecting a group from the group drop-down list.
- Click Save Settings.
Creating Portal Groups
Groups are a convenient and optional way to organize page settings and bookmarks for a specific group. For example, if you create an Employees group, you can edit all employees' bookmarks and page settings from a single location. You can also have more than one group. For example, an Employees group and a Contractors group, providing bookmarks to different network resources
Warning: Group page settings are overridden by individual user page settings.
To create a group:
- From Remote Access Portal, click Group tab.
- Click the plus (add) button to the left of the table. A new row appears.
- Specify a descriptive name for the group.
- Click the Save Settings button.
Creating Portal Bookmarks and Customizing Portal Home Page
You can add bookmarks to applications or customize the look-and-feel of the portal home page for any of the following:
- A user (user settings). User Settings provide a way to create customized home pages for individual users. Go to Creating Bookmarks and Customize Home Page for Specific Users.
- A group (group settings). Group Settings provide a convenient way to make bookmarks available to a specific group of users. Go to Creating Bookmarks and Customizing Home Page for Portal Groups.
- All users (global settings). Global Settings provide a convenient way to make bookmarks available to all users' portal home pages. Go to Creating Bookmarks and Customizing Home Page for All Users.
Note: The Untangle Server applies page settings to all portal users unless overridden in the user's personal page settings or the user's group page settings.
Deciding When To Create a RDP Bookmark or VNC Bookmark
The choice whether to create an RDP bookmark or a VNC bookmark depends on two factors:
- Your operating system
| Operating System | RDP | VNC |
|---|---|---|
| Windows 98 | No | Yes |
| Windows 2000 | Yes | Yes |
| Windows XP Home | No | Yes |
| Windows Media Center | No | Yes |
| Windows XP Professional | Yes | Yes |
| Mac | Yes | Yes |
| Linux/Unix | Yes | Yes |
- Whether you need collaboration or simply remote access
| Operating System | RDP | VNC |
|---|---|---|
| Collaboration | No | Yes |
| Remote Access | Yes | Yes |
Creating Bookmarks and Customize Home Page for Specific Users
Before You Begin:
- If you intend to create a bookmark to a remote desktop, complete the preparation steps outlined in (Windows) Preparing To Create RDP Bookmarks.
- If you intend to create a bookmark to a network share, ensure that the portal users that you want to access that network share have permissions to that share. Otherwise, users will be denied access to that network share when they click on the network share bookmark.
To create page setting and bookmarks for a specific portal user:
- From Remote Access Portal, click Users tab.
- Scroll to the row that corresponds to the user for whom you want to create page setting sand bookmarks.
- In the bookmarks and page settings column for the group, click the Edit button.
- In the User Settings for Employee window, click the plus (add) button to the left of the table. A new row appears.
- Select an application from the application drop-down list, provide a descriptive name for the bookmark, and specify the destination in the target text box and any application properties:
- steal actual desktop. Choose this mode if you do not want anyone else to log on to this desktop when you are logged on.
- show actual desktop. Choose this mode if you want to log on to this desktop and also want others to log on at the same time.
- Customize the portal home page:
- In the User Settings for EmployeeName window, click the Page Setup tab.
- Specify the home page characteristics.
- Click the Save Settings button.
VNC bookmarks An example target is 192.168.1.10:0. The target computer must be running a VNC server. Network File Browser bookmarks The target is the network file share location. For example, \\myfileserver\share. Web Proxy The target is the URL to your company's Intranet site. For example, http://internalwebserver.mycompany.com/. Remote Desktop As outlined in Figure, Creating Bookmarks for Specific Users, specify the desired size (800x600 is common) size of popup window, view mode so that a user can view the identical desktop, or create a new desktop. The target is the IP address or host name of the desktop that that user wants to control remotely. For example, 192.168.1.10. Tip: Use the optional command text box to specify an application to run instead of logging directly into the machine. An example command is C:\test.exe. The console settings control the actual mouse and keyboard (true) or receive a virtual terminal (false).
There are two view modes:
Creating Bookmarks and Customizing Home Page for Portal Groups
To create page setting and bookmarks for a specific portal group:
Before You Begin:
- Create the group. Go to Creating Portal Groups.
- If you intend to create a bookmark to a remote desktop, complete the preparation steps outlined in (Windows) Preparing To Create RDP Bookmarks.
- If you intend to create a bookmark to a network share, ensure that the portal users that you want to access that network share have permissions to that share. Otherwise, users will be denied access to that network share when they click on the network share bookmark.
- From Remote Access Portal, click Group tab.
- Add a bookmark:
- Click the Bookmarks tab.
- Scroll to the row that corresponds to the group for whom you want to create page setting sand bookmarks.
- In the bookmarks and page settings column for the group, click the Edit button.
- In the Group Settings for GroupName window, click the plus (add) button to the left of the table. A new row appears.
- Select an application from the application drop-down list, provide a descriptive name for the bookmark, and specify the destination in the target text box and any application properties:
- steal actual desktop. Choose this mode if you do not want anyone else to log on to this desktop when you are logged on.
- show actual desktop. Choose this mode if you want to log on to this desktop and also want others to log on at the same time.
- Customize the portal home page:
- In the Group Settings for GroupName window, click the Page Setup tab.
- Specify the home page characteristics.
- Click the Save Settings button.
VNC bookmarks An example target is 192.168.1.10:0. The target computer must be running a VNC server. Network File Browser bookmarks The target is the network file share location. For example, \\myfileserver\share. Web Proxy The target is the URL to your company's Intranet site. For example, http://internalwebserver.mycompany.com/. Remote Desktop Specify the desired size (800x600 is common) size of popup window, view mode so that a user can view the identical desktop, or create a new desktop. The target is the IP address or host name of the desktop that that user wants to control remotely. For example, 192.168.1.10. Tip: Use the optional command text box to specify an application to run instead of logging directly into the machine. An example command is C:\test.exe. The console settings control the actual mouse and keyboard (true) or receive a virtual terminal (false). There are two view modes:
Creating Bookmarks and Customizing Home Page for All Users
Before You Begin:
- If you intend to create a bookmark to a remote desktop, complete the preparation steps outlined in (Windows) Preparing to Create RDP Bookmarks.
- If you intend to create a bookmark to a network share, ensure that the portal users that you want to access that network share have permissions to that share. Otherwise, users will be denied access to that network share when they click on the network share bookmark.
To create page setting and bookmarks for all portal users:
- From Remote Access Portal, click Global Settings tab.
- Add a bookmark:
- Click the plus (add) button to the left of the table. A new row appears.
- Click the tab that corresponds to the type of bookmark you want to create.
- Click the plus (add) button to the left of the table. A new row appears.
- Select an application from the application drop-down list, provide a descriptive name for the bookmark, and specify the destination in the target text box and any application properties:
- steal actual desktop. Choose this mode if you do not want anyone else to log on to this desktop when you are logged on.
- show actual desktop. Choose this mode if you want to log on to this desktop and also want others to log on at the same time.
- Customize the portal home page:
- In the User Settings for GroupName window, click the Page Setup tab.
- Specify the home page characteristics.
- Click the Save Settings button.
VNC bookmarks An example target is 192.168.1.10:0. The target computer must be running a VNC server. Network File Browser bookmarks The target is the network file share location. For example, \\myfileserver\share. Web Proxy The target is the URL to your company's Intranet site. For example, http://internalwebserver.mycompany.com/. Remote Desktop Specify the desired size (800x600 is common) size of popup window, view mode so that a user can view the identical desktop, or create a new desktop. The target is the IP address or host name of the desktop that that user wants to control remotely. For example, 192.168.1.10. Tip: Use the optional command text box to specify an application to run instead of logging directly into the machine. An example command is C:\test.exe. The console settings control the actual mouse and keyboard (true) or receive a virtual terminal (false). There are two view modes:
Example: Creating a Remote Access Portal for Angelic Resumes, Inc.
The following examples represents a portal page for Angelic Resumes, Inc., a company that provides resumes services to clients throughout the San Francisco Bay Area.
- Example: Creating a Bookmark To a Network Share
- Example: Creating an RDP Bookmark To a Desktop
- Example: Creating a VNC Bookmark To a Desktop
Note: To enable portal users can access the Remote Access Portal using the Untangle Server's domain name, rather than the IP address, Angelic Resumes, Inc. mapped its Untangle Server's public IP address to a domain name as outlined in Configuring Untangle Server To Use Dynamic DNS.
Example: Creating a Bookmark To a Network Share
Angelic Resumes, Inc. needs two groups: Employees and Contractors. Each group requires access to different network resources. You must define such bookmarks under Group, not User or Global as shown in Figure, Creating Bookmarks and Customizing Portal Look-and-Feel. The following example demonstrates a Remote Access Portal with the following bookmark to a network share, and a portal page with the following customizations:
- Bookmarks. For the Contractor group, one bookmark to the Share folder on a network share named yokie.
- Page Setup. Customized page with unique text to greet the contractors that log on to the portal. The portal has Show Application List disabled to restrict contractors from browsing the network.
Example: Creating an RDP Bookmark To a Desktop
Angelic Resumes, Inc. needs all employees to have access to their individual desktops, and you must define bookmarks that are exclusive to specific users under User, not Group or Global. The following example demonstrates how to create a RDP bookmark.
Note: Desktop bookmarks can use VNC or RDP as discussed in Deciding When To Create a RDP Bookmark or VNC Bookmark.
Example: Creating a VNC Bookmark To a Desktop
Asngelic Resumes, Inc. needs all employees to have access to a desktop that the company uses to provide remote training for writers. You must define bookmarks that apply to all employees under Global, not User or Group. The following example demonstrates how to create a VNC bookmark.
Note: Desktop bookmarks can use VNC or RDP as discussed in Deciding When To Create a RDP Bookmark or VNC Bookmark.
Maintaining Remote Access Portals
Enabling All Users To Create Bookmarks
The Untangle Server applies page settings to all portal users unless overridden in the user's personal page settings or the user's group page settings.
To enable all users to create bookmarks:
- From Remote Access Portal, click Global Settings tab.
- Click the Page Setup tab.
- In the Home Page Features pane, select the Allow User Added Bookmarks.
- Click the Save Settings button.
Displaying Active Portal Users
To display active portal users:
- From Remote Access Portal, click the Refresh button.
- Click the Active Users tab.
- Use the scroll bar to view the users that are currently logged in to the Remote Access Portal.
Tip: To log off users from the Remote Access Portal, click the logout button.
Displaying Portal Users' Historical Activity
To display historical activity:
- From Remote Access Portal, click the Event Log tab.
- Click the Refresh log button.
- Use the scroll bar to view the users' login events and logout events.
Setting Idle Timeout for Portal Users
For greater security, you can change the idle timeout setting. By default the Untangle Server logs off any portal user that is idle for 20 minutes or more.
To set idle timeout:
- From Remote Access Portal, click Global Settings tab.
- In the Group Settings window, click the Page Setup tab.
- Scroll down to the Timeout pane, change the idle timeout setting.
- Click the Save Settings button.
Working With Remote Access Portal Home Page
- Logging On To Remote Access Portal
- Logging On To RDP Client
- Logging On To VNC Client
- Logging On To Web Proxy
Logging On To Remote Access Portal
To log on to Remote Access Portal:
- In a browser, type https://PublicAddress/portal where PublicAddress is either the public hostname or public IP address of the Untangle Server. For example, https://10.0.0.1/portal.
- Specify your login and password. The Remote Access Portal home page displays. If you do not have a valid login, contact your administrator.
Logging On To RDP Client
For an example, go to Example: Creating a Bookmark To a Desktop.
To log on to a remote desktop:
- From Remote Access Portal home page, click the RDP bookmark. A window appears.
- Click the Launch Remote Desktop Client link. A Java client launches and connects to the remote computer, and the remote computer's operating system prompts you for a username and password.
- Type in your username and password. The remote desktop appears in a Window. From here you can access files and applications on the remote computer just as if you were in front of that remote computer.
Logging On To VNC Client
To log on to VPNC client:
- From Remote Access Portal home page, click the VNC bookmark. A window appears.
- Click the Launch button. A Java VNC application launches.
- Type the VNC server's password. You are now connected to the remote computer.
Note: VNC might not present an error if there is a misconfiguration.
Logging On To Web Proxy
To log on to Web Proxy:
- From Remote Access Portal home page, click the Web Proxy bookmark. A window displays the target site.
- Click on the maximize button in the upper right to open a new window.
About Remote Access Portal Logs
Use the following terms and definitions to understand Remote Access Portal Event Log:
timestamp The time the event took place. action The action that was taken on the traffic. Valid values are block and pass. client The client IP address of the traffic. reason for action The rule that was applied to the traffic. server The intended server IP address of the traffic.













