Utilizzo delle regole firewall

In questa pagina vengono descritti i comandi per l'utilizzo delle regole firewall e vengono forniti alcuni esempi di utilizzo.

Prima di iniziare

Fai riferimento alla Panoramica delle regole firewall per scoprire di più sulle regole firewall, ad esempio regole implicite e regole generate dal sistema per le reti predefinite.

Prima di configurare le regole firewall, esamina i componenti delle regole firewall per acquisire familiarità con i componenti firewall utilizzati in Google Cloud.

Creazione di regole firewall

Le regole di firewall si definiscono a livello di rete e si applicano solo alla rete in cui sono create; tuttavia, il nome scelto per ciascuna di esse deve essere univoco per il progetto.

Una regola firewall può contenere intervalli IPv4 o IPv6, ma non entrambi.

Quando crei una regola firewall, puoi scegliere di abilitarne il logging. Se abiliti il logging, puoi omettere i campi dei metadati per risparmiare sui costi di archiviazione. Per ulteriori informazioni, consulta la sezione Utilizzare il logging delle regole firewall.

Se vuoi specificare più account di servizio per il campo dell'account di servizio di destinazione o di origine, utilizza l'interfaccia a riga di comando di Google Cloud, l'API o le librerie client.

La rete predefinita fornisce le regole firewall automatiche al momento della creazione. Le reti personalizzate e in modalità automatica consentono di creare facilmente firewall simili durante la creazione della rete se utilizzi la console. Se utilizzi l'interfaccia a riga di comando gcloud o l'API e vuoi creare regole firewall simili a quelle fornite dalla rete predefinita, consulta la sezione Configurare regole firewall per casi d'uso comuni.

console

1. Vai alla pagina Firewall in Google Cloud Console.
   Vai alla pagina Firewall
2. Fai clic su Crea regola firewall.
3. Inserisci un Nome per la regola firewall.
   Questo nome deve essere univoco per il progetto.
4. (Facoltativo) Puoi attivare il log delle regole firewall:
   • Fai clic su Logs > On.
   • Per omettere i metadati, espandi Dettagli log, quindi cancella Includi metadati.
5. Specifica la rete per la regola firewall.
6. Specifica la priorità della regola.
   Più basso è il numero, maggiore è la priorità.
7. Per Direzione del traffico, scegli traffico in entrata o in uscita.
8. Per l'opzione Azione in caso di corrispondenza, scegli Consenti o Rifiuta.
9. Specifica i target della regola.
   • Se vuoi che la regola venga applicata a tutte le istanze della rete, scegli All instances in the network.
   • Se vuoi che la regola venga applicata a istanze selezionate per tag di rete (target), scegli Specified target tags, quindi digita i tag a cui applicarla nel campo Tag di destinazione.
   • Se vuoi che la regola si applichi alle istanze selezionate per l'account di servizio associato, scegli Specified service account, indica se l'account di servizio è nel progetto corrente o in un altro sotto Ambito dell'account di servizio e scegli o digita il nome dell'account di servizio nel campo Account di servizio di destinazione.
10. Per una regola in entrata, specifica il filtro Sorgente:
    
    • Per filtrare il traffico in entrata in base agli intervalli IPv4 di origine, seleziona IPv4 ranges e inserisci i blocchi CIDR nel campo Intervalli IPv4 di origine. Utilizza 0.0.0.0/0 per qualsiasi origine IPv4.
    • Per filtrare il traffico in entrata in base agli intervalli IPv6 di origine, seleziona IPv6 ranges e inserisci i blocchi CIDR nel campo Intervalli IPv6 di origine. Utilizza ::/0 per qualsiasi origine IPv6.
    • Per filtrare il traffico in entrata in base al tag di rete, scegli Source tags, quindi digita i tag di rete nel campo Tag di origine. Per informazioni sul limite del numero di tag di origine, consulta la sezione Limiti per rete. Il filtro per tag di origine è disponibile solo se il target non è specificato dall'account di servizio. Per ulteriori informazioni, consulta la pagina Filtrare per account di servizio e tag di rete.
    • Per filtrare il traffico in entrata per account di servizio, scegli Service account, indica se l'account di servizio si trova nel progetto corrente o in un altro nella sezione Ambito dell'account di servizio e scegli o digita il nome dell'account di servizio nel campo Account di servizio di origine. Il filtro per account di servizio di origine è disponibile solo se il target non è specificato dal tag di rete. Per ulteriori informazioni, consulta la pagina Filtro per account di servizio rispetto al tag di rete.
    • Se vuoi, specifica un Secondo filtro di origine. I filtri di origine secondari non possono utilizzare gli stessi criteri di filtro di quello principale. Gli intervalli IP di origine possono essere utilizzati insieme ai tag di origine o all'account di servizio di origine. Il set di origini effettive è l'unione degli indirizzi IP dell'intervallo di origine e delle istanze identificate da tag di rete o account di servizio. Ciò significa che, se l'intervallo IP di origine o i tag di origine (o gli account di servizio di origine) corrispondono ai criteri del filtro, l'origine è inclusa nel set di origini efficace.
    • I tag di origine e l'account di servizio di origine non possono essere utilizzati insieme.
11. Per una regola in uscita, specifica il filtro Destinazione:
    
    • Per filtrare il traffico in uscita in base agli intervalli IPv4 di destinazione, seleziona IPv4 ranges e inserisci i blocchi CIDR nel campo Intervalli IPv4 di destinazione. Utilizza 0.0.0.0/0 per qualsiasi destinazione IPv4.
    • Per filtrare il traffico in uscita in base agli intervalli IPv6 di destinazione, seleziona IPv6 ranges e inserisci i blocchi CIDR nel campo Intervalli IPv6 di destinazione. Utilizza ::/0 per qualsiasi destinazione IPv6.

12. Definisci i protocolli e le porte a cui si applica la regola:
    

    • Seleziona Allow all o Deny all, a seconda dell'azione, per applicare la regola a tutti i protocolli e alle porte di destinazione.

    • Definisci protocolli e porte di destinazione specifici:

      • Seleziona tcp per includere il protocollo TCP e le porte di destinazione. Inserisci all o un elenco di porte di destinazione delimitati da virgole, come 20-22, 80, 8080.
      • Seleziona udp per includere il protocollo UDP e le porte di destinazione. Inserisci all o un elenco di porte di destinazione delimitati da virgole, come 67-69, 123.
      • Seleziona Altri protocolli per includere protocolli come icmp, sctp o un numero di protocollo. Utilizza il protocollo 58 per ICMPv6. Consulta i protocolli e le porte di destinazione per ulteriori informazioni.

13. (Facoltativo) Puoi creare la regola firewall ma non applicarla impostando il relativo stato su disattivato. Fai clic su Disattiva regola, quindi seleziona Disattivata.

14. Fai clic su Crea.

gcloud

Il comando gcloud per la creazione di regole firewall è il seguente:

gcloud compute firewall-rules create NAME \
    [--network NETWORK; default="default"] \
    [--priority PRIORITY;default=1000] \
    [--direction (ingress|egress|in|out); default="ingress"] \
    [--action (deny | allow )] \
    [--target-tags TAG[,TAG,...]] \
    [--target-service-accounts=IAM_SERVICE_ACCOUNT[,IAM_SERVICE_ACCOUNT,...]] \
    [--source-ranges CIDR_RANGE[,CIDR_RANGE,...]] \
    [--source-tags TAG,TAG,] \
    [--source-service-accounts=IAM_SERVICE_ACCOUNT[,IAM_SERVICE_ACCOUNT,...]] \
    [--destination-ranges CIDR_RANGE[,CIDR_RANGE,...]] \
    [--rules (PROTOCOL[:PORT[-PORT]],[PROTOCOL[:PORT[-PORT]],...]] | all ) \
    [--disabled | --no-disabled] \
    [--enable-logging | --no-enable-logging] \
    [--logging-metadata LOGGING_METADATA]

Utilizza i parametri come riportato di seguito. Maggiori dettagli su ciascuno sono disponibili nella documentazione di riferimento sull'SDK.

• --network: la rete per la regola. Se omessa, la regola viene creata nella rete default. Se non hai una rete predefinita o se vuoi creare la regola in una rete specifica, devi utilizzare questo campo.
• --priority Un valore numerico che indica la priorità per la regola. Più basso è il numero, maggiore è la priorità.
• --direction La direzione del traffico: ingress o egress.
• --action L'azione sulla corrispondenza, allow o deny. Deve essere utilizzato con il flag --rules.
• Specifica un target in uno dei tre seguenti modi:
  • Ometti --target-tags e --target-service-accounts se la regola deve essere applicata a tutti i target nella rete.
  • --target-tags Utilizza questo flag per definire target per tag di rete.
  • --target-service-accounts Utilizza questo flag per definire target per gli account di servizio associati.
• Per una regola in entrata, specifica un'origine:
  • --source-ranges Utilizza questo flag per specificare intervalli di origini IPv4 o IPv6 di origine in formato CIDR.
  • Se --source-ranges, source-tags e --source-service-accounts sono omessi, l'origine in entrata è un indirizzo IPv4, 0.0.0.0/0.
  • --source-tags Utilizza questo flag per specificare istanze di origine in base ai tag di rete. Il filtro per tag di origine è disponibile solo se il target non è specificato dall'account di servizio. Per ulteriori informazioni, consulta la pagina Filtrare per account di servizio e tag di rete.
  • --source-ranges e --source-tags possono essere utilizzati insieme. Se entrambi sono specificati, l'insieme di origini effettive è l'unione degli indirizzi IP degli intervalli di origine e le istanze identificate dai tag di rete, anche se le istanze dei tag non hanno indirizzi IP compresi negli intervalli di origine.
  • --source-service-accounts Utilizza questo flag per specificare le istanze in base agli account di servizio che utilizzano. Il filtro per account di servizio di origine è disponibile solo se il target non è specificato dal tag di rete. Per ulteriori informazioni, consulta la sezione Filtrare per account di servizio e tag di rete. --source-ranges e --source-service-accounts possono essere utilizzati insieme. Se entrambi sono specificati, l'insieme di origini effettive è l'unione degli indirizzi IP degli intervalli di origine e le istanze identificate dagli account di servizio di origine, anche se le istanze identificate dagli account di servizio di origine non hanno indirizzi IP compresi negli intervalli di origine.
• Per una regola in uscita, specifica una destinazione:
  • --destination-ranges Utilizza questo flag per specificare intervalli di indirizzi di destinazione IPv4 o IPv6 di destinazione in formato CIDR.
  • Se --destination-ranges viene omesso, la destinazione in uscita è qualsiasi indirizzo IPv4, 0.0.0.0/0.
• --rules Un elenco di protocolli e porte di destinazione a cui si applica la regola. Utilizza all per rendere la regola applicabile a tutti i protocolli e a tutte le porte di destinazione. Richiede il flag --action.
• Per impostazione predefinita, le regole firewall vengono create e applicate automaticamente, ma puoi modificare questo comportamento.
  • Se --disabled e --no-disabled vengono omessi, la regola firewall viene creata e applicata.
  • --disabled Aggiungi questo flag per creare la regola firewall ma non applicarla. La regola firewall rimane disattivata fino a quando non la aggiorna per abilitarla.
  • --no-disabled Aggiungi questo flag per assicurarti che la regola firewall sia applicata.
• --enable-logging | --no-enable-logging Puoi attivare la registrazione di una regola firewall durante la creazione o l'aggiornamento di una regola. Il logging delle regole firewall consente di controllare, verificare e analizzare gli effetti delle regole firewall. Per maggiori dettagli, vedi Log delle regole firewall.
  • --logging-metadata Se abiliti il logging, per impostazione predefinita, il logging delle regole firewall include campi di base e di metadati. Puoi omettere i campi dei metadati per risparmiare sui costi di archiviazione. Per ulteriori informazioni, consulta Utilizzo del logging delle regole firewall.

API

Crea una regola firewall.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls
{
  "name": "FIREWALL_NAME",
  "network": "projects/PROJECT-ID/global/networks/NETWORK",
  ... other fields
}

Sostituisci i segnaposto con valori validi:

• PROJECT_ID è l'ID del progetto in cui si trova la rete VPC.
• NETWORK è il nome della rete VPC in cui viene creata la regola firewall.

• FIREWALL_NAME un nome per la regola firewall.

• Per una regola firewall in entrata, utilizza i campi seguenti per specificare la sorgente in entrata: sourceRanges, sourceTags o sourceServiceAccounts. sourceRanges può essere un intervallo IPv4 o IPv6, ma non una combinazione di entrambi. Non specificare alcun campo per utilizzare l'intervallo 0.0.0.0/0. Non puoi utilizzare insieme i campi sourceTags e sourceServiceAccounts. Tuttavia, puoi utilizzare sourceRanges con sourceTags o sourceServiceAccounts. Se lo fai, la connessione deve corrispondere a una delle due; in questo caso, verrà applicata la regola firewall.

  Per i campi target, se utilizzi il campo sourceTags, non puoi utilizzare il campo targetServiceAccounts. Devi utilizzare il campo targetTags o nessun campo target. Allo stesso modo, se utilizzi il campo sourceServiceAccounts, non puoi utilizzare il campo targetTags. Se non specifichi un campo target, la regola viene applicata a tutti i target nella rete.

• Per una regola firewall in uscita, utilizza il campo destinationRanges per specificare la destinazione. destinationRanges può essere un intervallo IPv4 o IPv6, ma non una combinazione di entrambi. Se non specifichi una destinazione, Google Cloud utilizza 0.0.0.0/0. Utilizza il campo targetTags o targetServiceAccounts per specificare a quale target applicare la regola. Se non specifichi un campo target, la regola viene applicata a tutti i target nella rete.

Per ulteriori informazioni e descrizioni per ogni campo, consulta il metodo firewalls.insert.

C#

compute/api/Compute.Samples/CreateFirewallRuleAsync.cs

Visualizza su GitHub

using Google.Cloud.Compute.V1;
using System.Threading.Tasks;

public class CreateFirewallRuleAsyncSample
{
    public async Task CreateFirewallRuleAsync(
        // TODO(developer): Set your own default values for these parameters or pass different values when calling this method.
        string projectId = "your-project-id",
        string firewallRuleName = "my-test-firewall-rule",
        // Name of the network the rule will be applied to. Some available name formats:
        // projects/{project_id}/global/networks/{network}
        // global/networks/{network}
        string networkName = "global/networks/default")
    {
        Firewall firewallRule = new Firewall
        {
            Name = firewallRuleName,
            Network = networkName,
            Direction = ComputeEnumConstants.Firewall.Direction.Ingress,
            Allowed =
            {
                new Allowed
                {
                    Ports = { "80", "443" },
                    IPProtocol = "tcp"
                }
            },
            TargetTags = { "web" },
            Description = "Allows TCP traffic on port 80 and 443 from anywhere."
        };

        // Note that the default value of priority for the firewall API is 1000.
        // If you check the value of firewallRule.Priority at this point it
        // will be equal to 0, however it is not treated as "set" by the library, and thus
        // the default will be applied to the new rule. If you want to create a rule that
        // has priority == 0, you'll need to explicitly set it: firewallRule.Priority = 0.
        // You can use the firewallRule.HasPriority property to check if the priority has been set.
        // You can use the firewallRule.ClearPriority() method to unset the priority.

        // Initialize client that will be used to send requests. This client only needs to be created
        // once, and can be reused for multiple requests.
        FirewallsClient client = await FirewallsClient.CreateAsync();

        // Create the firewall rule in the specified project.
        var firewallRuleCreation = await client.InsertAsync(projectId, firewallRule);

        // Wait for the operation to complete using client-side polling.
        await firewallRuleCreation.PollUntilCompletedAsync();
    }
}

Go

compute/firewall/create_firewall_rule.go

Visualizza su GitHub

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
	"google.golang.org/protobuf/proto"
)

// createFirewallRule creates a firewall rule allowing for incoming HTTP and HTTPS access from the entire Internet.
func createFirewallRule(w io.Writer, projectID, firewallRuleName, networkName string) error {
	// projectID := "your_project_id"
	// firewallRuleName := "europe-central2-b"
	// networkName := "global/networks/default"

	ctx := context.Background()
	firewallsClient, err := compute.NewFirewallsRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %v", err)
	}
	defer firewallsClient.Close()

	firewallRule := &computepb.Firewall{
		Allowed: []*computepb.Allowed{
			{
				IPProtocol: proto.String("tcp"),
				Ports:      []string{"80", "443"},
			},
		},
		Direction: proto.String(computepb.Firewall_INGRESS.String()),
		Name:      &firewallRuleName,
		TargetTags: []string{
			"web",
		},
		Network:     &networkName,
		Description: proto.String("Allowing TCP traffic on port 80 and 443 from Internet."),
	}

	// Note that the default value of priority for the firewall API is 1000.
	// If you check the value of `firewallRule.GetPriority()` at this point it
	// will be equal to 0, however it is not treated as "set" by the library and thus
	// the default will be applied to the new rule. If you want to create a rule that
	// has priority == 0, you need to explicitly set it so:

	// firewallRule.Priority = proto.Int32(0)

	req := &computepb.InsertFirewallRequest{
		Project:          projectID,
		FirewallResource: firewallRule,
	}

	op, err := firewallsClient.Insert(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to create firewall rule: %v", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %v", err)
	}

	fmt.Fprintf(w, "Firewall rule created\n")

	return nil
}

Java

compute/cloud-client/src/main/java/compute/CreateFirewallRule.java

Visualizza su GitHub

import com.google.cloud.compute.v1.Allowed;
import com.google.cloud.compute.v1.Firewall;
import com.google.cloud.compute.v1.Firewall.Direction;
import com.google.cloud.compute.v1.FirewallsClient;
import com.google.cloud.compute.v1.InsertFirewallRequest;
import java.io.IOException;
import java.util.UUID;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class CreateFirewallRule {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample
    /* project: project ID or project number of the Cloud project you want to use.
       firewallRuleName: name of the rule that is created.
       network: name of the network the rule will be applied to. Available name formats:
        * https://www.googleapis.com/compute/v1/projects/{project_id}/global/networks/{network}
        * projects/{project_id}/global/networks/{network}
        * global/networks/{network} */
    String project = "your-project-id";
    String firewallRuleName = "firewall-rule-name-" + UUID.randomUUID();
    String network = "global/networks/default";

    // The rule will be created with default priority of 1000.
    createFirewall(project, firewallRuleName, network);
  }

  // Creates a simple firewall rule allowing for incoming HTTP and
  // HTTPS access from the entire Internet.
  public static void createFirewall(String project, String firewallRuleName, String network)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    /* Initialize client that will be used to send requests. This client only needs to be created
       once, and can be reused for multiple requests. After completing all of your requests, call
       the `firewallsClient.close()` method on the client to safely
       clean up any remaining background resources. */
    try (FirewallsClient firewallsClient = FirewallsClient.create()) {

      // The below firewall rule is created in the default network.
      Firewall firewallRule = Firewall.newBuilder()
          .setName(firewallRuleName)
          .setDirection(Direction.INGRESS.toString())
          .addAllowed(
              Allowed.newBuilder().addPorts("80").addPorts("443").setIPProtocol("tcp").build())
          .addSourceRanges("0.0.0.0/0")
          .setNetwork(network)
          .addTargetTags("web")
          .setDescription("Allowing TCP traffic on port 80 and 443 from Internet.")
          .build();

      /* Note that the default value of priority for the firewall API is 1000.
         If you check the value of `firewallRule.getPriority()` at this point it
         will be equal to 0, however it is not treated as "set" by the library and thus
         the default will be applied to the new rule. If you want to create a rule that
         has priority == 0, you'll need to explicitly set it so: setPriority(0) */

      InsertFirewallRequest insertFirewallRequest = InsertFirewallRequest.newBuilder()
          .setFirewallResource(firewallRule)
          .setProject(project).build();

      firewallsClient.insertAsync(insertFirewallRequest).get(3, TimeUnit.MINUTES);

      System.out.println("Firewall rule created successfully -> " + firewallRuleName);
    }
  }
}

Node.js

samples/firewall/createFirewallRule.js

Visualizza su GitHub

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const firewallRuleName = 'YOUR_FIREWALL_RULE_NAME'
// const networkName = 'global/networks/default'

const compute = require('@google-cloud/compute');
const computeProtos = compute.protos.google.cloud.compute.v1;

async function createFirewallRule() {
  const firewallsClient = new compute.FirewallsClient();
  const operationsClient = new compute.GlobalOperationsClient();

  const firewallRule = new computeProtos.Firewall();
  firewallRule.name = firewallRuleName;
  firewallRule.direction = 'INGRESS';
  firewallRule.allowed = [
    {
      IPProtocol: 'tcp',
      ports: ['80', '443'],
    },
  ];
  firewallRule.targetTags = ['web'];
  firewallRule.network = networkName;
  firewallRule.description =
    'Allowing TCP traffic on port 80 and 443 from Internet.';

  // Note that the default value of priority for the firewall API is 1000.
  // If you check the value of `firewallRule.priority` at this point it
  // will be equal to null, however it is not treated as "set" by the library and thus
  // the default will be applied to the new rule. If you want to create a rule that
  // has priority == 0, you need to explicitly set it so:

  // firewallRule.priority = 0

  const [response] = await firewallsClient.insert({
    project: projectId,
    firewallResource: firewallRule,
  });
  let operation = response.latestResponse;

  // Wait for the create operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await operationsClient.wait({
      operation: operation.name,
      project: projectId,
    });
  }

  console.log('Firewall rule created');
}

createFirewallRule();

PHP

compute/cloud-client/firewall/src/create_firewall_rule.php

Visualizza su GitHub

use Google\Cloud\Compute\V1\FirewallsClient;
use Google\Cloud\Compute\V1\Allowed;
use Google\Cloud\Compute\V1\Firewall;

/**
 * To correctly handle string enums in Cloud Compute library
 * use constants defined in the Enums subfolder.
 */
use Google\Cloud\Compute\V1\Enums\Firewall\Direction;

/**
 * Creates a simple firewall rule allowing incoming HTTP and HTTPS access from the entire internet.
 *
 * @param string $projectId Project ID or project number of the Cloud project you want to create a rule for.
 * @param string $firewallRuleName Name of the rule that is created.
 * @param string $network Name of the network the rule will be applied to. Available name formats:
 *                        https://www.googleapis.com/compute/v1/projects/{project_id}/global/networks/{network}
 *                        projects/{project_id}/global/networks/{network}
 *                        global/networks/{network}
 *
 * @throws \Google\ApiCore\ApiException if the remote call fails.
 * @throws \Google\ApiCore\ValidationException if local error occurs before remote call.
 */

function create_firewall_rule(string $projectId, string $firewallRuleName, string $network = 'global/networks/default')
{
    $firewallsClient = new FirewallsClient();
    $allowedPorts = (new Allowed())
      ->setIPProtocol('tcp')
      ->setPorts(['80', '443']);
    $firewallResource = (new Firewall())
      ->setName($firewallRuleName)
      ->setDirection(Direction::INGRESS)
      ->setAllowed([$allowedPorts])
      ->setSourceRanges(['0.0.0.0/0'])
      ->setTargetTags(['web'])
      ->setNetwork($network)
      ->setDescription('Allowing TCP traffic on ports 80 and 443 from Internet.');

    /**
    * Note that the default value of priority for the firewall API is 1000.
    * If you check the value of its priority at this point it will be
    * equal to 0, however it is not treated as "set" by the library and thus
    * the default will be applied to the new rule. If you want to create a rule
    * that has priority == 0, you need to explicitly set it so:
    *
    *   $firewallResource->setPriority(0);
    */

    //Create the firewall rule using Firewalls Client.
    $operation = $firewallsClient->insert($firewallResource, $projectId);

    // Wait for the operation to complete.
    $operation->pollUntilComplete();
    if ($operation->operationSucceeded()) {
        printf('Created rule %s.' . PHP_EOL, $firewallRuleName);
    } else {
        $error = $operation->getError();
        printf('Firewall rule creation failed: %s' . PHP_EOL, $error->getMessage());
    }
}

Python

campioni/snippet/firewall/create.py

Visualizza su GitHub

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1

def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    This method will wait for the extended (long-running) operation to
    complete. If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result

def create_firewall_rule(
    project_id: str, firewall_rule_name: str, network: str = "global/networks/default"
) -> compute_v1.Firewall:
    """
    Creates a simple firewall rule allowing for incoming HTTP and HTTPS access from the entire Internet.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        firewall_rule_name: name of the rule that is created.
        network: name of the network the rule will be applied to. Available name formats:
            * https://www.googleapis.com/compute/v1/projects/{project_id}/global/networks/{network}
            * projects/{project_id}/global/networks/{network}
            * global/networks/{network}

    Returns:
        A Firewall object.
    """
    firewall_rule = compute_v1.Firewall()
    firewall_rule.name = firewall_rule_name
    firewall_rule.direction = "INGRESS"

    allowed_ports = compute_v1.Allowed()
    allowed_ports.I_p_protocol = "tcp"
    allowed_ports.ports = ["80", "443"]

    firewall_rule.allowed = [allowed_ports]
    firewall_rule.source_ranges = ["0.0.0.0/0"]
    firewall_rule.network = network
    firewall_rule.description = "Allowing TCP traffic on port 80 and 443 from Internet."

    firewall_rule.target_tags = ["web"]

    # Note that the default value of priority for the firewall API is 1000.
    # If you check the value of `firewall_rule.priority` at this point it
    # will be equal to 0, however it is not treated as "set" by the library and thus
    # the default will be applied to the new rule. If you want to create a rule that
    # has priority == 0, you need to explicitly set it so:
    # TODO: Uncomment to set the priority to 0
    # firewall_rule.priority = 0

    firewall_client = compute_v1.FirewallsClient()
    operation = firewall_client.insert(
        project=project_id, firewall_resource=firewall_rule
    )

    wait_for_extended_operation(operation, "firewall rule creation")

    return firewall_client.get(project=project_id, firewall=firewall_rule_name)

Ruby

google-cloud-compute-v1/samples/firewall.rb

Visualizza su GitHub

require "google/cloud/compute/v1"

# Creates a simple firewall rule allowing for incoming HTTP and HTTPS access from the entire Internet.
#
# @param [String] project project ID or project number of the Cloud project you want to use.
# @param [String] name: name of the rule that is created.
# @param network: name of the network the rule will be applied to. Available name formats:
#         * https://www.googleapis.com/compute/v1/projects/{project_id}/global/networks/{network}
#         * projects/{project_id}/global/networks/{network}
#         * global/networks/{network}
def create_firewall_rule project:, name:, network: "global/networks/default"
  rule = {
    name: name,
    direction: "INGRESS",
    allowed: [{
      I_p_protocol: "tcp",
      ports: ["80", "443"]
    }],
    source_ranges: ["0.0.0.0/0"],
    network: network,
    description: "Allowing TCP traffic on port 80 and 443 from Internet.",
    target_tags: ["web"]
  }

  # Note that the default value of priority for the firewall API is 1000.
  # If you want to create a rule that has priority == 0, you need to explicitly set it:
  #   rule[:priority] = 0
  # Use `rule.has_key? :priority` to check if the priority has been set.
  # Use `rule.delete :priority` method to unset the priority.

  request = {
    firewall_resource: rule,
    project: project
  }

  client = ::Google::Cloud::Compute::V1::Firewalls::Rest::Client.new
  operation = client.insert request

  wait_until_done project: project, operation: operation.operation
end

Terraform

Puoi utilizzare una risorsa Terraform per creare una regola firewall.

example/basic_firewall_rule/main.tf

Visualizza su GitHub

resource "google_compute_firewall" "rules" {
  project     = var.project_id # Replace this with your project ID in quotes
  name        = "my-firewall-rule"
  network     = "default"
  description = "Creates firewall rule targeting tagged instances"

  allow {
    protocol = "tcp"
    ports    = ["80", "8080", "1000-2000"]
  }
  target_tags = ["web"]
}

Aggiornamento delle regole firewall

Puoi modificare alcuni componenti di una regola firewall, ad esempio i protocolli e le porte di destinazione specificati per la condizione di corrispondenza. Non puoi modificare il nome della regola firewall, la rete, l'azione sulla corrispondenza e la direzione del traffico.

Se devi modificare il nome, la rete o il componente Azione o Direzione, devi eliminare la regola e crearne una nuova.

Se vuoi aggiungere o rimuovere più account di servizio, utilizza l'interfaccia a riga di comando di Google Cloud, l'API o le librerie client. Non puoi utilizzare la console per specificare più account di servizio di destinazione o account di servizio di origine.

console

1. Vai alla pagina Firewall in Google Cloud Console.
   Vai alla pagina Firewall
2. Fai clic sulla regola firewall da modificare.
3. Fai clic su Modifica.

4. Modifica i componenti modificabili per soddisfare le tue esigenze.

   Nel campo Protocolli e porte specificati, utilizza un elenco delimitato da punto e virgola per specificare più protocolli e combinazioni di porta protocollo e destinazione. Per specificare ICMP IPv4, utilizza icmp o il numero di protocollo 1. Per specificare la ICMP IPv6, utilizza il numero di protocollo 58. Consulta protocolli e porte di destinazione per ulteriori informazioni.

5. Fai clic su Salva.

gcloud

Il comando gcloud per aggiornare le regole firewall è il seguente:

gcloud compute firewall-rules update NAME \
    [--priority=PRIORITY] \
    [--description=DESCRIPTION] \
    [--target-tags=TAG,...] \
    [--target-service-accounts=IAM_SERVICE_ACCOUNT,_] \
    [--source-ranges=CIDR_RANGE,...] \
    [--source-tags=TAG,...] \
    [--source-service-accounts=IAM_SERVICE_ACCOUNT,_] \
    [--destination-ranges=CIDR_RANGE,...] \
    [--rules=[PROTOCOL[:PORT[-PORT]],…]] \
    [--disabled | --no-disabled] \
    [--enable-logging | --no-enable-logging]

Le descrizioni di ogni flag sono le stesse della creazione di regole firewall e ulteriori dettagli su ognuna sono disponibili nella documentazione di riferimento dell'SDK.

Nota: se stai modificando una regola firewall la cui azione è consentita, puoi utilizzare il flag --allow deprecato anziché il flag --rules, se preferisci.

API

Utilizza PATCH per aggiornare i seguenti campi: allowed, description, sourceRanges, sourceTags o targetTags. Utilizza PUT o POST per tutti gli altri campi.

(PATCH|(POST|PUT)) https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls/FIREWALL_NAME
{
  "name": "FIREWALL_NAME",
  "network": "projects/PROJECT-ID/global/networks/NETWORK",
  ... other fields
}

Sostituisci i segnaposto con valori validi:

• PROJECT_ID è l'ID del progetto in cui si trova la rete VPC.
• NETWORK è il nome della rete VPC in cui si trova la regola firewall.
• FIREWALL_NAME è il nome della regola firewall da aggiornare.

Per ulteriori informazioni e descrizioni per ogni campo, consulta il metodo firewalls.patch o firewalls.update.

C#

compute/api/Compute.Samples/PatchFirewallRuleAsync.cs

Visualizza su GitHub

using Google.Cloud.Compute.V1;
using System.Threading.Tasks;

public class PatchFirewallRuleAsyncSample
{
    public async Task PatchFirewallRuleAsync(
        // TODO(developer): Set your own default values for these parameters or pass different values when calling this method.
        string projectId = "your-project-id",
        string firewallRuleName = "my-test-firewall-rule",
        int newPriority = 10)
    {
        // The patch operation doesn't require the full definition of a Firewall object.
        // It will only update the values that were set in it,
        // in this case it will only change the priority.
        Firewall firewallRule = new Firewall
        {
            Priority = newPriority
        };

        // Initialize client that will be used to send requests. This client only needs to be created
        // once, and can be reused for multiple requests.
        FirewallsClient client = await FirewallsClient.CreateAsync();

        // Patch the firewall rule in the specified project.
        var firewallRulePatching = await client.PatchAsync(projectId, firewallRuleName, firewallRule);

        // Wait for the operation to complete using client-side polling.
        await firewallRulePatching.PollUntilCompletedAsync();
    }
}

Go

compute/firewall/patch_firewall_priorità.go

Visualizza su GitHub

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
	"google.golang.org/protobuf/proto"
)

// patchFirewallPriority modifies the priority of a given firewall rule.
func patchFirewallPriority(w io.Writer, projectID, firewallRuleName string, priority int32) error {
	// projectID := "your_project_id"
	// firewallRuleName := "europe-central2-b"
	// priority := 10

	ctx := context.Background()
	firewallsClient, err := compute.NewFirewallsRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %v", err)
	}
	defer firewallsClient.Close()

	firewallRule := &computepb.Firewall{
		Priority: proto.Int32(priority),
	}

	req := &computepb.PatchFirewallRequest{
		Project:          projectID,
		Firewall:         firewallRuleName,
		FirewallResource: firewallRule,
	}

	// The patch operation doesn't require the full definition of a Firewall interface. It will only update
	// the values that were set in it, in this case it will only change the priority.
	op, err := firewallsClient.Patch(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to patch firewall rule: %v", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %v", err)
	}

	fmt.Fprintf(w, "Firewall rule updated\n")

	return nil
}

Java

compute/cloud-client/src/main/java/compute/PatchFirewallRule.java

Visualizza su GitHub

import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.compute.v1.Firewall;
import com.google.cloud.compute.v1.FirewallsClient;
import com.google.cloud.compute.v1.Operation;
import com.google.cloud.compute.v1.PatchFirewallRequest;
import java.io.IOException;
import java.util.UUID;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class PatchFirewallRule {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample
    // project: project ID or project number of the Cloud project you want to use.
    // firewallRuleName: name of the rule you want to modify.
    // priority: the new priority to be set for the rule.
    String project = "your-project-id";
    String firewallRuleName = "firewall-rule-name-" + UUID.randomUUID();
    int priority = 10;

    patchFirewallPriority(project, firewallRuleName, priority);
  }

  // Modifies the priority of a given firewall rule.
  public static void patchFirewallPriority(String project, String firewallRuleName, int priority)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    /* Initialize client that will be used to send requests. This client only needs to be created
       once, and can be reused for multiple requests. After completing all of your requests, call
       the `firewallsClient.close()` method on the client to safely
       clean up any remaining background resources. */
    try (FirewallsClient firewallsClient = FirewallsClient.create()) {

      /* The patch operation doesn't require the full definition of a Firewall object. It will only
         update the values that were set in it, in this case it will only change the priority. */
      Firewall firewall = Firewall.newBuilder()
          .setPriority(priority).build();

      PatchFirewallRequest patchFirewallRequest = PatchFirewallRequest.newBuilder()
          .setProject(project)
          .setFirewall(firewallRuleName)
          .setFirewallResource(firewall).build();

      OperationFuture<Operation, Operation> operation = firewallsClient.patchAsync(
          patchFirewallRequest);
      operation.get(3, TimeUnit.MINUTES);
      System.out.println("Firewall Patch applied successfully ! ");
    }
  }
}

Node.js

samples/firewall/patchFirewallPriority.js

Visualizza su GitHub

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const firewallRuleName = 'FIREWALL_RULE_NAME';
// const priority = 10;

const compute = require('@google-cloud/compute');
const computeProtos = compute.protos.google.cloud.compute.v1;

async function patchFirewallPriority() {
  const firewallsClient = new compute.FirewallsClient();
  const operationsClient = new compute.GlobalOperationsClient();

  const firewallRule = new computeProtos.Firewall();
  firewallRule.priority = priority;

  // The patch operation doesn't require the full definition of a Firewall object. It will only update
  // the values that were set in it, in this case it will only change the priority.
  const [response] = await firewallsClient.patch({
    project: projectId,
    firewall: firewallRuleName,
    firewallResource: firewallRule,
  });
  let operation = response.latestResponse;

  // Wait for the create operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await operationsClient.wait({
      operation: operation.name,
      project: projectId,
    });
  }

  console.log('Firewall rule updated');
}

patchFirewallPriority();

PHP

compute/cloud-client/firewall/src/patch_firewall_priorità.php

Visualizza su GitHub

use Google\Cloud\Compute\V1\FirewallsClient;
use Google\Cloud\Compute\V1\Firewall;

/**
 * Modifies the priority of a given firewall rule.
 *
 * @param string $projectId Project ID or project number of the Cloud project you want to patch a rule from.
 * @param string $firewallRuleName Name of the rule that you want to modify.
 * @param int $priority The new priority to be set for the rule.
 *
 * @throws \Google\ApiCore\ApiException if the remote call fails.
 * @throws \Google\ApiCore\ValidationException if local error occurs before remote call.
 */
function patch_firewall_priority(string $projectId, string $firewallRuleName, int $priority)
{
    $firewallsClient = new FirewallsClient();
    $firewallResource = (new Firewall())->setPriority($priority);

    // The patch operation doesn't require the full definition of a Firewall object. It will only update
    // the values that were set in it, in this case it will only change the priority.
    $operation = $firewallsClient->patch($firewallRuleName, $firewallResource, $projectId);

    // Wait for the operation to complete.
    $operation->pollUntilComplete();
    if ($operation->operationSucceeded()) {
        printf('Patched %s priority to %d.' . PHP_EOL, $firewallRuleName, $priority);
    } else {
        $error = $operation->getError();
        printf('Patching failed: %s' . PHP_EOL, $error->getMessage());
    }
}

Python

campioni/snippet/firewall/patch.py

Visualizza su GitHub

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1

def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    This method will wait for the extended (long-running) operation to
    complete. If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result

def patch_firewall_priority(
    project_id: str, firewall_rule_name: str, priority: int
) -> None:
    """
    Modifies the priority of a given firewall rule.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        firewall_rule_name: name of the rule you want to modify.
        priority: the new priority to be set for the rule.
    """
    firewall_rule = compute_v1.Firewall()
    firewall_rule.priority = priority

    # The patch operation doesn't require the full definition of a Firewall object. It will only update
    # the values that were set in it, in this case it will only change the priority.
    firewall_client = compute_v1.FirewallsClient()
    operation = firewall_client.patch(
        project=project_id, firewall=firewall_rule_name, firewall_resource=firewall_rule
    )

    wait_for_extended_operation(operation, "firewall rule patching")
    return

Ruby

google-cloud-compute-v1/samples/firewall.rb

Visualizza su GitHub

require "google/cloud/compute/v1"

# Modifies the priority of a given firewall rule.
#
# @param [String] project project ID or project number of the Cloud project you want to use.
# @param [String] name name of the rule you want to modify.
# @param [Integer] priority the new priority to be set for the rule.
def patch_firewall_priority project:, name:, priority:
  rule = {
    priority: priority
  }

  request = {
    project: project,
    firewall: name,
    firewall_resource: rule
  }

  # The patch operation doesn't require the full definition of a Firewall object. It will only update
  # the values that were set in it, in this case it will only change the priority.
  client = ::Google::Cloud::Compute::V1::Firewalls::Rest::Client.new
  operation = client.patch request

  wait_until_done project: project, operation: operation.operation
end

Elenco delle regole firewall per una rete VPC

In Google Cloud Console, puoi elencare tutte le regole firewall per il tuo progetto o per una determinata rete VPC. Per ogni regola firewall, Google Cloud Console mostra dettagli come il tipo di regola, i target e i filtri.

Se attivi il Log delle regole firewall, Insight sul firewall può fornire informazioni sulle regole del firewall per aiutarti a comprendere e ottimizzare meglio le configurazioni. Ad esempio, puoi visualizzare quali regole allow non sono state utilizzate nelle ultime sei settimane. Per ulteriori informazioni, consulta la sezione Utilizzare la schermata Dettagli regola firewall nella documentazione di Firewall Insights.

console

Per visualizzare tutte le regole firewall per tutte le reti nel tuo progetto:

• Vai alla pagina Firewall in Google Cloud Console.
  Vai alla pagina Firewall

Per visualizzare le regole firewall in una determinata rete:

1. Vai alla pagina Reti VPC in Google Cloud Console.
   Vai alla pagina Reti VPC
2. Fai clic sul nome di una rete VPC per passare alla relativa pagina dei dettagli.
3. Nella pagina dei dettagli della rete, fai clic sulla scheda Regole firewall.

gcloud

Il comando seguente genera un elenco ordinato di regole firewall per una determinata rete ([NETWORK-NAME]).

gcloud compute firewall-rules list --filter network=NETWORK \
    --sort-by priority \
    --format="table(
        name,
        network,
        direction,
        priority,
        sourceRanges.list():label=SRC_RANGES,
        destinationRanges.list():label=DEST_RANGES,
        allowed[].map().firewall_rule().list():label=ALLOW,
        denied[].map().firewall_rule().list():label=DENY,
        sourceTags.list():label=SRC_TAGS,
        targetTags.list():label=TARGET_TAGS
        )"

API

Elenca tutte le regole firewall per una determinata rete.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls/?filter=network="NETWORK

Sostituisci i segnaposto con valori validi:

• PROJECT_ID è l'ID del progetto in cui si trova la rete VPC.
• NETWORK è il nome della rete VPC che contiene le regole firewall da elencare.

Per ulteriori informazioni, consulta il metodo firewalls.list.

C#

compute/api/Compute.Samples/ListFirewallRuleAsync.cs

Visualizza su GitHub

using Google.Cloud.Compute.V1;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;

public class ListFirewallRulesAsyncSample
{
    public async Task ListFirewallRulesAsync(
        // TODO(developer): Set your own default values for these parameters or pass different values when calling this method.
        string projectId = "your-project-id")
    {
        // Initialize client that will be used to send requests. This client only needs to be created
        // once, and can be reused for multiple requests.
        FirewallsClient client = await FirewallsClient.CreateAsync();

        // Make the request to list all firewall rules.
        await foreach (var firewallRule in client.ListAsync(projectId))
        {
            // The result is a Firewall sequence that you can iterate over.
            Console.WriteLine($"Firewal Rule: {firewallRule.Name}");
        }
    }
}

Go

compute/firewall/list_firewall_rules.go

Visualizza su GitHub

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	"google.golang.org/api/iterator"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
)

// listFirewallRules prints the list of firewall names and their descriptions in specified project
func listFirewallRules(w io.Writer, projectID string) error {
	// projectID := "your_project_id"

	ctx := context.Background()
	firewallsClient, err := compute.NewFirewallsRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %v", err)
	}
	defer firewallsClient.Close()

	req := &computepb.ListFirewallsRequest{
		Project: projectID,
	}

	it := firewallsClient.List(ctx, req)
	for {
		firewallRule, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return err
		}
		fmt.Fprintf(w, "- %s: %s\n", firewallRule.GetName(), firewallRule.GetDescription())
	}

	return nil
}

Java

compute/cloud-client/src/main/java/compute/ListFirewallRule.java

Visualizza su GitHub

import com.google.cloud.compute.v1.Firewall;
import com.google.cloud.compute.v1.FirewallsClient;
import com.google.cloud.compute.v1.FirewallsClient.ListPagedResponse;
import java.io.IOException;

public class ListFirewallRules {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample
    // project: project ID or project number of the Cloud project you want to use.
    String project = "your-project-id";
    listFirewallRules(project);
  }

  // Return a list of all the firewall rules in specified project.
  // Also prints the list of firewall names and their descriptions.
  public static ListPagedResponse listFirewallRules(String project)
      throws IOException {
    /* Initialize client that will be used to send requests. This client only needs to be created
       once, and can be reused for multiple requests. After completing all of your requests, call
       the `firewallsClient.close()` method on the client to safely
       clean up any remaining background resources. */
    try (FirewallsClient firewallsClient = FirewallsClient.create()) {
      ListPagedResponse firewallResponse = firewallsClient.list(project);
      for (Firewall firewall : firewallResponse.iterateAll()) {
        System.out.println(firewall.getName());
      }
      return firewallResponse;
    }
  }
}

Node.js

samples/firewall/listFirewallRule.js

Visualizza su GitHub

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';

const compute = require('@google-cloud/compute');

async function listFirewallRules() {
  const firewallsClient = new compute.FirewallsClient();

  const [firewallRules] = await firewallsClient.list({
    project: projectId,
  });

  for (const rule of firewallRules) {
    console.log(` - ${rule.name}: ${rule.description}`);
  }
}

listFirewallRules();

PHP

compute/cloud-client/firewall/src/list_firewall_rules.php

Visualizza su GitHub

use Google\Cloud\Compute\V1\FirewallsClient;

/**
 * Return a list of all the firewall rules in specified project. Also prints the
 * list of firewall names and their descriptions.
 *
 * @param string $projectId Project ID or project number of the Cloud project you want to list rules from.
 *
 * @throws \Google\ApiCore\ApiException if the remote call fails.
 */
function list_firewall_rules(string $projectId)
{
    // List all firewall rules defined for the project using Firewalls Client.
    $firewallClient = new FirewallsClient();
    $firewallList = $firewallClient->list($projectId);

    print('--- Firewall Rules ---' . PHP_EOL);
    foreach ($firewallList->iterateAllElements() as $firewall) {
        printf(' -  %s : %s : %s' . PHP_EOL, $firewall->getName(), $firewall->getDescription(), $firewall->getNetwork());
    }
}

Python

campioni/snippet/firewall/list.py

Visualizza su GitHub

from typing import Iterable

from google.cloud import compute_v1

def list_firewall_rules(project_id: str) -> Iterable[compute_v1.Firewall]:
    """
    Return a list of all the firewall rules in specified project. Also prints the
    list of firewall names and their descriptions.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.

    Returns:
        A flat list of all firewall rules defined for given project.
    """
    firewall_client = compute_v1.FirewallsClient()
    firewalls_list = firewall_client.list(project=project_id)

    for firewall in firewalls_list:
        print(f" - {firewall.name}: {firewall.description}")

    return firewalls_list

Ruby

google-cloud-compute-v1/samples/firewall.rb

Visualizza su GitHub

require "google/cloud/compute/v1"

# Return a list of all the firewall rules in specified project. Also prints the
# list of firewall names and their descriptions.
#
# @param [String] project project ID or project number of the project you want to use.
# @return [Array<::Google::Cloud::Compute::V1::Firewall>]
#     A list of all firewall rules defined for the given project.
def list_firewall_rules project:
  client = ::Google::Cloud::Compute::V1::Firewalls::Rest::Client.new
  firewalls = client.list project: project

  firewall_list = []
  firewalls.each do |firewall|
    puts " - #{firewall.name}: #{firewall.description}"
    firewall_list << firewall
  end

  firewall_list
end

Elenco delle regole firewall per un'interfaccia di rete di un'istanza VM

Per ogni interfaccia di rete, Google Cloud Console elenca tutte le regole firewall applicate all'interfaccia e le regole che vengono effettivamente utilizzate. Le regole firewall possono mascherare altre regole, pertanto tutte quelle applicabili a un'interfaccia potrebbero non essere utilizzate dall'interfaccia.

Le regole firewall vengono associate a un'istanza VM tramite un parametro target di una regola. Visualizzando tutte le regole applicate, puoi verificare se una determinata regola viene applicata a un'interfaccia.

Se attivi il Log delle regole firewall, Insight sul firewall può fornire informazioni sulle regole del firewall per aiutarti a comprendere e ottimizzare meglio le configurazioni. Ad esempio, puoi visualizzare quali regole in un'interfaccia sono state interessate nelle ultime sei settimane. Per ulteriori informazioni, consulta la sezione Utilizzare la schermata dei dettagli dell'interfaccia di rete delle VM nella documentazione di Firewall Insights.

Per visualizzare le regole applicabili a un'interfaccia di rete specifica di un'istanza VM:

1. Vai alla pagina delle istanze VM in Google Cloud Console e trova l'istanza da visualizzare.
   Vai alla pagina Istanze VM
2. Nel menu Altre azioni () dell'istanza, seleziona Visualizza dettagli di rete.
3. Se un'istanza ha più interfacce di rete, seleziona l'interfaccia di rete da visualizzare nella sezione Dettagli interfaccia di rete.
4. Nella sezione Dettagli firewall e route, seleziona la scheda Regole firewall.
5. Visualizza la tabella per determinare se il traffico da o verso un determinato indirizzo IP è consentito.

Visualizzazione dei dettagli delle regole firewall

Puoi esaminare una regola firewall per visualizzarne il nome, la rete applicabile e i componenti, nonché se la regola è abilitata o disabilitata.

console

1. Elenca le regole del firewall. Puoi visualizzare un elenco di tutte le regole o solo di quelle in una determinata rete.
2. Fai clic sulla regola per visualizzarla.

gcloud

Il comando seguente descrive una singola regola firewall. Sostituisci [FIREWALL-NAME] con il nome della regola firewall. Poiché i nomi delle regole firewall sono univoci per il progetto, non devi specificare una rete quando ne descrivi una esistente.

gcloud compute firewall-rules describe [FIREWALL-NAME]

API

Descrivi una determinata regola firewall.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls/FIREWALL_NAME

Sostituisci i segnaposto con valori validi:

• PROJECT_ID è l'ID del progetto in cui si trova la regola firewall.
• FIREWALL_NAME è il nome della regola firewall da descrivere.

Per ulteriori informazioni, consulta il metodo firewalls.get.

Eliminazione regole firewall

console

1. Elenca le regole del firewall. Puoi visualizzare un elenco di tutte le regole o solo di quelle in una determinata rete.
2. Fai clic sulla regola da eliminare.
3. Fai clic su Elimina.
4. Fai di nuovo clic su Elimina per confermare.

gcloud

Il comando seguente elimina una regola firewall. Sostituisci [FIREWALL-NAME] con il nome della regola da eliminare.

gcloud compute firewall-rules delete [FIREWALL-NAME]

API

Elimina una regola firewall.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls/FIREWALL_NAME

Sostituisci i segnaposto con valori validi:

• PROJECT_ID è l'ID del progetto in cui si trova la regola firewall.
• FIREWALL_NAME è il nome della regola firewall da eliminare.

Per ulteriori informazioni, consulta il metodo firewalls.delete.

C#

compute/api/Compute.Samples/DeleteFirewallRuleAsync.cs

Visualizza su GitHub

using Google.Cloud.Compute.V1;
using System.Threading.Tasks;

public class DeleteFirewallRuleAsyncSample
{
    public async Task DeleteFirewallRuleAsync(
        // TODO(developer): Set your own default values for these parameters or pass different values when calling this method.
        string projectId = "your-project-id",
        string firewallRuleName = "my-test-firewall-rule")
    {

        // Initialize client that will be used to send requests. This client only needs to be created
        // once, and can be reused for multiple requests.
        FirewallsClient client = await FirewallsClient.CreateAsync();

        // Make the request to delete the firewall rule.
        var firewallRuleDeletion = await client.DeleteAsync(projectId, firewallRuleName);

        // Wait for the operation to complete using client-side polling.
        await firewallRuleDeletion.PollUntilCompletedAsync();
    }
}

Go

compute/firewall/delete_firewall_rule.go

Visualizza su GitHub

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "google.golang.org/genproto/googleapis/cloud/compute/v1"
)

// deleteFirewallRule deletes a firewall rule from the project.
func deleteFirewallRule(w io.Writer, projectID, firewallRuleName string) error {
	// projectID := "your_project_id"
	// firewallRuleName := "europe-central2-b"

	ctx := context.Background()
	firewallsClient, err := compute.NewFirewallsRESTClient(ctx)
	if err != nil {
		return fmt.Errorf("NewInstancesRESTClient: %v", err)
	}
	defer firewallsClient.Close()

	req := &computepb.DeleteFirewallRequest{
		Project:  projectID,
		Firewall: firewallRuleName,
	}

	op, err := firewallsClient.Delete(ctx, req)
	if err != nil {
		return fmt.Errorf("unable to delete firewall rule: %v", err)
	}

	if err = op.Wait(ctx); err != nil {
		return fmt.Errorf("unable to wait for the operation: %v", err)
	}

	fmt.Fprintf(w, "Firewall rule deleted\n")

	return nil
}

Java

compute/cloud-client/src/main/java/compute/DeleteFirewallRule.java

Visualizza su GitHub

import com.google.api.gax.longrunning.OperationFuture;
import com.google.cloud.compute.v1.FirewallsClient;
import com.google.cloud.compute.v1.Operation;
import java.io.IOException;
import java.util.UUID;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.TimeoutException;

public class DeleteFirewallRule {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample
    // project: project ID or project number of the Cloud project you want to use.
    // firewallRuleName: name of the firewall rule you want to delete.
    String project = "your-project-id";
    String firewallRuleName = "firewall-rule-name-" + UUID.randomUUID();
    deleteFirewallRule(project, firewallRuleName);
  }

  // Deletes a firewall rule from the project.
  public static void deleteFirewallRule(String project, String firewallRuleName)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    /* Initialize client that will be used to send requests. This client only needs to be created
       once, and can be reused for multiple requests. After completing all of your requests, call
       the `firewallsClient.close()` method on the client to safely
       clean up any remaining background resources. */
    try (FirewallsClient firewallsClient = FirewallsClient.create()) {

      OperationFuture<Operation, Operation> operation = firewallsClient.deleteAsync(project,
          firewallRuleName);
      operation.get(3, TimeUnit.MINUTES);

      System.out.println("Deleted firewall rule -> " + firewallRuleName);
    }
  }
}

Node.js

samples/firewall/deleteFirewallRule.js

Visualizza su GitHub

/**
 * TODO(developer): Uncomment and replace these variables before running the sample.
 */
// const projectId = 'YOUR_PROJECT_ID';
// const firewallRuleName = 'FIREWALL_RULE_NAME';

const compute = require('@google-cloud/compute');

async function deleteFirewallRule() {
  const firewallsClient = new compute.FirewallsClient();
  const operationsClient = new compute.GlobalOperationsClient();

  const [response] = await firewallsClient.delete({
    project: projectId,
    firewall: firewallRuleName,
  });
  let operation = response.latestResponse;

  // Wait for the create operation to complete.
  while (operation.status !== 'DONE') {
    [operation] = await operationsClient.wait({
      operation: operation.name,
      project: projectId,
    });
  }

  console.log('Firewall rule deleted');
}

deleteFirewallRule();

PHP

compute/cloud-client/firewall/src/delete_firewall_rule.php

Visualizza su GitHub

use Google\Cloud\Compute\V1\FirewallsClient;

/**
 * Delete a firewall rule from the specified project.
 *
 * @param string $projectId Project ID or project number of the Cloud project you want to delete a rule for.
 * @param string $firewallRuleName Name of the rule that is deleted.
 *
 * @throws \Google\ApiCore\ApiException if the remote call fails.
 * @throws \Google\ApiCore\ValidationException if local error occurs before remote call.
 */
function delete_firewall_rule(string $projectId, string $firewallRuleName)
{
    $firewallsClient = new FirewallsClient();

    // Delete the firewall rule using Firewalls Client.
    $operation = $firewallsClient->delete($firewallRuleName, $projectId);

    // Wait for the operation to complete.
    $operation->pollUntilComplete();
    if ($operation->operationSucceeded()) {
        printf('Rule %s deleted successfully!' . PHP_EOL, $firewallRuleName);
    } else {
        $error = $operation->getError();
        printf('Failed to delete firewall rule: %s' . PHP_EOL, $error->getMessage());
    }
}

Python

campioni/snippet/firewall/delete.py

Visualizza su GitHub

import sys
from typing import Any

from google.api_core.extended_operation import ExtendedOperation
from google.cloud import compute_v1

def wait_for_extended_operation(
    operation: ExtendedOperation, verbose_name: str = "operation", timeout: int = 300
) -> Any:
    """
    This method will wait for the extended (long-running) operation to
    complete. If the operation is successful, it will return its result.
    If the operation ends with an error, an exception will be raised.
    If there were any warnings during the execution of the operation
    they will be printed to sys.stderr.

    Args:
        operation: a long-running operation you want to wait on.
        verbose_name: (optional) a more verbose name of the operation,
            used only during error and warning reporting.
        timeout: how long (in seconds) to wait for operation to finish.
            If None, wait indefinitely.

    Returns:
        Whatever the operation.result() returns.

    Raises:
        This method will raise the exception received from `operation.exception()`
        or RuntimeError if there is no exception set, but there is an `error_code`
        set for the `operation`.

        In case of an operation taking longer than `timeout` seconds to complete,
        a `concurrent.futures.TimeoutError` will be raised.
    """
    result = operation.result(timeout=timeout)

    if operation.error_code:
        print(
            f"Error during {verbose_name}: [Code: {operation.error_code}]: {operation.error_message}",
            file=sys.stderr,
            flush=True,
        )
        print(f"Operation ID: {operation.name}", file=sys.stderr, flush=True)
        raise operation.exception() or RuntimeError(operation.error_message)

    if operation.warnings:
        print(f"Warnings during {verbose_name}:\n", file=sys.stderr, flush=True)
        for warning in operation.warnings:
            print(f" - {warning.code}: {warning.message}", file=sys.stderr, flush=True)

    return result

def delete_firewall_rule(project_id: str, firewall_rule_name: str) -> None:
    """
    Deletes a firewall rule from the project.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        firewall_rule_name: name of the firewall rule you want to delete.
    """
    firewall_client = compute_v1.FirewallsClient()
    operation = firewall_client.delete(project=project_id, firewall=firewall_rule_name)

    wait_for_extended_operation(operation, "firewall rule deletion")
    return

Ruby

google-cloud-compute-v1/samples/firewall.rb

Visualizza su GitHub

require "google/cloud/compute/v1"

# Deletes a firewall rule from the project.
#
# @param [String] project project ID or project number of the Cloud project you want to use.
# @param [String] name name of the firewall rule you want to delete.
def delete_firewall_rule project:, name:
  client = ::Google::Cloud::Compute::V1::Firewalls::Rest::Client.new
  operation = client.delete project: project, firewall: name

  wait_until_done project: project, operation: operation.operation
end

Monitoraggio delle regole firewall

Puoi attivare il logging per le regole firewall per vedere quale regola è consentita o ha bloccato il traffico. Per le istruzioni, consulta la pagina relativa all'utilizzo del logging delle regole firewall.

Configurare regole di firewall per casi d'uso comuni

Le sezioni seguenti forniscono l'interfaccia a riga di comando gcloud di esempio e l'API per ricreare le regole firewall predefinite create per le reti predefinite. Puoi utilizzare gli esempi per creare regole simili per le reti in modalità personalizzata e automatica. Ogni regola firewall può includere intervalli di indirizzi IPv4 o IPv6, ma non entrambi.

Consenti connessioni in entrata interne tra le VM

Gli esempi seguenti creano una regola firewall per consentire le connessioni TCP, UDP e ICMP interne alle istanze VM, in modo simile alla regola allow-internal per le reti predefinite:

gcloud

gcloud compute firewall-rules create NAME \
    --action=ALLOW \
    --direction=INGRESS \
    --network=NETWORK; default="default" \
    --priority=1000 \
    --rules=tcp:0-65535,udp:0-65535,ICMP_PROTOCOL \
    --source-ranges=SUBNET_RANGES

Sostituisci quanto segue:

• NAME: il nome per questa regola firewall.
• NETWORK: il nome della rete a cui si applica questa regola firewall. Il valore predefinito è default.
• ICMP_PROTOCOL: specifica ICMPv4 utilizzando il nome di protocollo icmp o il numero di protocollo 1. Specifica ICMPv6 utilizzando il numero di protocollo 58.

• SUBNET_RANGES: uno o più intervalli di indirizzi IP. Se includi un intervallo di indirizzi IP, il traffico proveniente da tale intervallo può raggiungere qualsiasi destinazione VM nella rete VPC. Puoi specificare gli intervalli IPv4 o IPv6 in una determinata regola firewall.

  Intervalli di subnet IPv4:

  • Le reti VPC in modalità automatica utilizzano intervalli di indirizzi IP compresi in 10.128.0.0/9.
  • Le reti in modalità personalizzata possono utilizzare qualsiasi intervallo IPv4 valido. Se non utilizzi intervalli contigui per le subnet nella rete VPC, potrebbe essere necessario specificare più intervalli.
  • Puoi utilizzare 10.0.0.0/8,172.16.0.0/12,192.168.0.0/16 per consentire il traffico da tutti gli intervalli di indirizzi IPv4 privati (intervalli RFC 1918).

  Intervalli di subnet IPv6:

  • Se hai assegnato un intervallo di indirizzi IPv6 interno alla tua rete VPC, puoi utilizzare tale intervallo come intervallo di origine. L'utilizzo dell'intervallo IPv6 interno della rete VPC significa che la regola firewall include tutti gli intervalli di subnet IPv6 interni attuali e futuri. Puoi trovare l'intervallo IPv6 interno della rete VPC utilizzando il seguente comando:

    gcloud compute networks describe NETWORK \
      --format="flattened(internalIpv6Range)"
    

    Puoi anche specificare intervalli di subnet IPv6 interni specifici.

  • Per consentire il traffico dagli intervalli di subnet IPv6 esterni delle subnet a doppio stack, devi specificare l'intervallo di indirizzi IPv6 di ogni subnet da includere.

API

POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls
{
  "kind": "compute#firewall",
  "name": "FIREWALL_NAME",
  "network": "projects/PROJECT_ID/global/networks/NETWORK",
  "direction": "INGRESS",
  "priority": 1000,
  "targetTags": [],
  "allowed": [
    {
      "IPProtocol": "tcp",
      "ports": [
        "0-65535"
      ]
    },
    {
      "IPProtocol": "udp",
      "ports": [
        "0-65535"
      ]
    },
    {
      "IPProtocol": "ICMP_PROTOCOL"
    }
  ],
  "sourceRanges": [
    "SUBNET_RANGES"
  ]
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui si trova la rete VPC.
• FIREWALL_NAME: il nome della rete VPC in cui è creata la regola firewall.
• NETWORK: nome per la regola firewall. Si applica la regola. Il valore predefinito è default.
• ICMP_PROTOCOL: specifica ICMPv4 utilizzando il nome di protocollo icmp o il numero di protocollo 1. Specifica ICMPv6 utilizzando il numero di protocollo 58.

• INTERNAL_SOURCE_RANGES: uno o più intervalli IP. Per consentire il traffico interno in tutte le subnet delle reti VPC, specifica gli intervalli di indirizzi IP utilizzati nella rete VPC. Puoi specificare intervalli IPv4 o IPv6 in una determinata regola firewall.

  Intervalli di subnet IPv4:

  • Le reti VPC in modalità automatica utilizzano intervalli di indirizzi IP compresi in 10.128.0.0/9.
  • Le reti in modalità personalizzata possono utilizzare qualsiasi intervallo IPv4 valido. Se non utilizzi intervalli contigui per le subnet nella rete VPC, potrebbe essere necessario specificare più intervalli.
  • Puoi utilizzare 10.0.0.0/8,172.16.0.0/12,192.168.0.0/16 per consentire il traffico da tutti gli intervalli di indirizzi IPv4 privati (intervalli RFC 1918).

  Intervalli di subnet IPv6:

  • Se hai assegnato un intervallo di indirizzi IPv6 interno alla tua rete VPC, puoi utilizzare tale intervallo come intervallo di origine. L'utilizzo dell'intervallo IPv6 interno della rete VPC significa che la regola firewall include tutti gli intervalli di subnet IPv6 interni attuali e futuri. Puoi trovare l'intervallo IPv6 interno della rete VPC utilizzando il seguente comando:

    gcloud compute networks describe NETWORK \
      --format="flattened(internalIpv6Range)"
    

    Puoi anche specificare intervalli di subnet IPv6 interni specifici.

  • Per consentire il traffico dagli intervalli di subnet IPv6 esterni delle subnet a doppio stack, devi specificare l'intervallo di indirizzi IPv6 di ogni subnet da includere.

Consenti connessioni SSH in entrata alle VM

Gli esempi seguenti creano una regola firewall per consentire le connessioni SSH alle istanze VM, in modo simile alla regola allow-ssh per le reti predefinite:

gcloud

gcloud compute firewall-rules create NAME \
    --action=ALLOW \
    --direction=INGRESS \
    --network=NETWORK; default="default" \
    --priority=1000 \
    --rules=tcp:22 \
    --source-ranges=RANGES_OUTSIDE_VPC_NETWORK

Sostituisci quanto segue:

• NAME: il nome per questa regola firewall.
• NETWORK: il nome della rete a cui si applica questa regola firewall. Il valore predefinito è default.

• RANGES_OUTSIDE_VPC_NETWORK: uno o più intervalli di indirizzi IP. Puoi specificare intervalli IPv4 o IPv6 in una determinata regola firewall. Come best practice, specifica gli intervalli di indirizzi IP specifici da cui devi consentire l'accesso, anziché tutte le origini IPv4 o IPv6.

  • L'inclusione di 35.235.240.0/20 negli intervalli di origine consente le connessioni SSH tramite forwarding TCP con Identity-Aware Proxy (IAP) se tutti gli altri prerequisiti sono soddisfatti. Per ulteriori informazioni, consulta Utilizzo di IAP per l'inoltro TCP.
  • L'utilizzo di 0.0.0.0/0 come intervallo di origine consente il traffico da tutte le origini IPv4, incluse quelle esterne a Google Cloud.
  • L'utilizzo di ::/0 come intervallo di origini consente il traffico da tutte le origini IPv6, incluse quelle esterne a Google Cloud.

API

POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls
{
  "kind": "compute#firewall",
  "name": "FIREWALL_NAME",
  "network": "projects/PROJECT_ID/global/networks/NETWORK",
  "direction": "INGRESS",
  "priority": 1000,
  "targetTags": [],
  "allowed": [
    {
      "IPProtocol": "tcp",
      "ports": [
        "22"
      ]
    }
  ],
  "sourceRanges": [
    "RANGES_OUTSIDE_VPC_NETWORK"
  ]
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui si trova la rete VPC.
• FIREWALL_NAME: il nome della rete VPC in cui è creata la regola firewall.
• NETWORK: un nome per la regola firewall.

• RANGES_OUTSIDE_VPC_NETWORK: uno o più intervalli di indirizzi IP. Puoi specificare intervalli IPv4 o IPv6 in una determinata regola firewall. Come best practice, specifica gli intervalli di indirizzi IP specifici da cui devi consentire l'accesso, anziché tutte le origini IPv4 o IPv6.

  • L'inclusione di 35.235.240.0/20 negli intervalli di origine consente le connessioni SSH tramite forwarding TCP con Identity-Aware Proxy (IAP) se tutti gli altri prerequisiti sono soddisfatti. Per ulteriori informazioni, consulta Utilizzo di IAP per l'inoltro TCP.
  • L'utilizzo di 0.0.0.0/0 come intervallo di origine consente il traffico da tutte le origini IPv4, incluse quelle esterne a Google Cloud.
  • L'utilizzo di ::/0 come intervallo di origini consente il traffico da tutte le origini IPv6, incluse quelle esterne a Google Cloud.

Consenti connessioni RDP in entrata alle VM

Gli esempi seguenti creano una regola firewall per consentire le connessioni Microcoft Remote Desktop Protocol (RDP) alle istanze VM, in modo simile alla regola allow-rdp per le reti predefinite:

gcloud

gcloud compute firewall-rules create NAME \
    --action=ALLOW \
    --direction=INGRESS \
    --network=NETWORK; default="default" \
    --priority=1000 \
    --rules=tcp:3389 \
    --source-ranges=RANGES_OUTSIDE_VPC_NETWORK

Sostituisci quanto segue:

• NAME: il nome per questa regola firewall.
• NETWORK: il nome della rete a cui si applica questa regola firewall. Il valore predefinito è default.

• RANGES_OUTSIDE_VPC_NETWORK: uno o più intervalli di indirizzi IP. Puoi specificare intervalli IPv4 o IPv6 in una determinata regola firewall. Come best practice, specifica gli intervalli di indirizzi IP specifici da cui devi consentire l'accesso, anziché tutte le origini IPv4 o IPv6.

  • L'inclusione di 35.235.240.0/20 negli intervalli di origine consente le connessioni RDP che utilizzano l'inoltro TCP di Identity-Aware Proxy (IAP) se tutti gli altri prerequisiti sono soddisfatti. Per ulteriori informazioni, consulta Utilizzo di IAP per l'inoltro TCP.
  • L'utilizzo di 0.0.0.0/0 come intervallo di origine consente il traffico da tutte le origini IPv4, incluse quelle esterne a Google Cloud.
  • L'utilizzo di ::/0 come intervallo di origini consente il traffico da tutte le origini IPv6, incluse quelle esterne a Google Cloud.

API

POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls
{
  "kind": "compute#firewall",
  "name": "FIREWALL_NAME",
  "network": "projects/PROJECT_ID/global/networks/NETWORK",
  "direction": "INGRESS",
  "priority": 1000,
  "allowed": [
    {
      "IPProtocol": "tcp",
      "ports": [
        "3389"
      ]
    }
  ],
  "sourceRanges": [
    "EXTERNAL_SOURCE_RANGES"
  ]
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui si trova la rete VPC.
• FIREWALL_NAME: il nome della rete VPC in cui è creata la regola firewall.
• NETWORK: un nome per la regola firewall.

• RANGES_OUTSIDE_VPC_NETWORK: uno o più intervalli di indirizzi IP. Puoi specificare intervalli IPv4 o IPv6 in una determinata regola firewall. Come best practice, specifica gli intervalli di indirizzi IP specifici da cui devi consentire l'accesso, anziché tutte le origini IPv4 o IPv6.

  • L'inclusione di 35.235.240.0/20 negli intervalli di origine consente le connessioni RDP che utilizzano l'inoltro TCP di Identity-Aware Proxy (IAP) se tutti gli altri prerequisiti sono soddisfatti. Per ulteriori informazioni, consulta Utilizzo di IAP per l'inoltro TCP.
  • L'utilizzo di 0.0.0.0/0 come intervallo di origine consente il traffico da tutte le origini IPv4, incluse quelle esterne a Google Cloud.
  • L'utilizzo di ::/0 come intervallo di origini consente il traffico da tutte le origini IPv6, incluse quelle esterne a Google Cloud.

Consenti connessioni in entrata ICMP alle VM

Gli esempi seguenti creano una regola firewall per consentire le connessioni ICMP per le istanze VM, in modo simile alla regola allow-icmp per le reti predefinite:

gcloud

gcloud compute firewall-rules create NAME \
    --action=ALLOW \
    --direction=INGRESS \
    --network=NETWORK; default="default" \
    --priority=1000 \
    --rules=ICMP_PROTOCOL \
    --source-ranges=RANGES_OUTSIDE_VPC_NETWORK

Sostituisci quanto segue:

• NAME: il nome per questa regola firewall.
• NETWORK: il nome della rete a cui si applica questa regola firewall. Il valore predefinito è default.
• ICMP_PROTOCOL: specifica ICMPv4 utilizzando il nome di protocollo icmp o il numero di protocollo 1. Specifica ICMPv6 utilizzando il numero di protocollo 58.

• RANGES_OUTSIDE_VPC_NETWORK: uno o più intervalli di indirizzi IP. Puoi specificare intervalli IPv4 o IPv6 in una determinata regola firewall. Come best practice, specifica gli intervalli di indirizzi IP specifici da cui devi consentire l'accesso, anziché tutte le origini IPv4 o IPv6.

  • L'utilizzo di 0.0.0.0/0 come intervallo di origine consente il traffico da tutte le origini IPv4, incluse quelle esterne a Google Cloud.
  • L'utilizzo di ::/0 come intervallo di origini consente il traffico da tutte le origini IPv6, incluse quelle esterne a Google Cloud.

API

POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls
{
  "kind": "compute#firewall",
  "name": "FIREWALL_NAME",
  "network": "projects/PROJECT_ID/global/networks/NETWORK",
  "direction": "INGRESS",
  "priority": 1000,
  "targetTags": [],
  "allowed": [
    {
      "IPProtocol": "ICMP_PROTOCOL"
    }
  ],
  "sourceRanges": [
    "RANGES_OUTSIDE_VPC_NETWORK"
  ]
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto in cui si trova la rete VPC.
• FIREWALL_NAME: il nome della rete VPC in cui è creata la regola firewall.
• NETWORK: un nome per la regola firewall.
• ICMP_PROTOCOL: specifica ICMPv4 utilizzando il nome di protocollo icmp o il numero di protocollo 1. Specifica ICMPv6 utilizzando il numero di protocollo 58.

• RANGES_OUTSIDE_VPC_NETWORK: uno o più intervalli di indirizzi IP. Puoi specificare intervalli IPv4 o IPv6 in una determinata regola firewall. Come best practice, specifica gli intervalli di indirizzi IP specifici da cui devi consentire l'accesso, anziché tutte le origini IPv4 o IPv6.

  • L'utilizzo di 0.0.0.0/0 come intervallo di origine consente il traffico da tutte le origini IPv4, incluse quelle esterne a Google Cloud.
  • L'utilizzo di ::/0 come intervallo di origini consente il traffico da tutte le origini IPv6, incluse quelle esterne a Google Cloud.

Altri esempi di configurazione

Il diagramma seguente mostra una configurazione firewall di esempio. Lo scenario prevede un my-network che contiene quanto segue:

• una subnet subnet1 con intervallo IP 10.240.10.0/24
• una subnet subnet2 con intervallo IP 192.168.1.0/24
• istanza vm1 in subnet2 con tag webserver e IP interno 192.168.1.2
• istanza vm2 in subnet2 con tag database e IP interno 192.168.1.3

Esempio di configurazione di rete (fai clic per ingrandire)

Esempio 1: rifiuta tutte le connessioni TCP in entrata tranne quelle per la porta 80 di subnet1

Questo esempio crea un insieme di regole firewall che negano tutte le connessioni TCP in entrata tranne le connessioni destinate alla porta 80 da subnet1.

1. Crea una regola firewall per rifiutare tutto il traffico TCP in entrata verso le istanze con tag webserver.

   gcloud compute firewall-rules create deny-subnet1-webserver-access \
       --network NETWORK_NAME \
       --action deny \
       --direction ingress \
       --rules tcp \
       --source-ranges 0.0.0.0/0 \
       --priority 1000 \
       --target-tags webserver
   

2. Crea una regola firewall per consentire a tutti gli IP in subnet1 (10.240.10.0/24) di accedere alla porta TCP 80 sulle istanze con tag con webserver.

   gcloud compute firewall-rules create vm1-allow-ingress-tcp-port80-from-subnet1 \
       --network NETWORK_NAME \
       --action allow \
       --direction ingress \
       --rules tcp:80 \
       --source-ranges 10.240.10.0/24 \
       --priority 50 \
       --target-tags webserver
   

Esempio 2: negare tutte le connessioni TCP in uscita ad eccezione di quelle alla porta 80 di vm1

1. Crea una regola firewall per rifiutare tutto il traffico TCP in uscita.

   gcloud compute firewall-rules create deny-all-access \
       --network NETWORK_NAME \
       --action deny \
       --direction egress \
       --rules tcp \
       --destination-ranges 0.0.0.0/0 \
       --priority 1000
   

2. Crea una regola firewall per consentire il traffico TCP destinato alla porta vm1 80.

   gcloud compute firewall-rules create vm1-allow-egress-tcp-port80-to-vm1 \
       --network NETWORK_NAME \
       --action allow \
       --direction egress \
       --rules tcp:80 \
       --destination-ranges 192.168.1.2/32 \
       --priority 60
   

Esempio 3: consentire le connessioni TCP in uscita alla porta 443 di un host esterno

Crea una regola firewall che consenta alle istanze con tag webserver di inviare traffico TCP in uscita alla porta 443 di un indirizzo IP esterno di esempio, 192.0.2.5.

gcloud compute firewall-rules create vm1-allow-egress-tcp-port443-to-192-0-2-5 \
    --network NETWORK_NAME \
    --action allow \
    --direction egress \
    --rules tcp:443 \
    --destination-ranges 192.0.2.5/32 \
    --priority 70 \
    --target-tags webserver

Esempio 4: consentire connessioni SSH da vm2 a vm1

Crea la regola firewall che consente al traffico SSH da istanze con tag database (vm2) di raggiungere istanze con tag webserver (vm1).

gcloud compute firewall-rules create vm1-allow-ingress-tcp-ssh-from-vm2 \
    --network NETWORK_NAME \
    --action allow \
    --direction ingress \
    --rules tcp:22 \
    --source-tags database \
    --priority 80 \
    --target-tags webserver

Esempio 5: consenti il protocollo TCP:1443 dal server web al database utilizzando gli account di servizio

Per ulteriori informazioni sugli account di servizio e sui ruoli, vedi Concessione dei ruoli per gli account di servizio.

Considera lo scenario nel diagramma di seguito, in cui sono presenti due applicazioni che vengono scalate automaticamente tramite modelli, un'applicazione server web my-sa-web e un'applicazione di database 'my-sa-db". Un amministratore della sicurezza vuole consentire i flussi TCP alla porta di destinazione 1443 da my-sa-web a my-sa-db.

Utilizzo delle regole firewall con gli account di servizio (fai clic per ingrandire)

I passaggi per la configurazione, inclusa la creazione degli account di servizio, sono le seguenti:

1. Un EDITOR o un PROPRIETARIO del progetto crea gli account di servizio my-sa-web e my-sa-db.

   gcloud iam service-accounts create my-sa-web \
       --display-name "webserver service account"
   

   gcloud iam service-accounts create my-sa-db \
       --display-name "database service account"
   

2. Un proprietario di progetto assegna allo sviluppatore del server web [e-mail] un ruolo serviceAccountUser per l'account di servizio my-sa-web impostando un criterio IAM (Gestione di identità e accessi).

   gcloud iam service-accounts add-iam-policy-binding \
      [e-mail] \
      --member='user:[e-mail]' \
      --role='roles/iam.serviceAccountUser'
   

3. Un PROPRIETARIO di progetto assegna allo sviluppatore di database "[e-mail]" un ruolo di serviceAccountUser per l'account di servizio my-sa-db impostando un criterio IAM.

   gcloud iam service-accounts add-iam-policy-binding \
      [e-mail] \
      --member='user:[e-mail]' \
      --role='roles/iam.serviceAccountUser'
   

4. Lo sviluppatore [e-mail], che ha il ruolo Amministratore istanza, crea un modello di istanza server web e autorizza le istanze in esecuzione come account di servizio my-sa-web.

   gcloud compute instance-templates create [INSTANCE_TEMPLATE_NAME]  \
       --service-account [e-mail]
   

5. Lo sviluppatore [e-mail], che ha il ruolo Amministratore istanza, crea il modello di istanza di database e autorizza le istanze in esecuzione come account di servizio my-sa-db.

   gcloud compute instance-templates create [INSTANCE_TEMPLATE_NAME] \
       --service-account [e-mail]
   

6. L'amministratore della sicurezza crea le regole firewall utilizzando gli account di servizio per consentire il traffico TCP:1443 dall'account di servizio my-sa-web all'account di servizio my-sa-db.

   gcloud compute firewall-rules create FIREWALL_NAME \
       --network network_a \
       --allow TCP:1443 \
       --source-service-accounts [e-mail] \
       --target-service-accounts [e-mail]
   

Risolvere i problemi

Messaggi di errore durante la creazione o l'aggiornamento di una regola firewall

Potrebbe essere visualizzato uno dei seguenti messaggi di errore:

• Should not specify destination range for ingress direction.

  Gli intervalli di destinazione non sono parametri validi per le regole firewall in entrata. Si presume che le regole firewall siano regole in entrata, a meno che non venga specificata una direzione egress. Se crei una regola che non specifica una direzione, viene creata come regola in entrata, che non consente un intervallo di destinazione. Inoltre, gli intervalli di origine non sono parametri validi per le regole in uscita.

• Firewall direction cannot be changed once created.

  Non puoi modificare la direzione di una regola firewall esistente. Devi creare una nuova regola con i parametri corretti, quindi eliminare la vecchia.

• Firewall traffic control action cannot be changed once created.

  Non puoi modificare l'azione di una regola firewall esistente. Devi creare una nuova regola con i parametri corretti, quindi eliminare la vecchia.

• Service accounts must be valid RFC 822 email addresses. L'account di servizio specificato nella regola firewall deve essere un indirizzo email formattato in base al documento RFC 822.

  gcloud compute firewall-rules create bad --allow tcp --source-service-accounts invalid-email
  

  Creating firewall...failed.
  ERROR: (gcloud.compute.firewall-rules.create) Could not fetch resource:
  – Invalid value for field 'resource.sourceServiceAccounts[0]': 'invalid-email'. Service accounts must be valid RFC 822 email addresses.
  

• ServiceAccounts and Tags are mutually exclusive and can't be combined in the same firewall rule. Non puoi specificare sia gli account di servizio sia i tag nella stessa regola.

  gcloud compute firewall-rules create bad --allow tcp --source-service-accounts [e-mail] --target-tags target
  

  Creating firewall...failed.
   ERROR: (gcloud.compute.firewall-rules.create) Could not fetch resource:
  – ServiceAccounts and Tags are mutually exclusive and can't be combined in the same firewall rule.
  

Impossibile connettersi all'istanza VM

Se non riesci a connetterti a un'istanza VM, controlla le regole firewall.

1. Se stai avviando la connessione da un'altra istanza VM, elenca le regole del firewall in uscita per tale istanza.

   gcloud compute firewall-rules list --filter network=[NETWORK-NAME] \
       --filter EGRESS \
       --sort-by priority \
       --format="table(
           name,
           network,
           direction,
           priority,
           sourceRanges.list():label=SRC_RANGES,
           destinationRanges.list():label=DEST_RANGES,
           allowed[].map().firewall_rule().list():label=ALLOW,
           denied[].map().firewall_rule().list():label=DENY,
           sourceTags.list():label=SRC_TAGS,
           sourceServiceAccounts.list():label=SRC_SVC_ACCT,
           targetTags.list():label=TARGET_TAGS,
           targetServiceAccounts.list():label=TARGET_SVC_ACCT
           )"
   

2. Controlla se l'IP di destinazione è stato negato da qualsiasi regola in uscita. La regola con la priorità più alta (numero più basso) sostituisce le regole con priorità inferiore. La regola di negazione ha la precedenza per due regole con la stessa priorità.

3. Verifica la regola firewall in entrata per la rete che contiene l'istanza VM di destinazione.

   gcloud compute firewall-rules list --filter network=[NETWORK-NAME] \
       --filter INGRESS \
       --sort-by priority \
       --format="table(
           name,
           network,
           direction,
           priority,
           sourceRanges.list():label=SRC_RANGES,
           destinationRanges.list():label=DEST_RANGES,
           allowed[].map().firewall_rule().list():label=ALLOW,
           denied[].map().firewall_rule().list():label=DENY,
           sourceTags.list():label=SRC_TAGS,
           sourceServiceAccounts.list():label=SRC_SVC_ACCT,
           targetTags.list():label=TARGET_TAGS,
           targetServiceAccounts.list():label=TARGET_SVC_ACCT
           )"
   

   Output di esempio. L'output dipenderà dall'elenco di regole firewall

   NAME                    NETWORK  DIRECTION  PRIORITY  SRC_RANGES    DEST_RANGES  ALLOW                         DENY  SRC_TAGS  SRC_SVC_ACCT      TARGET_TAGS  TARGET_SVC_ACCT
   default-allow-icmp      default  INGRESS    65534     0.0.0.0/0                  icmp
   default-allow-internal  default  INGRESS    65534     10.128.0.0/9               tcp:0-65535,udp:0-65535,icmp
   default-allow-rdp       default  INGRESS    65534     0.0.0.0/0                  tcp:3389
   default-allow-ssh       default  INGRESS    65534     0.0.0.0/0                  tcp:22
   firewall-with-sa        default  INGRESS    1000                                 tcp:10000                                     [e-mail]               [e-mail]
   

4. Puoi anche eseguire test di connettività da/verso istanze VM in una rete VPC a un'altra rete VPC o in una rete cloud non Google per verificare se il traffico viene ignorato da eventuali regole firewall in entrata o in uscita. Per ulteriori informazioni su come eseguire i test di connettività per risolvere vari problemi, consulta la sezione Eseguire test di connettività.

La mia regola firewall è abilitata o disabilitata?

Per verificare se una regola firewall è attivata o disattivata, visualizza i dettagli delle regole firewall.

In Google Cloud Console, cerca Enabled o Disabled in Applicazione forzata.

Nell'output dell'interfaccia a riga di comando di Google Cloud, cerca il campo disabled. Se è indicato disabled:false, la regola è attivata ed è applicata. Se dice disabled: true, la regola è disattivata.

Quale regola viene applicata a un'istanza VM?

Dopo aver creato una regola, puoi verificare se viene applicata correttamente a un'istanza specifica. Per ulteriori informazioni, consulta Elencare le regole firewall per un'interfaccia di rete di un'istanza VM.

Le regole firewall con tag di origine non hanno effetto immediato

La propagazione delle regole firewall in entrata che utilizzano tag di origine può richiedere del tempo. Per maggiori dettagli, consulta le considerazioni relative ai tag sorgente per le regole firewall in entrata.

Passaggi successivi

• Consulta la panoramica delle regole firewall per un'introduzione alle regole firewall