Set up Broker VM on Google Cloud Platform (GCP) ↗

Learn more about how to set up your Cortex XSIAM Broker VM on Google Cloud Platform.

You can deploy the Broker VM on Google Cloud Platform. The Broker VM allows communication with external services through the installation and setup of applets such as the Syslog collector applet.

To set up the Broker VM on the Google Cloud Platform, install the VMDK image provided in Cortex XSIAM.

Prerequisite

  • Download a Cortex XSIAM Broker VM VMDK image. For more information, see the virtual machine compatibility requirements in Set up and configure Broker VM.
  • To complete the set up, you must have G Cloud installed and have an authenticated user account.

Perform the following procedures in the order listed below.

Create a Google Cloud Storage bucket in G Cloud

From G Cloud, create a Google Cloud Storage bucket to store the Broker VM image.

  1. Create a project in GCP. Enable Google Cloud Storage, for example, brokers-project. Define a default network.
  2. Create a bucket, such as broker-vms.

Set up the GCP project

Open a command prompt and run the following:

gcloud config set project <project-id>

Upload the VMDK image to the Google Cloud Storage bucket

Upload the VMDK image to the bucket, run the following:

gsutil cp </path/to/broker.vmdk> gs://<bucket-name>

Import the GCP image

You can import the GCP image using either G Cloud CLI or Google Cloud console.

Note

The import tool uses Cloud Build API, which must be enabled in your project. For the import to work, Cloud Build service account must have compute.admin and iam.serviceAccountUser roles. When using the Google Cloud console to import the image, you will be prompted to add these permissions automatically.

Danger

Before importing a GCP image using the gcloud CLI, ensure that you update the Google Cloud components to version 371.0.0 and above using the following command:

gcloud components update

The following command uses the minimum required parameters. For more information on permissions and available parameters, refer to the Google Cloud SDK.

Open a command prompt and run the following:

gcloud compute images import <VMDK image> --data-disk --source-file="gs://<image path>" --network=<network_name> --subnet=<subnet_name> --zone=<region> --async

Create a new instance of the image

When the Google Compute completes the image creation, create a new instance.

  1. In Google Cloud Platform, select Compute Engine → VM instances.
  2. Select Create instance.
  3. Under Boot disk, choose Custom images. Select the image you created.
  4. Configure the instance for your workload:
    • Use e2-standard-2 for Agent Proxy only.
    • Use e2-standard-4 for multiple applets.

Allow the 4443 port in your firewall configuration

  1. In the Google Cloud menu, select VPC network → Firewall. Select Create firewall rule.
  2. Set the rule parameters:
    • Name: Enter a name for the rule.
    • Network: Select the Broker VM network.
    • Direction of traffic: Select Ingress.
    • Targets: Select All instances in the network.
    • Source IPv4 ranges: Enter the allowed client IP range. Use 0.0.0.0/0 to allow all addresses.
    • TCP: Enter 4443.
  3. Select Create. The rule appears under VPC firewall rules.

Verify that the firewall rule is assigned to the Broker VM

  1. In the Google Cloud menu, select Compute Engine → VM instances.
  2. For the Broker VM, select More actions (⋮) → View network details.
  3. Under Firewall and routes details, select Firewalls.
  4. Verify that the firewall rule appears.

You can now connect to the Broker VM web console using the Broker VM IP address. Connect with https over port 4443 using the format https://<ip address>:4443.