Some customers would like to review and analyze data collected by the Cloudamize Agents before beginning their assessment. This guide outlines the steps necessary to do this.

Before Agents send data, they must register themselves with am.cloudamize.com in the US or am-de.cloudamize.com in Europe. After they have registered themselves they will begin sending data to am.cloudamize.com/fileUploadV3.

To review and analyze the data the Agents collect without sending any data to Cloudamize, you can use a proxy server that captures traffic to /fileUploadV3 while allowing all other traffic to continue to am.cloudamize.com or am-de.cloudamize.com.

As an example, instructions for setting up an NGINX proxy are available here.

After setting up the proxy, install Cloudamize Agents using the following “no-op” customer key: 44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c

Note: Data sent to Cloudamize using this “no-op” customer key will be rejected by Cloudamize. Because of this, Agents installed with the “no-op” customer key will need to be uninstalled and the Agent will need to be reinstalled with a valid customer key before beginning an assessment.

Agentless

You can download the Agentless installer here.

When prompted for your Customer Key, please use the following: 44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c

To install the Agent from the command prompt as administrator use the following:

msiexec /i <Name of the downloaded .msi> customerkey=44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c USE_PROXY=1 HTTPS_PROXY="https://www.your_own_proxy.com" PROXY_PORT="your_proxy_server_port" /qn
CODE

If your proxy server requires authentication, use the following, updated command:

msiexec /i <Name of the downloaded .msi> customerkey=44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c USE_PROXY=1 HTTPS_PROXY="https://www.your_own_proxy.com" PROXY_PORT="your_proxy_server_port" USE_PROXY_CREDENTIAL=1 PROXY_USER_NAME="user_name" PROXY_PASSWORD="password" /qn
CODE

Windows Agent

You can download the Windows agent here.

When prompted for your Customer Key, please use the following: 44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c

To install the Agent from the command prompt as administrator use the following:

msiexec /i <Name of the downloaded .msi> customerkey=44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c USE_PROXY=1 HTTPS_PROXY="https://www.your_own_proxy.com" PROXY_PORT="your_proxy_server_port" /qn
CODE

If your proxy server requires authentication, use the following, updated command:

msiexec /i <Name of the downloaded .msi> customerkey=44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c USE_PROXY=1 HTTPS_PROXY="https://www.your_own_proxy.com" PROXY_PORT="your_proxy_server_port" USE_PROXY_CREDENTIAL=1 PROXY_USER_NAME="user_name" PROXY_PASSWORD="password" /qn
CODE

Linux Agent

Prerequisites:

  • One of the following OSes:

    • Red Hat Enterprise Linux Server release 7.0 or higher

    • Oracle Linux 6.5 or higher

    • Ubuntu 16.04 or higher

    • CentOS release 7 or higher

    • Debian GNU/Linux 8.0 or higher

    • Amazon Linux AMI release 2013.03 or higher

    • Fedora release 12 or higher

    • Suse Linux 11 or higher

  • supported version of OpenSSL

  • Root and/or Wheel Group access

  • 350 MB persistent storage

  • The Install script requires wget to retrieve content, and curl to test/verify access to our data collection servers:

  • For assessments on console.cloudamize.com or dashboard-partners.cloudamize.com our data collection servers are at am.cloudamize.com for US infrastructure and am-de.cloudamize.com for EU infrastructure over port 443, either directly or through a corporate proxy.

Note: The Linux agent/agentless approach requires a user with root permissions to get PID-to-network mapping, certain hardware details, and data on logical/physical disk volumes. Become root user either through "sudo -s" or "su", most systems use sudo.  

Procedure:

Step 1:  Export your customer key.

export CLOUDAMIZE_CUSTOMER_KEY=44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c
CODE

Step 2:  Execute the following command to install the Cloudamize Agent and configure it to route the data through your own proxy server:

sh <(curl --proxy https://www.yourproxy.com:proxy_port -X POST https://am.cloudamize.com/cxf/downloadFileV3 -H 'content-type: multipart/form-data' -F custkey=44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c -F filename=installCloudamizeAgentV2.sh) <https://www.your_own_proxy.com> <proxy_port>
CODE

If your proxy server requires authentication, use the following, updated command.

sh <(curl --proxy https://www.yourproxy.com:proxy_port --proxy-user username:password -X POST https://am.cloudamize.com/cxf/downloadFileV3 -H 'Content-Type: multipart/form-data' -F custkey=44ac3d540b1a180a69b3ac4789413d0bc272f9aed9ecc86512733b8ad1cd0c1c -F filename=installCloudamizeAgentV2.sh ) <https://www.your_own_proxy.com> <proxy_port> <user_name> <password>
CODE

Click here for steps to troubleshoot installation issues. 

Click here for instructions on how to uninstall the linux agents.