Audit logging di Identity-Aware Proxy

Importante:

Il 14 febbraio 2024, il tipo di audit logging di Cloud è stato inavvertitamente modificato da DATA_ACCESS a ADMIN_ACTIVITY. Questa modifica comporta un cambiamento nel nome del log e nella posizione del bucket di log per i metodi UpdateIapSettings e ValidateIapAttributeExpression.

Il tipo di CAL è stato modificato di nuovo in DATA_ACCESS.

Cloud Audit Logs per Identity-Aware Proxy ti consente di monitorare le operazioni amministrative e di accesso ai dati sulle tue risorse per aiutarti a monitorare l'accesso e le modifiche alla configurazione. Puoi eseguire query su questi log in Esplora log e controllare quali metodi dell'API Identity-Aware Proxy generano Cloud Audit Logs.

Per saperne di più su Cloud Audit Logs, consulta i seguenti documenti:

• Tipi di audit log
• Struttura voce di log log
• Archiviazione e routing degli audit log
• Riepilogo dei prezzi di Cloud Logging
• Abilita gli audit log di accesso ai dati

Note

La sezione dei campi descrive dettagli importanti su alcuni campi del log di controllo.

Nome servizio

Per visualizzare gli audit log di Identity-Aware Proxy:

1. Nella console Google Cloud , vai alla pagina Esplora log:

   Vai a Esplora log

2. Copia e incolla la seguente query nel campo Query di Esplora log, quindi fai clic su Esegui query.

       protoPayload.serviceName="iap.googleapis.com"
     

Metodi per tipo di autorizzazione

Ogni autorizzazione IAM ha una proprietà type, il cui valore è un enum che può essere uno dei quattro valori: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Quando chiami un metodo, Identity-Aware Proxy genera un audit log la cui categoria dipende dalla proprietà type dell'autorizzazione richiesta per eseguire il metodo. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type corrispondente a DATA_READ, DATA_WRITE o ADMIN_READ generano audit log degli accessi ai dati. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type corrispondente a ADMIN_WRITE generano audit log delle attività di amministrazione.

I metodi API nel seguente elenco contrassegnati con (LRO) sono operazioni a lunga esecuzione (LRO). Questi metodi di solito generano due voci di log di controllo: una all'inizio dell'operazione e un'altra al termine. Per saperne di più, consulta Audit log per le operazioni a lunga esecuzione.

Tipo di autorizzazione	Metodi
ADMIN_READ	google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
ADMIN_WRITE	google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
DATA_READ	google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
DATA_WRITE	google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression

Audit log dell'interfaccia API

Per informazioni su come e quali autorizzazioni vengono valutate per ogni metodo, consulta la documentazione di Identity and Access Management per Identity-Aware Proxy.

google.cloud.iap.v1.IdentityAwareProxyAdminService

I seguenti audit log sono associati ai metodi appartenenti a google.cloud.iap.v1.IdentityAwareProxyAdminService.

CreateTunnelDestGroup

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.tunnelDestGroups.create - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.CreateTunnelDestGroup"
  

DeleteTunnelDestGroup

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.tunnelDestGroups.delete - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.DeleteTunnelDestGroup"
  

GetIamPolicy

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.tunnelServices.getIamPolicy - ADMIN_READ
  • iap.web.getIamPolicy - ADMIN_READ
  • iap.webServices.getIamPolicy - ADMIN_READ
  • iap.webTypes.getIamPolicy - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIamPolicy"
  

GetIapSettings

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.projects.getSettings - ADMIN_READ
  • iap.web.getSettings - ADMIN_READ
  • iap.webServiceVersions.getSettings - ADMIN_READ
  • iap.webServices.getSettings - ADMIN_READ
  • iap.webTypes.getSettings - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetIapSettings"
  

GetTunnelDestGroup

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.tunnelDestGroups.get - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.GetTunnelDestGroup"
  

ListTunnelDestGroups

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.tunnelDestGroups.list - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ListTunnelDestGroups"
  

SetIamPolicy

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • iap.tunnelServices.setIamPolicy - ADMIN_WRITE
  • iap.web.setIamPolicy - ADMIN_WRITE
  • iap.webServices.setIamPolicy - ADMIN_WRITE
  • iap.webTypes.setIamPolicy - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.SetIamPolicy"
  

UpdateIapSettings

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.projects.updateSettings - DATA_WRITE
  • iap.web.updateSettings - DATA_WRITE
  • iap.webServiceVersions.updateSettings - DATA_WRITE
  • iap.webServices.updateSettings - DATA_WRITE
  • iap.webTypes.updateSettings - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateIapSettings"
  

UpdateTunnelDestGroup

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.tunnelDestGroups.update - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.UpdateTunnelDestGroup"
  

ValidateIapAttributeExpression

• Metodo: google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.projects.updateSettings - DATA_WRITE
  • iap.web.updateSettings - DATA_WRITE
  • iap.webServices.updateSettings - DATA_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1.IdentityAwareProxyAdminService.ValidateIapAttributeExpression"
  

google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1

I seguenti audit log sono associati ai metodi appartenenti a google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.

GetIamPolicy

• Metodo: google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy
  
• Tipo di audit log: accesso ai dati
  
• Autorizzazioni:
  • iap.tunnelServices.getIamPolicy - ADMIN_READ
  • iap.web.getIamPolicy - ADMIN_READ
  • iap.webServiceVersions.getIamPolicy - ADMIN_READ
  • iap.webServices.getIamPolicy - ADMIN_READ
  • iap.webTypes.getIamPolicy - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.GetIamPolicy"
  

SetIamPolicy

• Metodo: google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy
  
• Tipo di audit log: attività di amministrazione
  
• Autorizzazioni:
  • iap.tunnelServices.setIamPolicy - ADMIN_WRITE
  • iap.webServiceVersions.setIamPolicy - ADMIN_WRITE
  • iap.webServices.setIamPolicy - ADMIN_WRITE
  • iap.webTypes.setIamPolicy - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: no.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.SetIamPolicy"
  

Metodi che non generano audit log

Un metodo potrebbe non generare audit log per uno o più dei seguenti motivi:

• Si tratta di un metodo ad alto volume che comporta costi significativi per la generazione e l'archiviazione dei log.
• Ha un valore di auditing basso.
• Un altro audit log o log della piattaforma fornisce già la copertura del metodo.

I seguenti metodi non generano audit log:

• google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateBrand
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.CreateIdentityAwareProxyClient
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.DeleteIdentityAwareProxyClient
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetBrand
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.GetIdentityAwareProxyClient
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListBrands
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.ListIdentityAwareProxyClients
• google.cloud.iap.v1.IdentityAwareProxyOAuthService.ResetIdentityAwareProxyClientSecret
• google.cloud.iap.v1beta1.IdentityAwareProxyAdminV1Beta1.TestIamPermissions

Campi

I log contengono solo informazioni sui livelli di accesso soddisfatti da un utente. I livelli di accesso che hanno bloccato una richiesta non autorizzata non sono elencati nella voce di log. Per determinare quali condizioni sono necessarie per effettuare una richiesta corretta per una determinata risorsa, controlla i livelli di accesso della risorsa.

Di seguito sono riportati dettagli importanti su alcuni campi del log:

Campo	Valore
authenticationInfo	L'indirizzo email dell'utente che ha tentato di accedere alla risorsa come principalEmail. Queste informazioni non sono presenti nei log per le richieste non autenticate.
requestMetadata.callerIp	L'indirizzo IP da cui ha avuto origine la richiesta.
requestMetadata.requestAttributes	Il metodo di richiesta e l'URL.
authorizationInfo.resource	La risorsa a cui si sta accedendo.
authorizationInfo.granted	Un valore booleano che indica se IAP ha consentito l'accesso richiesto.