User Manual
Zero Trust Device Access (web-to-local) - Overview of installed ports
This page allows you to manage and monitor ports for secure web-to-local access, enabling you to connect to applications on your remote devices without opening firewall ports or using a VPN. It provides tools to add, remove, and configure specific ports, ensuring secure and controlled access to your device's services.
Zero Trust Device Access (web-to-local) - Overview of installed ports
Summary
This page provides a centralized view for managing your web-to-local configured ports for remote devices. It allows you to add, delete, and individually configure ports, as well as initiate secure port forwarding sessions. The system handles data processing, manages loading states, and monitors your session and device connection status. Web-to-local access enables secure connections to any application running on your device via specific ports, such as databases, application servers, or SCP, eliminating the need for open firewall ports or Virtual Private Network (VPN) setups. Activation can be done with simple clicks or scheduled starts, ensuring a zero-trust environment where your device remains secure without direct exposure to the internet.
Page Access
You can access this page by navigating to: /devices_web_to_local
Page Functionalities
The page offers several key functionalities to manage your web-to-local connections:
- View Configured Ports: Displays a list of all ports you have set up for web-to-local access.
- Add New Port: Allows you to add a new port to the list. When adding a port, the system verifies if a service is actively listening on that port on your remote device. Please note that ports specifically used for remote desktop (like 3389 and 5900) must be configured through the dedicated 'Remote Desktop' section.
- Delete Port: Provides an option to remove a port from your configured list after a confirmation prompt.
- Configure Port Forwarding: Tapping on an existing port opens a detailed configuration view where you can start or stop the port forwarding service for that specific port. This feature also checks if the port is actively listening before allowing configuration.
- Refresh Port List: A dedicated button allows you to refresh the list of configured ports to ensure you have the most up-to-date information.
- Session Monitoring: The system actively monitors your user session and will notify you if your session is about to expire or has expired, ensuring secure access.
- Web-to-Local Usage Statistics: Displays your daily usage of web-to-local minutes against your maximum allowed minutes as per your license. If you reach your limit, you will be prompted to upgrade your license.
Scenario Executions
Possible usage steps within this page
Scenario: Add a new valid port
- Click the "Add Port" button.
- In the dialog, enter the desired port number (e.g., 8080) in the "Port Number" field.
- Click the "Add" button in the dialog to confirm.
Expected Outcome: The new port will appear in the list of configured ports, and a success message will be displayed.
Scenario: Delete an existing port
- Locate the port you wish to delete in the list.
- Click the red "Delete" icon next to the port.
- Confirm the deletion in the prompt by clicking "Delete".
Expected Outcome: The selected port will be removed from the list, and a success message will be displayed.
Scenario: Start port forwarding for an active port
- Click on an existing port number in the list that you wish to configure.
- The port's configuration view will open.
- If the port forwarding is not already running, click the "Start Port Forwarding" button.
Expected Outcome: The port forwarding status will change to "Running", indicating successful activation.
Scenario: Reload the list of configured ports
- Click the "Reload" icon (circular arrow) next to "Web-to-Local Configured Ports" title.
Expected Outcome: The list of ports will refresh, showing any recent changes.
Possible errors which may occur on this page
Error: Invalid port number entered
- When trying to add a new port, if you enter text, a number outside the valid range (1-65535), or leave the field empty.
Outcome: An error message will appear below the input field, prompting you to enter a valid port number. The port will not be added.
Error: Attempting to add an already configured port
- When trying to add a new port, if you enter a port number that is already present in your configured list.
Outcome: An error message "Port X already exists" will be displayed, and the duplicate port will not be added.
Error: No service listening on the remote port
- When adding a new port, if there is no application or service actively listening on that port on your remote device.
- When clicking on an existing port to configure, if the service on the remote device has stopped listening on that port.
Outcome: A warning message will inform you that "On this port no service is listening" (for adding) or "Port X is not listening" (for configuring), and the operation will not proceed.
Error: Attempting to add remote desktop ports directly
- When trying to add ports 3389 (Windows Remote Desktop) or 5900 (VNC) using the "Add Port" function.
Outcome: A message will advise you to "Configure remote desktop ports in the 'Remote Desktop' section.", and these ports will not be added here.
Error: Web-to-local daily usage limit reached
- If your daily web-to-local usage time, as displayed on the page, reaches or exceeds your licensed maximum minutes.
Outcome: You will be redirected to the license upgrade page, and further web-to-local operations will be temporarily suspended until your usage resets or your license is upgraded.
Error: Error loading configured ports
- If there is an issue retrieving the list of configured ports from the system upon page load.
Outcome: An error message "Error loading configured ports" will be displayed, along with a "Try again" button to reattempt loading the data.
