Bucket IP filtering

This page provides an overview of bucket IP filtering including its benefits, how it works, supported locations, and limitations to consider.

Overview

Cloud Storage offers bucket IP filtering to manage access to your data stored in buckets.

Bucket IP filtering is a network security mechanism that restricts access to a bucket based on the source IP address of the request and secures your data from unauthorized access.

The bucket IP filtering feature for Cloud Storage enables fine-grained access control based on IPv4 or IPv6 address ranges or the Trusted Cloud by S3NS Virtual Private Cloud. You can configure a list of IP ranges at the bucket level and all incoming requests to the bucket are restricted to the configured IP ranges and VPCs. This feature provides a way to secure sensitive data in Cloud Storage buckets and prevent unauthorized access from specific IP addresses or VPCs.

Benefits

Bucket IP filtering for Cloud Storage offers the following benefits:

  • Fine-grained access control: Restrict access to your Cloud Storage buckets based on the specific IP address (IPv4 or IPv6) or Trusted Cloud by S3NS Virtual Private Cloud of the requester. Bucket IP filtering acts as a strong network-level security layer, preventing unauthorized access from unknown or untrusted sources.

  • Enhanced security: By limiting access to authorized IP addresses or VPCs, you can reduce the risk of unauthorized access, data breaches, and malicious activity.

  • Flexible configuration: You can configure and manage lists of IP ranges at the bucket level, tailoring the access control to your specific requirements.

How does it work?

Bucket IP filtering helps you control access to your buckets by defining rules that permit requests from specific IPv4 and IPv6 addresses. Incoming requests are evaluated against these rules to determine access permissions.

A bucket IP filtering rule includes the following configurations:

  • Public internet access: You can define rules to manage requests originating from the public internet (outside any configured Virtual Private Cloud). These rules specify allowed IPv4 or IPv6 addresses using CIDR ranges, authorizing inbound traffic from those sources.

  • Virtual private cloud (VPC) access: For granular control over access from specific VPC networks, you can define rules for each network. These rules include allowed IP ranges, enabling precise management of access from your virtual network infrastructure.

  • Service agent access: Trusted Cloud by S3NS service agents retain access to buckets, even with an active IP filter configuration. You can set up a configuration that allows Trusted Cloud by S3NS services such as BigLake, Storage Insights, Vertex AI, and BigQuery to bypass the IP filter validation when accessing your buckets.

Limitations

Bucket IP filtering has the following limitations:

  • Maximum number of IP CIDR blocks: You can specify a maximum of 200 IP CIDR blocks across public and VPC networks in the IP filter rule for a bucket.

  • Maximum number of VPC networks: You can specify a maximum of 25 VPC networks in the IP filter rules for a bucket.

  • Regional endpoints: Regional endpoints work with IP filtering only when you use Private Service Connect.

  • IPv6 support: IP filtering with gRPC direct path is not supported on an IPv4 VM. When you use IP filtering with gRPC direct path, you must enable IPv6 support on the VPC network.

  • Blocked Trusted Cloud by S3NS services: Enabling IP filtering on Cloud Storage buckets restricts access for some Trusted Cloud by S3NS services, regardless of whether they use a service agent to interact with Cloud Storage. For example, services such as BigQuery use Cloud Storage for importing and exporting data. To prevent service disruptions, we recommend not using IP filtering on Cloud Storage buckets accessed by the following services:

What's next