In this Article

Other Content

Integration Plugin - Guacamole

The Guacamole plugin enables integrated remote connectivity console access to deployed virtual machine instances. Connectivity is supported for the following protocols:

  • SSH
  • RDP

When the Guacamole plugin is enabled, the Connect management operation appears for a virtual machine instance.

Firewall Requirements

The following lists the firewall ports which are required to be configured for this plugin to perform its functions.

Note: Also ensure that security groups are correctly configured to allow incoming connection requests.

Inbound Ports

Port Protocol Source Destination Additional Information
8082, 8083 TCP Broker Consumers

Broker Appliance

HTTPS
Required for remote connectivity to deployed workloads

Outbound Ports

Port Protocol Source Destination Additional Information
22 TCP Broker Appliance

Deployed Workloads

 SSH
SSH access to the virtual machine console
3389 TCP Broker Appliance

Deployed Workloads

RDP
RDP access to the virtual machine console

Enabling the Plugin

  1. Log in to the Broker UI as an administrative user
  2. Navigate to Admin > Plugins

  3. Locate the Guacamole plugin tile - this appears under the Integrations section
  4. If not already enabled, click the ellipses and select Enable
     
  5. Click the Guacamole plugin tile

Settings

There are no settings for this plugin.

Example

In this example, the Guacamole plugin will be used to connect to a Linux virtual machine instance on AWS

When viewing the instance within the deployment details, the Connect option is available.

Connectivity options are provided and include:

  • Protocol: Protocol which the instance is listening on for remote console - SSH, RDP
  • IP Address: The IP address to connect to - Public or Private
  • Authentication Method: How to authenticate with the instance - SSH Key (stored/prompted), Username and Password (stored/prompted)

 A connection to the virtual machine instance is established within a new tab in the browser.