Audit logging di Cloud Key Management Service

Cloud Key Management Service sta aggiornando il formato di protoPayload nelle sue voci di audit log di accesso ai dati. Durante il periodo di migrazione, protoPayload all'interno delle voci del log di controllo di accesso ai dati rimarrà invariato la compatibilità con le versioni precedenti. Tuttavia, le applicazioni di codice nuove o future devono utilizzare i campi di sostituzione consigliati come segue:

Campo sostitutivo consigliato	Campo obsoleto	Descrizione
protoPayload.status.details	protoPayload.metadata	Dettagli dell'errore per EXTERNAL (ad es. le operazioni delle chiavi Cloud EKM.
protoPayload.metadata.entries.caller_provided_context	protoPayload.request.caller_provided_context	Contesto del chiamante associato a questa operazione Cloud KMS.

Questo documento descrive l'audit logging per Cloud Key Management Service. Servizi Google Cloud generare audit log che registrano le attività amministrative e di accesso all'interno delle tue risorse Google Cloud. Per saperne di più su Cloud Audit Logs, consulta le seguenti pagine della documentazione:

• Tipi di log di controllo
• Struttura voce di log log
• Dettagli su archiviazione e routing degli audit log
• Riepilogo dei prezzi di Cloud Logging
• Come abilitare gli audit log di accesso ai dati

Nome servizio

Gli audit log di Cloud Key Management Service utilizzano il nome del servizio cloudkms.googleapis.com. Filtra per questo servizio:

    protoPayload.serviceName="cloudkms.googleapis.com"
  

Metodi per tipo di autorizzazione

Ogni autorizzazione IAM ha una proprietà type, il cui valore è un'enumerazione che può essere uno dei quattro valori: ADMIN_READ, ADMIN_WRITE, DATA_READ o DATA_WRITE. Quando chiami un metodo, Cloud Key Management Service genera un audit log la cui categoria dipende dal Proprietà type dell'autorizzazione richiesta per eseguire il metodo. Metodi che richiedono un'autorizzazione IAM con il valore della proprietà type di DATA_READ, DATA_WRITE o ADMIN_READ generano Audit log di accesso ai dati. Metodi che richiedono un'autorizzazione IAM con il valore della proprietà type di ADMIN_WRITE generano Audit log delle attività di amministrazione.

Tipo di autorizzazione	Metodi
ADMIN_READ	GetCryptoKey GetCryptoKeyVersion GetEkmConfig GetEkmConnection GetIamPolicy GetImportJob GetKeyRing ListCryptoKeyVersions ListCryptoKeys ListEkmConnections ListImportJobs ListKeyRings VerifyConnectivity google.cloud.kms.v1.Autokey.GetKeyHandle google.cloud.kms.v1.Autokey.ListKeyHandles google.cloud.kms.v1.AutokeyAdmin.GetAutokeyConfig google.cloud.kms.v1.AutokeyAdmin.ShowEffectiveAutokeyConfig
ADMIN_WRITE	CreateCryptoKey CreateCryptoKeyVersion CreateEkmConnection CreateImportJob CreateKeyRing DestroyCryptoKeyVersion GetOperation ImportCryptoKeyVersion RestoreCryptoKeyVersion SetIamPolicy UpdateCryptoKey UpdateCryptoKeyPrimaryVersion UpdateCryptoKeyVersion UpdateEkmConfig UpdateEkmConnection google.cloud.kms.v1.Autokey.CreateKeyHandle google.cloud.kms.v1.AutokeyAdmin.UpdateAutokeyConfig
DATA_READ	AsymmetricDecrypt AsymmetricSign Decrypt Encrypt GetPublicKey MacSign MacVerify RawDecrypt RawEncrypt

Audit log dell'interfaccia API

Per informazioni su come e quali autorizzazioni vengono valutate per ciascun metodo, consulta la documentazione di Identity and Access Management per Cloud Key Management Service.

google.cloud.kms.v1.Autokey

La sezione seguente contiene i dettagli dei log di controllo associati ai metodi appartenenti a google.cloud.kms.v1.Autokey.

CreateKeyHandle

• Metodo: google.cloud.kms.v1.Autokey.CreateKeyHandle
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.keyHandles.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: Operazione a lunga esecuzione
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.kms.v1.Autokey.CreateKeyHandle"
  

GetKeyHandle

• Metodo: google.cloud.kms.v1.Autokey.GetKeyHandle
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.keyHandles.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.kms.v1.Autokey.GetKeyHandle"
  

ListKeyHandles

• Metodo: google.cloud.kms.v1.Autokey.ListKeyHandles
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.keyHandles.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.kms.v1.Autokey.ListKeyHandles"
  

google.cloud.kms.v1.AutokeyAdmin

La sezione seguente contiene i dettagli dei log di controllo associati ai metodi appartenenti a google.cloud.kms.v1.AutokeyAdmin.

GetAutokeyConfig

• Metodo: google.cloud.kms.v1.AutokeyAdmin.GetAutokeyConfig
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.autokeyConfigs.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.kms.v1.AutokeyAdmin.GetAutokeyConfig"
  

ShowEffectiveAutokeyConfig

• Metodo: google.cloud.kms.v1.AutokeyAdmin.ShowEffectiveAutokeyConfig
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.projects.showEffectiveAutokeyConfig - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.kms.v1.AutokeyAdmin.ShowEffectiveAutokeyConfig"
  

UpdateAutokeyConfig

• Metodo: google.cloud.kms.v1.AutokeyAdmin.UpdateAutokeyConfig
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.autokeyConfigs.update - ADMIN_WRITE
  • cloudkms.cryptoKeys.setIamPolicy - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="google.cloud.kms.v1.AutokeyAdmin.UpdateAutokeyConfig"
  

google.cloud.kms.v1.EkmService

La sezione seguente contiene i dettagli sugli audit log associati a metodi appartenenti a google.cloud.kms.v1.EkmService.

CreateEkmConnection

• Metodo: CreateEkmConnection
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.ekmConnections.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="CreateEkmConnection"
  

GetEkmConfig

• Metodo: GetEkmConfig
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.ekmConfigs.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="GetEkmConfig"
  

GetEkmConnection

• Metodo: GetEkmConnection
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.ekmConnections.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="GetEkmConnection"
  

ListEkmConnections

• Metodo: ListEkmConnections
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.ekmConnections.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="ListEkmConnections"
  

UpdateEkmConfig

• Metodo: UpdateEkmConfig
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.ekmConfigs.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="UpdateEkmConfig"
  

UpdateEkmConnection

• Metodo: UpdateEkmConnection
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.ekmConnections.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="UpdateEkmConnection"
  

VerifyConnectivity

• Metodo: VerifyConnectivity
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.ekmConnections.verifyConnectivity - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="VerifyConnectivity"
  

google.cloud.kms.v1.KeyManagementService

La sezione seguente contiene i dettagli sugli audit log associati a metodi appartenenti a google.cloud.kms.v1.KeyManagementService.

AsymmetricDecrypt

• Metodo: AsymmetricDecrypt
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.useToDecrypt - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="AsymmetricDecrypt"
  

AsymmetricSign

• Metodo: AsymmetricSign
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.useToSign - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="AsymmetricSign"
  

CreateCryptoKey

• Metodo: CreateCryptoKey
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.cryptoKeys.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="CreateCryptoKey"
  

CreateCryptoKeyVersion

• Metodo: CreateCryptoKeyVersion
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="CreateCryptoKeyVersion"
  

CreateImportJob

• Metodo: CreateImportJob
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.importJobs.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="CreateImportJob"
  

CreateKeyRing

• Metodo: CreateKeyRing
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.keyRings.create - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="CreateKeyRing"
  

Decrypt

• Metodo: Decrypt
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.useToDecrypt - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="Decrypt"
  

DestroyCryptoKeyVersion

• Metodo: DestroyCryptoKeyVersion
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.destroy - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="DestroyCryptoKeyVersion"
  

Encrypt

• Metodo: Encrypt
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.useToEncrypt - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="Encrypt"
  

GetCryptoKey

• Metodo: GetCryptoKey
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeys.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="GetCryptoKey"
  

GetCryptoKeyVersion

• Metodo: GetCryptoKeyVersion
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="GetCryptoKeyVersion"
  

GetImportJob

• Metodo: GetImportJob
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.importJobs.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="GetImportJob"
  

GetKeyRing

• Metodo: GetKeyRing
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.keyRings.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="GetKeyRing"
  

GetPublicKey

• Metodo: GetPublicKey
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.viewPublicKey - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="GetPublicKey"
  

ImportCryptoKeyVersion

• Metodo: ImportCryptoKeyVersion
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.create - ADMIN_WRITE
  • cloudkms.cryptoKeyVersions.update - ADMIN_WRITE
  • cloudkms.importJobs.useToImport - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="ImportCryptoKeyVersion"
  

ListCryptoKeyVersions

• Metodo: ListCryptoKeyVersions
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="ListCryptoKeyVersions"
  

ListCryptoKeys

• Metodo: ListCryptoKeys
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeys.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="ListCryptoKeys"
  

ListImportJobs

• Metodo: ListImportJobs
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.importJobs.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="ListImportJobs"
  

ListKeyRings

• Metodo: ListKeyRings
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.keyRings.list - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="ListKeyRings"
  

MacSign

• Metodo: MacSign
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.useToSign - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="MacSign"
  

MacVerify

• Metodo: MacVerify
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.useToVerify - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="MacVerify"
  

RawDecrypt

• Metodo: RawDecrypt
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.useToDecrypt - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="RawDecrypt"
  

RawEncrypt

• Metodo: RawEncrypt
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.useToEncrypt - DATA_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="RawEncrypt"
  

RestoreCryptoKeyVersion

• Metodo: RestoreCryptoKeyVersion
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.restore - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="RestoreCryptoKeyVersion"
  

UpdateCryptoKey

• Metodo: UpdateCryptoKey
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.cryptoKeys.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="UpdateCryptoKey"
  

UpdateCryptoKeyPrimaryVersion

• Metodo: UpdateCryptoKeyPrimaryVersion
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.cryptoKeys.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="UpdateCryptoKeyPrimaryVersion"
  

UpdateCryptoKeyVersion

• Metodo: UpdateCryptoKeyVersion
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.cryptoKeyVersions.update - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="UpdateCryptoKeyVersion"
  

google.iam.v1.IAMPolicy

La sezione seguente contiene i dettagli dei log di controllo associati ai metodi appartenenti a google.iam.v1.IAMPolicy.

GetIamPolicy

• Metodo: GetIamPolicy
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.cryptoKeys.getIamPolicy - ADMIN_READ
  • cloudkms.keyRings.getIamPolicy - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="GetIamPolicy"
  

SetIamPolicy

• Metodo: SetIamPolicy
  
• Tipo di log di controllo: Attività di amministrazione
  
• Autorizzazioni:
  • cloudkms.cryptoKeys.setIamPolicy - ADMIN_WRITE
  • cloudkms.keyRings.setIamPolicy - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="SetIamPolicy"
  

google.longrunning.Operations

La sezione seguente contiene i dettagli sugli audit log associati a metodi appartenenti a google.longrunning.Operations.

GetOperation

• Metodo: GetOperation
  
• Tipo di log di controllo: Accesso ai dati
  
• Autorizzazioni:
  • cloudkms.keyHandles.create - ADMIN_WRITE
  • cloudkms.operations.get - ADMIN_READ
• Il metodo è un'operazione a lunga esecuzione o in modalità flusso: N.
  
• Filtra per questo metodo: protoPayload.methodName="GetOperation"
  

Metodi che non producono audit log

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

• Si tratta di un metodo ad alto volume che implica la generazione e l'archiviazione di log significativi costi aggiuntivi.
• Ha un valore di controllo basso.
• La copertura dei metodi è già fornita da un altro log di controllo o di piattaforma.

I seguenti metodi non producono audit log:

• google.cloud.kms.v1.KeyManagementService.GenerateRandomBytes
• google.cloud.location.Locations.GetLocation
• google.cloud.location.Locations.ListLocations