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:

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