arrow_back

Rate Limiting with Cloud Armor

Join Sign in
Test and share your knowledge with our community!
done
Get access to over 700 hands-on labs, skill badges, and courses

Rate Limiting with Cloud Armor

Lab 1 hour 30 minutes universal_currency_alt 1 Credit show_chart Introductory
Test and share your knowledge with our community!
done
Get access to over 700 hands-on labs, skill badges, and courses

GSP975

Google Cloud self-paced labs logo

Overview

Google Cloud HTTP(S) load balancing is implemented at the edge of Google's network in Google's points of presence (POP) around the world. User traffic directed to an HTTP(S) load balancer enters the POP closest to the user and is then load balanced over Google's global network to the closest backend that has sufficient capacity available.

Cloud Armor IP allowlist/denylist enable you to restrict or allow access to your HTTP(S) load balancer at the edge of the Google Cloud, as close as possible to the user and to malicious traffic. This prevents malicious users or traffic from consuming resources or entering your virtual private cloud (VPC) networks.

In this lab, you configure an HTTP Load Balancer with global backends, as shown in the diagram below. Then, you'll stress test the Load Balancer and add a Cloud Armor rate limiting policy to restrict based on IP.

Network diagram

What you'll learn

In this lab, you learn how to perform the following tasks:

  • Create HTTP and health check firewall rules
  • Configure two instance templates
  • Create two managed instance groups
  • Configure an HTTP Load Balancer with IPv4 and IPv6
  • Stress test an HTTP Load Balancer
  • Add a Cloud Armor rate limiting policy to restrict based on IP
  • Verify that traffic is getting blocked when running a stress test from a VM

Setup and requirements

Before you click the Start Lab button

Read these instructions. Labs are timed and you cannot pause them. The timer, which starts when you click Start Lab, shows how long Google Cloud resources will be made available to you.

This hands-on lab lets you do the lab activities yourself in a real cloud environment, not in a simulation or demo environment. It does so by giving you new, temporary credentials that you use to sign in and access Google Cloud for the duration of the lab.

To complete this lab, you need:

  • Access to a standard internet browser (Chrome browser recommended).
Note: Use an Incognito or private browser window to run this lab. This prevents any conflicts between your personal account and the Student account, which may cause extra charges incurred to your personal account.
  • Time to complete the lab---remember, once you start, you cannot pause a lab.
Note: If you already have your own personal Google Cloud account or project, do not use it for this lab to avoid extra charges to your account.

How to start your lab and sign in to the Google Cloud console

  1. Click the Start Lab button. If you need to pay for the lab, a pop-up opens for you to select your payment method. On the left is the Lab Details panel with the following:

    • The Open Google Cloud console button
    • Time remaining
    • The temporary credentials that you must use for this lab
    • Other information, if needed, to step through this lab
  2. Click Open Google Cloud console (or right-click and select Open Link in Incognito Window if you are running the Chrome browser).

    The lab spins up resources, and then opens another tab that shows the Sign in page.

    Tip: Arrange the tabs in separate windows, side-by-side.

    Note: If you see the Choose an account dialog, click Use Another Account.
  3. If necessary, copy the Username below and paste it into the Sign in dialog.

    {{{user_0.username | "Username"}}}

    You can also find the Username in the Lab Details panel.

  4. Click Next.

  5. Copy the Password below and paste it into the Welcome dialog.

    {{{user_0.password | "Password"}}}

    You can also find the Password in the Lab Details panel.

  6. Click Next.

    Important: You must use the credentials the lab provides you. Do not use your Google Cloud account credentials. Note: Using your own Google Cloud account for this lab may incur extra charges.
  7. Click through the subsequent pages:

    • Accept the terms and conditions.
    • Do not add recovery options or two-factor authentication (because this is a temporary account).
    • Do not sign up for free trials.

After a few moments, the Google Cloud console opens in this tab.

Note: To view a menu with a list of Google Cloud products and services, click the Navigation menu at the top-left. Navigation menu icon

Activate Cloud Shell

Cloud Shell is a virtual machine that is loaded with development tools. It offers a persistent 5GB home directory and runs on the Google Cloud. Cloud Shell provides command-line access to your Google Cloud resources.

  1. Click Activate Cloud Shell Activate Cloud Shell icon at the top of the Google Cloud console.

When you are connected, you are already authenticated, and the project is set to your Project_ID, . The output contains a line that declares the Project_ID for this session:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud is the command-line tool for Google Cloud. It comes pre-installed on Cloud Shell and supports tab-completion.

  1. (Optional) You can list the active account name with this command:
gcloud auth list
  1. Click Authorize.

Output:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. (Optional) You can list the project ID with this command:
gcloud config list project

Output:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Note: For full documentation of gcloud, in Google Cloud, refer to the gcloud CLI overview guide.

Task 1. Configure HTTP and health check firewall rules

Configure firewall rules to allow HTTP traffic to the backends and TCP traffic from the Google Cloud health checker.

Create the HTTP firewall rule

Create a firewall rule to allow HTTP traffic to the backends.

  1. In the Cloud Console, navigate to Navigation menu (Navigation menu icon) > VPC network > Firewall.

  2. Notice the existing ICMP, internal, RDP, and SSH firewall rules.

    Each Google Cloud project starts with the default network and these firewall rules.

  3. Click Create Firewall Rule.

  4. Set the following values, leave all other values at their defaults:

    Property Value (type value or select option as specified)
    Name default-allow-http
    Network default
    Targets Specified target tags
    Target tags http-server
    Source filter IPv4 Ranges
    Source IP ranges 0.0.0.0/0
    Protocols and ports Specified protocols and ports, and then check tcp, type: 80
    Note: Make sure to include the /0 in the Source IP ranges to specify all networks.
  5. Click Create.

Create the health check firewall rules

Health checks determine which instances of a load balancer can receive new connections. For HTTP load balancing, the health check probes to your load balanced instances come from addresses in the ranges 130.211.0.0/22 and 35.191.0.0/16. Your firewall rules must allow these connections.

  1. Still in the Firewall rules page, click Create Firewall Rule.

  2. Set the following values, leave all other values at their defaults:

    Property Value (type value or select option as specified)
    Name default-allow-health-check
    Network default
    Targets Specified target tags
    Target tags http-server
    Source filter IPv4 Ranges
    Source IP ranges 130.211.0.0/22, 35.191.0.0/16
    Protocols and ports Specified protocols and ports, and then check tcp
    Note: Make sure to enter the two Source IP ranges one-by-one and press SPACE in between them.
  3. Click Create.

Click Check my progress to verify the objective. Configure HTTP and health check firewall rules

Task 2. Configure instance templates and create instance groups

A managed instance group uses an instance template to create a group of identical instances. Use these to create the backends of the HTTP Load Balancer.

Configure the instance templates

An instance template is an API resource that you use to create VM instances and managed instance groups. Instance templates define the machine type, boot disk image, subnet, labels, and other instance properties. Create one instance template for and one for .

  1. In the Cloud Console, navigate to Navigation menu (Navigation menu icon) > Compute Engine > Instance templates, and then click Create instance template.
  2. For Name, type -template.
  3. For Series, select E2.
  4. Click Networking, disks, security, management, sole-tenancy.

Identity and API access page

  1. Click the Management tab.

Management tab

  1. Under Metadata, , click +ADD ITEM specify the following:

    Key Value
    startup-script-url gs://cloud-training/gcpnet/httplb/startup.sh
Note: The startup-script-url specifies a script that executes when instances are started. This script installs Apache and changes the welcome page to include the client IP and the name, region, and zone of the VM instance. Feel free to explore this script.
  1. Click Networking, for Network tags, type http-server.

  2. For Network interfaces expand default network and set the following values.

    Property Value (type value or select option as specified)
    Network default
    Subnet default ()
Note: The network tag http-server ensures that the HTTP and Health Check firewall rules apply to these instances.
  1. Click Create.
  2. Wait for the instance template to be created.

Now create another instance template for subnet-b by copying -template:

  1. Click on -template and then click on the CREATE SIMILAR option from the top.
  2. For Name, type -template.
  3. Click Networking, disks, security, management, sole-tenancy.
  4. Click Networking, expand default network.
  5. For Subnet, select default ().
  6. Click Create.

Create the managed instance groups

Create a managed instance group in and one in .

  1. In the Navigation menu (Navigation menu icon) click Compute Engine > Instance groups in the left menu.

  2. Click Create instance group.

  3. Set the following values, leave all other values at their defaults:

    Property Value (type value or select option as specified)
    Name -mig
    Location Multiple zones
    Region
    Instance template -template
    Autoscaling > Autoscaling signals (click the dropdown icon to edit) > Signal type CPU utilization
    Target CPU utilization 80, click Done.
    Initialization period 45
    Minimum number of instances 1
    Maximum number of instances 5
    Note: Managed instance groups offer autoscaling capabilities that allow you to automatically add or remove instances from a managed instance group based on increases or decreases in load. Autoscaling helps your applications gracefully handle increases in traffic and reduces cost when the need for resources is lower. You just define the autoscaling policy and the autoscaler performs automatic scaling based on the measured load.
  4. Click Create.

Now repeat the same procedure for create a second instance group for -mig in :

  1. Click Create Instance group.

  2. Set the following values, leave all other values at their defaults:

    Property Value (type value or select option as specified)
    Name -mig
    Location Multiple zones
    Region
    Instance template -template
    Autoscaling > Autoscaling signals (click the dropdown icon to edit) > Signal type CPU utilization
    Target CPU utilization 80, click Done.
    Initialization period 45
    Minimum number of instances 1
    Maximum number of instances 5
  3. Click Create.

Click Check my progress to verify the objective. Configure instance templates and instance group

Verify the backends

Verify that VM instances are being created in both regions and access their HTTP sites.

  1. Still in Compute Engine, click VM instances in the left menu.

  2. Notice the instances that start with -mig and -mig.

    These instances are part of the managed instance groups.

  3. Click on the External IP of an instance of -mig.

    You should see the Client IP (your IP address), the Hostname (starts with -mig) and the Server Location (a zone in ).

  4. Click on the External IP of an instance of -mig.

    You should see the Client IP (your IP address), the Hostname (starts with -mig) and the Server Location (a zone in ).

Note: The Hostname and Server Location identifies where the HTTP Load Balancer sends traffic.

Task 3. Configure the HTTP Load Balancer

Configure the HTTP Load Balancer to balance traffic between the two backends (-mig in and -mig in ), as illustrated in the network diagram:

Network diagram

Start the configuration

  1. In the Cloud Console, click Navigation menu (Navigation menu icon) > click Network Services > Load balancing, and then click Create load balancer.

  2. Under Application Load Balancer (HTTP/S), click on Start configuration.

    HTTP(S) Load Balancing section and Start configuration option highlighted

  3. Select From Internet to my VMs or serverless services, and click Continue.

  4. Set the Name to http-lb.

Configure the backend

Backend services direct incoming traffic to one or more attached backends. Each backend is composed of an instance group and additional serving capacity metadata.

  1. Click on Backend configuration.

  2. Click Backend services & backend buckets dropdown, click Create a backend service.

  3. Set the following values, leave all other values at their defaults:

    Property Value (select option as specified)
    Name http-backend
    Instance group -mig
    Port numbers 80
    Balancing mode Rate
    Maximum RPS 50
    Capacity 100
    Note: This configuration means that the load balancer attempts to keep each instance of -mig at or below 50 requests per second (RPS).
  4. Click Done.

  5. Click Add a backend.

  6. Set the following values, leave all other values at their defaults:

    Property Value (select option as specified)
    Instance group -mig
    Port numbers 80
    Balancing mode Utilization
    Maximum backend utilization 80
    Capacity 100
    Note: This configuration means that the load balancer attempts to keep each instance of -mig at or below 80% CPU utilization.
  7. Click Done.

  8. For Health Check, select Create a health check.

  9. Set the following values, leave all other values at their defaults:

    Property Value (select option as specified)
    Name http-health-check
    Protocol TCP
    Port 80
    Note: Health checks determine which instances receive new connections. This HTTP health check polls instances every 5 seconds, waits up to 5 seconds for a response and treats 2 successful or 2 failed attempts as healthy or unhealthy, respectively.
  10. Click Save.

  11. Check the Enable Logging box.

  12. Set the Sample Rate to 1:

  13. Click Create to create the backend service, click OK.

Configure the frontend

The host and path rules determine how your traffic will be directed. For example, you could direct video traffic to one backend and static traffic to another backend. However, you are not configuring the Host and path rules in this lab.

  1. Click on Frontend configuration.

  2. Specify the following, leaving all other values at their defaults:

    Property Value (type value or select option as specified)
    Protocol HTTP
    IP version IPv4
    IP address Ephemeral
    Port 80
  3. Click Done.

  4. Click Add Frontend IP and port.

  5. Specify the following, leaving all other values at their defaults:

    Property Value (type value or select option as specified)
    Protocol HTTP
    IP version IPv6
    IP address Auto-allocate
    Port 80
  6. Click Done.

Note: HTTP(S) load balancing supports both IPv4 and IPv6 addresses for client traffic. Client IPv6 requests are terminated at the global load balancing layer, then proxied over IPv4 to your backends.

Review and create the HTTP Load Balancer

  1. Click Review and finalize.

    Review and finalize option

  2. Review the Backend services and Frontend.

    Frontend and Backend sections

  3. Click Create.

  4. Wait for the load balancer to be created.

  5. Click on the name of the load balancer (http-lb).

  6. Note the IPv4 and IPv6 addresses of the load balancer for the next task. They will be referred to as [LB_IP_v4] and [LB_IP_v6], respectively.

Note: The IPv6 address is the one in hexadecimal format.

Click Check my progress to verify the objective. Configure the HTTP Load Balancer

Task 4. Test the HTTP Load Balancer

Now that you created the HTTP Load Balancer for your backends, verify that traffic is forwarded to the backend service.

Access the HTTP Load Balancer

  • To test IPv4 access to the HTTP Load Balancer, open a new tab in your browser and navigate to http://[LB_IP_v4]. Make sure to replace [LB_IP_v4] with the IPv4 address of the load balancer.
Note: It might take up to 5 minutes to access the HTTP Load Balancer. In the meantime, you might get a 404 or 502 error. Keep trying until you see the page of one of the backends. Note: Depending on your proximity to and , your traffic is either forwarded to a -mig or -mig instance.

If you have a local IPv6 address, try the IPv6 address of the HTTP Load Balancer by navigating to http://[LB_IP_v6]. Make sure to replace [LB_IP_v6] with the IPv6 address of the load balancer.

Stress test the HTTP Load Balancer

Create a new VM to simulate a load on the HTTP Load Balancer using siege. Then, determine if traffic is balanced across both backends when the load is high.

  1. In the Console, navigate to Navigation menu (Navigation menu icon) > Compute Engine > VM instances.

  2. Click Create instance.

  3. Set the following values, leave all other values at their defaults:

    Property Value (type value or select option as specified)
    Name siege-vm
    Region
    Zone
    Series E2
Note: Given that is closer to than to , traffic should be forwarded only to -mig (unless the load is too high).
  1. Click Create.
  2. Wait for the siege-vm instance to be created.
  3. For siege-vm, click SSH to launch a terminal and connect.
  4. Run the following command, to install siege:
sudo apt-get -y install siege

Click Check my progress to verify the objective. Test the HTTP Load Balancer

  1. To store the IPv4 address of the HTTP Load Balancer in an environment variable, run the following command, replacing [LB_IP_v4] with the IPv4 address:
export LB_IP=[LB_IP_v4]
  1. To simulate a load, run the following command:
siege -c 250 http://$LB_IP

The output should look like this:

New configuration template added to /home/cloudcurriculumdeveloper/.siege Run siege -C to view the current settings in that file
  1. In the Cloud Console, on the Navigation menu (Navigation menu icon), click Network Services > Load balancing.
  2. Click Backends.
  3. Click http-backend.
  4. Navigate to http-lb.
  5. Click on the Monitoring tab.
  6. Monitor the Frontend Location (Total inbound traffic) between North America and the two backends for 2 to 3 minutes.

At first, traffic should just be directed to -mig but as the RPS increases, traffic is also directed to -mig.

Monitoring graph

This demonstrates that by default traffic is forwarded to the closest backend but if the load is very high, traffic can be distributed across the backends.

  1. Return to the SSH terminal of siege-vm.
  2. Press CTRL+C to stop the siege.

Task 5. Create Cloud Armor rate limiting policy

In this section you will use Cloud Armor to denylist the siege-vm from accessing the HTTP Load Balancer by setting a rate limiting policy.

  1. In Cloud Shell, create security policy via gcloud:
gcloud compute security-policies create rate-limit-siege \ --description "policy for rate limiting"
  1. Next, add a rate limiting rule:
gcloud beta compute security-policies rules create 100 \ --security-policy=rate-limit-siege \ --expression="true" \ --action=rate-based-ban \ --rate-limit-threshold-count=50 \ --rate-limit-threshold-interval-sec=120 \ --ban-duration-sec=300 \ --conform-action=allow \ --exceed-action=deny-404 \ --enforce-on-key=IP
  1. Attach the security policy to the backend service http-backend:
gcloud compute backend-services update http-backend \ --security-policy rate-limit-siege --global
  1. In the Console, navigate to Navigation menu > Network Security > Cloud Armor.

  2. Click rate-limit-siege. Your policy should resemble the following:

rate-limit-security-policy page

Click Check my progress to verify the objective. Create Cloud Armor Rate Limiting Policy

Task 6. Verify the security policy

  1. Return to the SSH terminal of siege-vm.

  2. Run a curl against the LB IP to verify you can still connect to it, should receive a 200 response:

curl http://$LB_IP
  1. In the SSH terminal of siege-vm, to simulate a load, run the following command:
siege -c 250 http://$LB_IP

The command will not generate any output.

  1. Explore the security policy logs to determine if this traffic is also blocked.

  2. In the Console, navigate to Navigation menu > Network Security > Cloud Armor.

  3. Click rate-limit-siege.

  4. Click Logs.

  5. Click View policy logs.

  6. On the Logging page, make sure to clear all the text in the Query preview.

  7. Select resource to Application Load Balancer > http-lb-forwarding-rule > http-lb then click Apply.

  8. Now click Run Query.

  9. Expand a log entry in Query results.

    Query results page

  10. Expand httpRequest.

The request should be from the siege-vm IP address. If not, expand another log entry.

  1. Expand jsonPayload.

  2. Expand enforcedSecurityPolicy.

    Query results page

Notice that the configuredAction is to DENY with the name rate-limit-siege.

Note: Cloud Armor security policies create logs that can be explored to determine when traffic is denied and when it is allowed, along with the source of the traffic.

Congratulations!

You configured an HTTP Load Balancer with backends in and . Then, you stress tested the Load Balancer with a VM and denylisted the IP address via rate limiting with Cloud Armor. You were able to explore the security policy logs to identify why the traffic was blocked.

Next steps / Learn more

For information on the basic concepts of Cloud Armor, refer to Cloud Armor Documentation.

For more information on Load Balancing, refer to Load Balancing.

Google Cloud training and certification

...helps you make the most of Google Cloud technologies. Our classes include technical skills and best practices to help you get up to speed quickly and continue your learning journey. We offer fundamental to advanced level training, with on-demand, live, and virtual options to suit your busy schedule. Certifications help you validate and prove your skill and expertise in Google Cloud technologies.

Manual Last Updated January 30, 2024

Lab Last Tested January 30, 2024

Copyright 2024 Google LLC All rights reserved. Google and the Google logo are trademarks of Google LLC. All other company and product names may be trademarks of the respective companies with which they are associated.