Utilizzo del logging delle richieste

I log per richiesta di Google Cloud Armor relativi al nome del criterio di sicurezza, alla priorità della regola di corrispondenza, all'azione associata e alle informazioni correlate vengono registrati nell'ambito della registrazione per i bilanciatori del carico delle applicazioni esterni e i bilanciatori del carico di rete proxy esterni. Il logging per i nuovi servizi di backend è disabilitato per impostazione predefinita, quindi devi attivarlo per registrare informazioni complete per Google Cloud Armor.

I log di Google Cloud Armor fanno parte dei log di Cloud Load Balancing. Ciò significa che la generazione dei log di Google Cloud Armor è soggetta alla frequenza di campionamento dei log configurata per il bilanciatore del carico. Se riduci la frequenza di campionamento per il bilanciatore del carico, i log delle richieste di Google Cloud Armor vengono campionati a quella frequenza ridotta. Inoltre, se utilizzi il riferimento ai servizi tra progetti, i log vengono generati nel progetto host o di servizio che include il frontend e la mappa URL del bilanciatore del carico. Pertanto, consigliamo agli amministratori del progetto frontend di concedere le autorizzazioni per leggere i log e le metriche agli amministratori del progetto di backend.

Utilizzando i log, puoi visualizzare ogni richiesta valutata da un criterio di sicurezza di Google Cloud Armor e il risultato o l'azione intrapresa in base alla regola di corrispondenza con la priorità più alta. Ad esempio, per visualizzare le richieste rifiutate, puoi utilizzare filtri come jsonPayload.enforcedSecurityPolicy.outcome="DENY" o jsonPayload.statusDetails="denied_by_security_policy".

Per attivare il logging per un bilanciatore del carico delle applicazioni esterno, consulta Logging e monitoraggio del bilanciatore del carico delle applicazioni esterno. Per il bilanciatore del carico di rete con proxy esterno, puoi utilizzare i comandi Google Cloud CLI elencati nella pagina Monitoraggio e generazione di log del bilanciatore del carico delle applicazioni esterno precedente. Non puoi attivare la registrazione per il bilanciatore del carico di rete proxy esterno utilizzando la console Google Cloud.

Inoltre, puoi impostare diversi livelli di logging per valutare se i criteri di sicurezza e le relative regole funzionano come previsto. Per informazioni complete, consulta Registrazione dettagliata dei log.

Voci di log dei criteri di sicurezza

Le seguenti voci di log in Logs Explorer sono relative al logging dei criteri e delle regole di sicurezza di Google Cloud Armor. Le voci includono la seguente struttura in jsonPayload. I dettagli della richiesta HTTP vengono visualizzati nel messaggio httpRequest.

  • statusDetails (stringa): una descrizione testuale del codice di risposta.
    • redirected_by_security_policy: la richiesta è stata reindirizzata da una regola di reindirizzamento, GOOGLE_RECAPTCHA o EXTERNAL_302.
    • denied_by_security_policy: una richiesta è stata rifiutata dal bilanciatore del carico per via di un criterio di sicurezza di Google Cloud Armor.
    • body_denied_by_security_policy: il corpo di una richiesta è stato negato dal bilanciatore del carico a causa di un criterio di sicurezza di Google Cloud Armor.
  • enforcedSecurityPolicy: la regola del criterio di sicurezza applicata.
    • name (stringa): il nome del criterio di sicurezza.
    • priority (numero): la priorità della regola di corrispondenza nel criterio di sicurezza.
    • adaptiveProtection: informazioni sulla regola di Protezione adattiva di cui è stato eseguito il deployment automatico, se applicabile.
      • autoDeployAlertId: l'ID avviso degli eventi rilevati da Adaptive Protection.
    • configuredAction (stringa): il nome dell'azione configurata nella regola di corrispondenza, ad esempio ALLOW, DENY, GOOGLE_RECAPTCHA, EXTERNAL_302, THROTTLE (per una regola di limitazione), RATE_BASED_BAN (per una regola di divieto in base alla frequenza).
    • rateLimitAction: informazioni sull'azione di limite di frequenza quando viene trovata una corrispondenza con una regola di limitazione o di esclusione basata sulla frequenza.
      • key (stringa): valore della chiave del limite di frequenza (fino a 36 byte). Questo campo viene omesso se il tipo di chiave è ALL o se il tipo di chiave è HTTP-HEADER oHTTP-COOKIE e l'intestazione o il cookie specificato non è presente nella richiesta.
      • outcome (stringa): i valori possibili sono i seguenti:
        • "RATE_LIMIT_THRESHOLD_CONFORM" se inferiore alla soglia di limite di frequenza configurata.
        • "RATE_LIMIT_THRESHOLD_EXCEED" se supera la soglia del limite di frequenza configurato.
        • "BAN_THRESHOLD_EXCEED" se superiore alla soglia di ban configurata.
    • outcome (stringa): il risultato dell'esecuzione dell'azione configurata, ad esempio ACCEPT, DENY, REDIRECT, EXEMPT.
    • preconfiguredExprIds (stringa): gli ID di tutte le espressioni di regole WAF preconfigurate che hanno attivato la regola.
    • threatIntelligence: informazioni sugli elenchi di indirizzi IP corrispondenti di Threat Intelligence, se applicabili.
      • categories: (stringa) i nomi degli elenchi di indirizzi IP corrispondenti.
  • previewSecurityPolicy: viene compilato se una richiesta corrisponde a una regola configurata per l'anteprima (presente solo quando una regola di anteprima avrebbe avuto la priorità sulla regola applicata).
    • name (stringa): il nome del criterio di sicurezza
    • priority (numero): la priorità della regola di corrispondenza nel criterio di sicurezza.
    • configuredAction (stringa): il nome dell'azione configurata nella regola di corrispondenza, ad esempio ALLOW, DENY, GOOGLE_RECAPTCHA, EXTERNAL_302, THROTTLE (per una regola di limitazione), RATE_BASED_BAN (per una regola di divieto in base alla frequenza).
    • rateLimitAction: informazioni sull'azione di limite di frequenza quando viene trovata una corrispondenza con una regola di limitazione o di esclusione basata sulla frequenza.
      • key (stringa): valore della chiave del limite di frequenza (fino a 36 byte). Questo campo viene omesso se il tipo di chiave è ALL o se il tipo di chiave è HTTP-HEADER oHTTP-COOKIE e l'intestazione o il cookie specificato non è presente nella richiesta.
      • outcome (stringa): i valori possibili sono i seguenti:
        • "RATE_LIMIT_THRESHOLD_CONFORM" se inferiore alla soglia di limite di frequenza configurata.
        • "RATE_LIMIT_THRESHOLD_EXCEED" se supera la soglia del limite di frequenza configurato.
        • "BAN_THRESHOLD_EXCEED" se superiore alla soglia di ban configurata.
    • outcome (stringa): il risultato dell'esecuzione dell'azione configurata.
    • outcome (stringa): il risultato dell'esecuzione dell'azione configurata, ad esempio ACCEPT, DENY, REDIRECT, EXEMPT.
    • preconfiguredExprIds (stringa): gli ID di tutte le espressioni di regole WAF preconfigurate che hanno attivato la regola.
    • threatIntelligence: informazioni sugli elenchi di indirizzi IP corrispondenti di Threat Intelligence, se applicabili.
      • categories: (stringa) i nomi degli elenchi di indirizzi IP corrispondenti.
  • enforcedEdgeSecurityPolicy (Anteprima): la regola del criterio di sicurezza edge applicata.
    • name (stringa): il nome del criterio di sicurezza.
    • priority (numero): la priorità della regola di corrispondenza nel criterio di sicurezza.
    • configuredAction (stringa): il nome dell'azione configurata nella regola di corrispondenza, ad esempio ALLOW, DENY.
    • outcome (stringa): il risultato dell'esecuzione dell'azione configurata, ad esempio ACCEPT, DENY.
  • previewEdgeSecurityPolicy (Anteprima): viene compilato se una richiesta corrisponde a una regola del criterio di sicurezza di Edge configurata per l'anteprima (presente solo quando una regola di anteprima avrebbe avuto la priorità sulla regola applicata).
    • name (stringa): il nome del criterio di sicurezza.
    • priority (numero): la priorità della regola di corrispondenza nel criterio di sicurezza.
    • configuredAction (stringa): il nome dell'azione configurata nella regola di corrispondenza, ad esempio ALLOW, DENY.
    • outcome (stringa): il risultato dell'esecuzione dell'azione configurata, ad esempio ACCEPT, DENY.

Visualizzazione dei log

Puoi visualizzare i log di un criterio di sicurezza di Google Cloud Armor solo nella console Google Cloud.

Console

  1. Nella console Google Cloud, vai a Criteri di Google Cloud Armor.

    Vai ai criteri di Google Cloud Armor

  2. Fai clic su Azioni.

  3. Seleziona Visualizza log.

Richiedi il logging dei dati

Se utilizzato con Google Cloud Armor, jsonPayload ha il seguente campo aggiuntivo:

  • securityPolicyRequestData: i dati relativi alla richiesta durante il loro trattamento da parte di un criterio di sicurezza, indipendentemente dalla regola che viene infine trovata.
    • recaptchaActionToken: dati relativi a un token di azione reCAPTCHA.
      • score (float): un punteggio di legittimità dell'utente incorporato in un token di azione reCAPTCHA. Presente solo quando un token di azione reCAPTCHA è associato alla richiesta e viene decodificato correttamente in base a una regola del criterio di sicurezza. Per ulteriori informazioni, consulta Applicare la valutazione reCAPTCHA.
    • recaptchaSessionToken: dati relativi a un token sessione reCAPTCHA.
      • score (float): un punteggio di legittimità dell'utente incorporato in un token di sessione reCAPTCHA. Presente solo quando un token sessione reCAPTCHA è associato alla richiesta e viene decodificato correttamente in base a una regola del criterio di sicurezza.
    • tlsJa3Fingerprint: un'impronta TTL/SSL JA3 se il client si connette utilizzando HTTPS, HTTP/2 o HTTP/3. Presente solo se l'impronta è disponibile ed esiste un criterio di sicurezza che valuta la richiesta (indipendentemente dal fatto che un'espressione nel criterio corrisponda alla richiesta).

Esempi di log

Di seguito è riportato un esempio di dettagli del log per una regola di limitazione che blocca una richiesta:

jsonPayload: {
 enforcedSecurityPolicy: {
  priority: 100
  name: "sample-prod-policy"
  configuredAction: "THROTTLE"
  outcome: "DENY"
  rateLimitAction: {
    key:"sample-key"
    outcome:"RATE_LIMIT_THRESHOLD_EXCEED"
  }
 }
 @type: "type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry"
 statusDetails: "denied_by_security_policy"
}
httpRequest: {8}
resource: {2}
timestamp: "2021-03-17T19:16:48.185763Z"

Di seguito è riportato un esempio di dettagli del log per una regola di blocco basata sulla frequenza che blocca una richiesta:

jsonPayload: {
 @type: "type.googleapis.com/google.cloud.loadbalancing.type.LoadBalancerLogEntry"
 enforcedSecurityPolicy: {
  priority: 150
  name: "sample-prod-policy"
  outcome: "DENY"
  configuredAction: "RATE_BASED_BAN"
  rateLimitAction: {
    key:"sample-key"
    outcome:"BAN_THRESHOLD_EXCEED"
  }
 }
 statusDetails: "denied_by_security_policy"
}
httpRequest: {8}
resource: {2}
timestamp: "2021-03-17T19:27:17.393244Z"

Passaggi successivi

Scopri di più sulla risoluzione dei problemi di Google Cloud Armor.