Formato di logging delle regole dei criteri firewall

Questa pagina descrive la struttura di logging delle regole delle policy del firewall in Cloud Logging. Quando una regola firewall con il logging abilitato si applica al traffico da o verso un'istanza di macchina virtuale (VM), Cloud Logging crea una voce di log. I record di log vengono visualizzati nel campo del payload JSON di un Logging LogEntry.

I record di log del firewall sono costituiti da campi di base, che sono i campi principali di ogni record di log, e da campi di metadati facoltativi. Per ridurre i costi di archiviazione, puoi escludere i campi di metadati.

Alcuni campi di log possono contenere altri campi come valori. Ad esempio, il campo connection utilizza il formato IpConnection, che include l'indirizzo IP e la porta di origine e di destinazione e il protocollo in un unico campo.

La tabella seguente descrive i campi di log supportati per le regole delle policy del firewall di nuova generazione di Cloud, come quelle gerarchiche, globali e regionali, escludendo i campi legacy come i tag di rete e gli account di servizio, che non sono supportati per le policy del firewall di nuova generazione di Cloud.

Campo Descrizione Tipo di campo: metadati di base o facoltativi
connection IpConnection
5 tuple che descrivono l'indirizzo IP di origine e di destinazione, la porta di origine e di destinazione e il protocollo IP di questa connessione.		 Base
disposition Indica se la connessione è stata ALLOWED, DENIED, o INTERCEPTED. Base
rule_details RuleDetails
Dettagli della regola della policy del firewall. Il formato del log è {folder tier index}/firewallPolicy:{firewall policy ID} o network:{network name}/firewallPolicy:{firewall policy ID} in base all'ambito della policy.		 Base
instance InstanceDetails
Dettagli dell'istanza VM. In una configurazione del VPC condiviso, project_id corrisponde a quello del progetto di servizio.		 Metadati
load_balancer_details LoadBalancingDetails
Dettagli del bilanciatore del carico delle applicazioni interno o del bilanciatore del carico di rete proxy interno a cui si applica la regola della policy del firewall. Quando la destinazione di una regola firewall è uno di questi bilanciatori del carico, il campo instance viene omesso.		 Metadati
vpc VpcDetails
Dettagli della rete VPC. In una configurazione del VPC condiviso, project_id corrisponde a quello del progetto host.		 Metadati
remote_instance InstanceDetails
Se l'endpoint remoto della connessione era una VM situata in Compute Engine, questo campo viene compilato con i dettagli dell'istanza VM.		 Metadati
remote_vpc VpcDetails
Se l'endpoint remoto della connessione era una VM situata in una rete VPC, questo campo viene compilato con i dettagli della rete.		 Metadati
remote_location GeographicDetails
Se l'endpoint remoto della connessione era esterno alla rete VPC, questo campo viene compilato con i metadati della località disponibili.		 Metadati

IpConnection

Campo Tipo Descrizione
src_ip string Indirizzo IP di origine. Se l'origine è una VM di Compute Engine, src_ip è l'indirizzo IP interno primario o un indirizzo in un intervallo IP alias dell'interfaccia di rete della VM. L'indirizzo IP esterno non viene mostrato. Il logging mostra l'indirizzo IP della VM così come viene visualizzato nell'intestazione del pacchetto, come se avessi eseguito tcpdump sulla VM.
src_port integer Porta di origine
dest_ip string Indirizzo IP di destinazione. Se la destinazione è una Google Cloud VM, dest_ip è l'indirizzo IP interno primario o un indirizzo in un intervallo IP alias dell'interfaccia di rete della VM. L'indirizzo IP esterno non viene mostrato anche se è stato utilizzato per stabilire la connessione.
dest_port integer La porta di destinazione.
protocol integer Protocollo IP della connessione.

RuleDetails

Campo Tipo Descrizione
reference string Il percorso assoluto univoco della risorsa alla regola che corrisponde al traffico di rete. Il formato per le regole delle policy del firewall è:
  • Policy del firewall gerarchica: {folder tier index}/firewallPolicy:{id}
  • Policy del firewall globale: network:{network name}/firewallPolicy:{id}
  • Policy del firewall regionale: network:{network name}/region:{region name}/firewallPolicy:{id}
priority integer La priorità della regola della policy del firewall.
action string L'azione della regola della policy del firewall. Può essere ALLOW, DENY, o APPLY_SECURITY_PROFILE_GROUP.
source_networks[ ] string Elenco delle reti VPC quando il parametro del contesto di rete di origine è VPC_NETWORKS.
destination_networks[ ] string Elenco delle reti VPC quando il parametro del contesto di rete di destinazione è VPC_NETWORKS.
source_network_context string Il contesto di rete per il traffico a cui si applica una regola in entrata.
destination_network_context string Il contesto di rete per il traffico a cui si applica una regola in uscita.
apply_security_profile_fallback_action string Applicabile se l'azione è APPLY_SECURITY_PROFILE_GROUP. I valori sono ALLOW o UNSPECIFIED impostati se la disposizione della connessione è INTERCEPTED.
direction string La direzione a cui si applica la regola della policy del firewall. Può essere INGRESS o EGRESS.
source_range[ ] string (Metadati facoltativi) Elenco degli intervalli di origine a cui si applica la regola della policy del firewall.
destination_range[ ] string (Metadati facoltativi) Elenco degli intervalli di destinazione a cui si applica la regola della policy del firewall.
ip_port_info[ ] string (Metadati facoltativi) Elenco dei protocolli IP e degli intervalli di porte applicabili per le regole.
target_resource[ ] string (Metadati facoltativi) Stringhe di risorse di destinazione formattate come projects/{project ID}/global/networks/{network name}. È disponibile nelle policy del firewall gerarchiche.
source_secure_tag[ ] string (Metadati facoltativi) Elenco di tutti i tag sicuri di origine a cui si applica la regola della policy del firewall.
target_secure_tag[ ] string (Metadati facoltativi) Elenco di tutti i tag sicuri di destinazione a cui si applica la regola della policy del firewall.
source_region_code[ ] string (Metadati facoltativi) Elenco di tutti i codici paese di origine a cui si applica la regola della policy del firewall.
destination_region_code[ ] string (Metadati facoltativi) Elenco di tutti i codici paese di destinazione a cui si applica la regola della policy del firewall.
source_fqdn[ ] string (Metadati facoltativi) Elenco di tutti i nomi di dominio di origine a cui si applica la regola della policy del firewall.
destination_fqdn[ ] string (Metadati facoltativi) Elenco di tutti i nomi di dominio di destinazione a cui si applica la regola della policy del firewall.
source_threat_intelligence[ ] string (Metadati facoltativi) Elenco di tutti i nomi degli elenchi di Google Threat Intelligence di origine a cui si applica la regola della policy del firewall.
destination_threat_intelligence[ ] string (Metadati facoltativi) Elenco di tutti i nomi degli elenchi di Google Threat Intelligence di destinazione a cui si applica la regola della policy del firewall.
source_address_groups[ ] string (Metadati facoltativi) Elenco di tutti i gruppi di indirizzi di origine a cui si applica la regola della policy del firewall.
destination_address_groups[ ] string (Metadati facoltativi) Elenco di tutti i gruppi di indirizzi di destinazione a cui si applica la regola della policy del firewall.
target_type string INSTANCES o INTERNAL_MANAGED_LB
target_forwarding_rules string Elenco degli URL delle regola di forwarding complete o parziali per i bilanciatori del carico delle applicazioni interni o i bilanciatori del carico di rete proxy interni a cui si applica la regola firewall.

IpPortDetails

Campo Tipo Descrizione
ip_protocol string Protocollo IP a cui si applica la regola della policy del firewall. Non può essere impostato su ALL per le regole delle policy del firewall.
port_range[ ] string Elenco degli intervalli di porte applicabili per le regole delle policy del firewall. Ad esempio, 8080-9090.

InstanceDetails

Campo Tipo Descrizione
project_id string ID del progetto contenente la VM di Compute Engine.
vm_name string Nome istanza della VM di Compute Engine.
region string Regione della VM di Compute Engine.
zone string Zona della VM di Compute Engine.

LoadBalancingDetails

Campo Tipo Descrizione
forwarding_rule_project_id string Google Cloud ID progetto contenente la regola di forwarding.
type string Tipo di bilanciatore del carico: APPLICATION_LOAD_BALANCER indica un bilanciatore del carico delle applicazioni interno. PROXY_NETWORK_LOAD_BALANCER indica un bilanciatore del carico di rete proxy interno.
scheme string Schema del bilanciatore del carico, INTERNAL_MANAGED.
url_map_name string Nome della mappa URL. Viene compilato solo se il type è APPLICATION_LOAD_BALANCER.
forwarding_rule_name string Nome della regola di forwarding.

VpcDetails

Campo Tipo Descrizione
project_id string ID del progetto contenente la rete.
vpc_name string Rete su cui è in esecuzione la VM.
subnetwork_name string Subnet su cui è in esecuzione la VM.

GeographicDetails

Campo Tipo Descrizione
continent string Nome del continente per gli endpoint esterni.
country string Nome del paese per gli endpoint esterni.
region string Nome della regione per gli endpoint esterni.
city string Nome della città per gli endpoint esterni.

Passaggi successivi