Table of contents

Install the agent on Amazon EC2 and WorkSpaces

You can protect existing Amazon EC2 instances and Amazon WorkSpaces with Workload Security.

If instead you want to:

Note that the agent only supports Amazon WorkSpaces Windows desktops—it does not support Linux desktops.

To protect your existing Amazon EC2 instances and Amazon WorkSpaces with Workload Security, follow these steps:

  1. Add your AWS accounts to Workload Security
  2. Configure the activation type
  3. Open ports
  4. Deploy agents to your Amazon EC2 instances and WorkSpaces
  5. Verify that the agent was installed and activated properly
  6. Assign a policy

Add your AWS accounts to Workload Security

You need to add your AWS account or accounts to Workload Security. These AWS accounts contain the Amazon EC2 instances and Amazon WorkSpaces that you want to protect with Workload Security.

See About adding AWS accounts for details.

After adding your AWS accounts:

  • Your existing Amazon EC2 instances and Amazon WorkSpaces appear in the Workload Security console. If no agent is installed on them, they appear with a Status of Unmanaged (Unknown) and a grey dot next to them. If an agent was already installed, they appear with a Status of Managed (Online) and green dot next to them.
  • Any new Amazon EC2 instances or Amazon WorkSpaces that you launch through AWS under this AWS account are auto-detected by Workload Security and displayed in the list of computers.

Configure the activation type

Activation is the process of registering an agent with a manager. You need to indicate whether to allow agent-initiated activation. If not, only manager-initiated activation is allowed.

  1. Log in to the Workload Security console.
  2. Click Administration at the top.
  3. On the left, click System Settings.
  4. In the main pane, make sure the Agents tab is selected.
  5. Select or deselect Allow Agent-Initiated Activation, noting that:
    • Agent-initiated activation does not require you to open up inbound ports to your Amazon EC2 instances or Amazon WorkSpaces, while manager-initiated activation does.
    • If agent-initiated activation is enabled, manager-initiated activation continues to work.
  6. If you selected Allow Agent-Initiated Activation, also select Reactivate cloned Agents, and Enable Reactivate unknown Agents. See Agent settings for more information.
  7. Click Save.
  8. If you are using Amazon WorkSpaces, and you did not allow agent-initiated activation, manually assign an elastic IP address to each WorkSpace now, before proceeding with further steps on this page. This gives each Amazon WorkSpace a public IP that can be contacted by other computers. This is not required for EC2 instances because they already use public IP addresses.
    Systems Setting page with Agents tab displayed

Open ports

You need to make sure that the necessary ports are open to your Amazon EC2 instances or Amazon WorkSpaces.

To open ports:

  1. Open ports to your Amazon EC2 instances, as follows:

    a. Log in to your Amazon Web Services Console.
    b. Go to EC2 > Network & Security > Security Groups.
    c. Select the security group that is associated with your EC2 instances, then select Actions > Edit outbound rules.
    d. Open the necessary ports. See Which ports should be opened? below.

  2. Open ports to your Amazon WorkSpaces, as follows:

    a. Go to the firewall software that is protecting your Amazon WorkSpaces, and open the ports listed above.

You have now opened the necessary ports so that the agent and Workload Security can communicate.

Which ports should be opened?

Generally:

  • Agent-to-manager communication requires you to open the outbound TCP port (443 or 80, by default).
  • Manager-to-agent communication requires you to open an inbound TCP port (4118).

More specifically:

  • If you enabled Allow Agent-Initiated Activation, you need to open the outbound TCP port (443 or 80, by default) .
  • If you disabled Allow Agent-Initiated Activation, you need to open the inbound TCP port of 4118.

Deploy agents to your Amazon EC2 instances and WorkSpaces

You need to deploy agents onto your Amazon EC2 instances and Amazon WorkSpaces.

  • Option 1: Use a deployment script to install, activate, and assign a policy.

    Use Option 1 if you need to deploy agents to many Amazon EC2 instances and Amazon WorkSpaces.

    With this option, you must run a deployment script on the Amazon EC2 instances or Amazon WorkSpaces. The script installs and activates the agent and then assigns a policy. See Use deployment scripts to add and protect computers for details.

    OR

  • Option 2: Manually install and activate.

    Use Option 2 if you only need to deploy agents to a few EC2 instances and Amazon WorkSpaces.

You have now installed and activated the agent on an Amazon EC2 instance or Amazon WorkSpace. A policy may or may not have been assigned, depending on the option you chose. If you chose Option 1 (you used a deployment script), a policy was assigned to the agent during activation. If you chose Option 2 (you manually installed and activated the agent), then no policy has been assigned, and you will need to assign one following the instructions further down on this page.

Verify that the agent was installed and activated{#Step2}

You should verify that your agent was installed and activated properly:

  1. Log in to the Workload Security console.
  2. Click Computers at the top.
  3. On the navigation pane on the left, make sure your Amazon EC2 instance or Amazon WorkSpace appears under Computers > your_AWS_account > your_region . Look for WorkSpaces in a WorkSpaces sub-node.
  4. In the main pane, make sure your Amazon EC2 instances or Amazon WorkSpaces appear with a Status of Managed (Online) and a green dot next to them.

Assign a policy

Skip this step if you ran a deployment script to install and activate the agent. The script already assigned a policy so no further action is required.

If you installed and activated the agent manually, you must assign a policy to the agent. Assigning the policy sends the necessary protection modules to the agent so that your computer is protected.

To assign a policy, see Assign a policy to a computer.

After assigning a policy, your Amazon EC2 instance or Amazon WorkSpace is now protected.