Audit logging di Cloud Key Management Service

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

Campo di sostituzione consigliato	Campo deprecato	Descrizione
protoPayload.status.details	protoPayload.metadata	Dettagli dell'errore per EXTERNAL (ad es. Cloud EKM).
protoPayload.metadata.entries.caller_provided_context	protoPayload.request.caller_provided_context	Contesto dell'utente chiamante associato a questa operazione Cloud KMS.

Questo documento descrive la registrazione degli audit per Cloud Key Management Service. I servizi Google Cloud generano audit log che registrano le attività amministrative e di accesso all'interno delle risorse Google Cloud. Per ulteriori informazioni su Cloud Audit Logs, consulta quanto segue:

• Tipi di log di controllo
• Struttura voce di log di controllo
• Archiviazione e inoltro dei log di controllo
• Riepilogo dei prezzi di Cloud Logging
• Attivare 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 enum 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 log di controllo 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 log di controllo Accesso ai dati. I metodi che richiedono un'autorizzazione IAM con il valore della proprietà type ADMIN_WRITE generano log di controllo per le attività amministrative.

Tipo di autorizzazione	Metodi
ADMIN_READ	GetCryptoKey GetCryptoKeyVersion GetEkmConfig GetEkmConnection GetIamPolicy GetImportJob GetKeyRing GetOperation 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 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

I seguenti log di controllo sono 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 di streaming: 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 streaming: No.
  
• 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

I seguenti log di controllo sono 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

I seguenti log di controllo sono associati ai 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="VerifyConnectivity"
  

google.cloud.kms.v1.KeyManagementService

I seguenti log di controllo sono associati ai 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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.manageRawPKCS1Keys - ADMIN_WRITE
  • cloudkms.cryptoKeyVersions.update - ADMIN_WRITE
  • cloudkms.importJobs.useToImport - ADMIN_WRITE
• Il metodo è un'operazione a lunga esecuzione o in streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• 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 streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="UpdateCryptoKeyVersion"
  

google.iam.v1.IAMPolicy

I seguenti log di controllo sono 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 streaming: No.
  
• 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 streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="SetIamPolicy"
  

google.longrunning.Operations

I seguenti log di controllo sono associati ai 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 streaming: No.
  
• Filtra per questo metodo: protoPayload.methodName="GetOperation"
  

Metodi che non generano log di controllo

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 controllo basso.
• Un altro log di controllo o della piattaforma fornisce già la copertura del metodo.

I seguenti metodi non generano log di controllo:

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