Skip to main content

BlastShield Documentation

VMware Gateway Installation

This article explains how to install the BlastShield™ Gateway OVA in VMware ESXi 7.

A Gateway deployed on an ESXi platform can be configured to support any of the following addressing modes:

  1. Source+Destination NAT

  2. Destination NAT

  3. MAC Address

  4. VLAN

Gateway addressing modes are explained in more detail here: Gateway Addressing Modes

Gateway use cases are described here: Gateway types and their use cases

Prerequisites

  1. A VMware ESXi7 hypervisor with admin access.

  2. A BlastShield™ Orchestrator with administrator access.

  3. The hardware requires a minimum of one physical NIC for a passive Gateway deployment or at least two physical NICs for an inline Gateway deployment.

  4. By default, the gateway expects to receive an IP address via DHCP.  Manual assignment is also supported during the installation process.

Gateway connectivity requirements

  1. Outbound UDP ports to all required destinations.

  2. Resolution of DNS requests must be supported by the network.

Create a new Gateway in the Orchestrator
Create a new Gateway in the Orchestrator

  1. From the Orchestrator, select "Gateways" from the left Menu.

  2. Select Add New Gateway from the Gateway List.

  3. Enter a Name for the new Gateway.

  4. Set the Addressing Mode:

    1. For MAC Addressing mode, click on MAC Address as the Addressing Mode.

    2. For VLAN adressing mode, click on VLAN.

    3. For Destination NAT addressing mode, click on IP Address (Destination NAT).

    4. For Source and Destination NAT addressing mode, click on IP Address (Source+Destination NAT).

      active-gw-addressing-mode-mac-address.png

  5. Endpoint Interface Settings.

    The following steps apply only to Gateways using NAT addressing modes.

    1. If you are using the Gateway in a single NIC configuration, leave the Endpoint Interface Settings as default.

    2. If you are using the Gateway in a dual NIC configuration, then configure the Endpoint Interface Settings:

      1. If you want the endpoint interface to get it's IP address via DHCP, then leave the configure using DHCP box checked.

      2. If you want to manually set the endpoint interface IP address , then un-check the configure using DHCP box.

        1. Set the Interface address with prefix field to the same IP address as the router which the Gateway is replacing. Use CIDR format.

        2. If you will be onboarding endpoints which are not within the subnet you specified with the interface address above, then enter the IP address of the gateway required to reach the endpoints in the Gateway (optional) field.

        3. If you do not have a route on your internet router to the protected endpoint network, then enable NAT external connections by checking the box.

        4. To enable the Gateway to forward non-endpoint connections from the protected network to the public side of the Gateway, check the Forward connections for non-endpoint addresses box. This will allow devices which are situated on the protected network side of the Gateway, which are not provisioned as endpoints on the Gateway, to forward traffic out through the Gateway.

  6. Leave the Subnet to allocate endpoint addresses from blank if you want the system to allocate the overlay IP address (default). If you want to specify the subnet, then enter it here in CIDR format.

  7. Select Save and Download Invitation.

    1. Select the option Save Invitation to disk to download the invitation file to your local computer. You will need this file later when you install the Gateway.

      active-gw-save-copy-invite-to-disk.png
Download the Gateway OVA file.

  • Download the Gateway OVA file from here and keep it available so that you can upload it to your ESXi server.

Install the BlastShield Gateway™ OVA file on the ESXi client

  • Install the BlastShield Gateway™ OVA file on the ESXi client.

    You will need the Invitation (.bsi) file and the OVA file from the previous steps to Install the Gateway OVA.

    1. From the ESXi host, go to Virtual Machines > Create/Register VM > Create a virtual machine from an OVF/OVA file

      vmware-gw-install-step3-1.png

    2. Give the new Gateway a name and select the BlastShield™ OVA file which you downloaded in the previous step.

      vmware-passive-new-step3-1.png

    3. Leave the default datastore option.

      vmware-passive-new-step3-2.png

    4. Deployment options. Chose one from the two options below.

      1. If you are deploying a Passive Gateway with a single NIC:

        1. Set the Network mapping > Public Network and Protected Network to the same port group on the external physical NIC.

        2. The Deployment type should be set to Orchestrator or passive gateway (NAT).

          vmware-passive-new-step4.png

      2. If you are deploying an Inline Gateway with two or more NICs:

        1. Set the Network mapping > Public Network to the port group on the upstream NIC.

        2. Set the Network mapping > Protected Network to the port group on the downstream NIC.

        3. If you will use additional downstream intefaces, you can add them later in the Gateway console menu.

        4. The Deployment type should be set to Inline Gateway.

          deployment_options_-_inline_gateway.png

      3. Disk provisioning' and 'Power on automatically' should use the default settings.

      4. Click Next.

    5. In Additional Settings, add the contents of the bsi file.

      1. Paste the contents of the Gateway BSI file (from Step 1, above) into the Invitation contents box.

      2. For IP addressing, the default option is that the Gateway will use DHCP.  If you are setting a manually assigned IP address, default gateway and DNS, then enter their IP addresses here . Leaving the boxes blank here will use DHCP.

      3. For a Gateway deployment, do not add an SSH key here. The Orchestrator will provision the Administrator SSH key into the Gateway (this is the SSH key which was configured when the Orchestrator was first installed).

      4. The diagram below shows example manual settings. Please use settings appropriate to your network.

        vmware-passive-new-step5.png

    6. Click next, then click 'Finish' to complete the configuration and launch the VM.

      vmware-passive-new-ready-to-complete.png

    7. You can verify the Gateway has started by watching the console output in the hypervisor. when the Gateway is up, then the status in the Orchestrator will indicate 'online' as shown in the image below.

      vmware-passive-gateway-orchestrator-online.png
Troubleshooting if your Gateway status does not come Online

  1. Ensure you have pasted the contents of the bsi file from the Orchestrator into the Additional settings step of the Create/Register VM procedure when you install the Gateway OVA on the hypervisor.

  2. If your hypervisor environment is not running a DHCP server, make sure you have manually configured an IP address in the Network Configuration section of the Additional settings step of the Create/Register VM procedure on the hypervisor. You can manually enter an IP address, default gateway and DNS server in the Network Configuration.

  3. Ensure there is outbound network access on the hypervisor, so that the Gateway VM can communicate with the BlastShield™ Orchestrator.

Create an endpoint on the Gateway

  1. From within the Orchestrator, select "Gateways" from the left Menu

  2. Select the desired Gateway from the Gateway List

  3. Select "Add New Endpoint"

  4. Enter a name for the new endpoint

  5. Check "Endpoint Enabled" to Enable it when done.

  6. The IP address is auto-populated.

  7. Configure the endpoint Destination field.

    1. If the Gateway is using either of the NAT addressing modes, enter the endpoint's private IPv4 LAN address or hostname.

    2. If the Gateway is using MAC address addressing mode, enter the endpoint's MAC Address.

    3. If the Gateway is using VLAN addressing mode, enter the endpoint's VLAN ID.

  8. For a Gateway using Destination NAT addressing mode, If you want the endpoint to be able to communicate out through the Gateway then check the box marked Allow outbound external network connectivity.

  9. Click on Save Changes to confirm.

  10. If the endpoint is reachable from the Gateway the the status of the endpoint will show as ONLINE.

  11. If it does not show as online, then check the connectivity between the Gateway and the endpoint device.

  12. For endpoints on Gateways which use destination NAT addressing mode only, modify the endpoint's route table so that the endpoint may connect out over the BlastShield™ network. If you are using a Gateway which is set to Source + Destination NAT you can skip this step.

    1. Provision the Gateway endpoint interface address as the default gateway on the endpoint, or provision it as a static route to the BlastShield™ overlay network prefix.

      1. The BlastShield™ overlay network prefix is shown in the network settings/Overlay Subnet settings in the Orchestrator.

      2. You can find the Gateway endpoint interface address from the Orchestrator in the Gateway settings, under Endpoint Interface settings (Dual NIC only) > Interface address with prefix.

Configure an access policy and microsegmentation groups
About Groups

Groups allow you to micro-segment users and endpoints. A group is a logical collection of endpoints and/or users that are grouped together. Groups are connected via policies, which form the foundation for BlastShield access control and segmentation management.

  • Any combination of endpoints and/or users can be grouped together.

  • There is no limit to the number of endpoints and/or users that can be in a group.

  • Endpoints and users can be in one or multiple groups simultaneously.

  • Groups are linked together via policies to provide access between endpoints.

  • By default, endpoints/users cannot access or have visibility to other endpoints/users unless they are granted access via a policy

About Policies

A policy defines how groups can interact. Groups are connected via policies, which form the foundation for BlastShield access control and segmentation management.

  • Each policy will have two sets of groups - "From" and "To".

  • The "From" set is one or more source groups.

  • The "To" set is one or more destination groups.

  • There is no limit to the number of groups in a given policy.

  • "From" Groups will have access to "To" Groups within the policy.

  • "To" Groups will not have access to "From" Groups within the policy.

  • Groups can be in one or multiple policies simultaneously.

groups1.png

Create Groups

  1. From the Orchestrator, select "Groups" from the left menu.

  2. Select "Add New Group" from the Group List.

  3. Enter a name for the new Group.

  4. To add members to the new group, click the "Add Members" button.

    1. If you adding users to the group then select the desired Users which you want to be associated with the Group from the "Users" box.

    2. If you are adding Agents to the group then select the desired Agents which you want to be associated with the Group from the "Agents" box.

    3. If you are adding Gateway Endpoints then select the desired Endpoints from the "Endpoints" box.

    4. Alternatively, you can leave the members list empty and add/modify new members later.

  5. Click "Add Members" to save the members.

  6. Click "Save" to save the new group.

  7. Repeat, if required, to ensure you have one group for your endpoints and one group for your users, which is the minimum you will need in order to define the access policy.

Please refer to the following video, which is an example of creating one group for your users and one group for Host Agents.

Create a Policy to link your Groups
To connect your user groups and protected servers groups, you must link them with a policy as described here:

Note

Users and Agents must be a member of a group for them to be used in a policy.

  1. Select "Policies" from the left menu.

  2. Select "Add New Policy" from the Policy List.

  3. Enter a name for the new Policy.

  4. Select desired "From" Groups to be associated with the new Policy.

  5. Select desired "To" Groups to be associated with the new Policy.

  6. Save the new Policy.

Policies are directional, so that you can control the direction in which connections may be initiated. Typically for remote access use-cases your policy would be from the "user group" to the "server group" so that users may start connections to the servers, but servers cannot start connections to users. You can create bi-directional permissions by using two policies.

The following video shows an example of creating an access Policy between a group of remote workers and a group of servers. The policy gives the remote workers authorisation to access the server group.

In this section: