About Cloud KMS
What is Cloud KMS? What can it do?
Cloud KMS is a cloud-hosted key management service that lets you manage encryption for your cloud services the same way you do on-premises. You can generate, use, rotate, and destroy cryptographic keys. Cloud KMS is integrated with Cloud Identity and Access Management and Cloud Audit Logging so you can manage permissions on individual keys, and monitor how they are used.
Can I store secrets?
Is there an SLA?
Yes, see Cloud KMS Service Level Agreement.
How do I provide product feedback?
Contact the engineering team at email@example.com.
How do I provide documentation feedback?
While viewing Cloud KMS documentation, click Send feedback near the top right of the page. This will open a feedback form.
If I need help, what are my options?
We invite our users to post their questions on Stack Overflow. Along with the active Stack Overflow community, our team actively monitors Stack Overflow posts and answers questions with the tag google-cloud-kms.
We also offer various levels of support depending on your needs. For additional support options, see our Cloud Platform Support Packages.
Does Cloud KMS have any quotas?
Yes, Cloud KMS has quotas for the following:
Read requests: The number of key, key ring, and key version read requests per minute.
Write requests: The number of key, key ring, and key version write requests per minute.
Cryptographic requests: The number of encryption and decryption requests per minute.
How do I find out how much quota I am using, or have remaining?
You can view your current project quota in the Cloud KMS Quotas page of the Google Cloud Platform Console.
How do I request more quota?
Is there a limit on the number of keys or other Cloud KMS resources I can have?
No. There is no limit on keys, key rings, or key versions, including keys per key ring and key versions per key.
In what countries can I use Cloud KMS?
You can use Cloud KMS in any country where Google Cloud Platform services are supported.
What kinds of key does Cloud KMS generate?
Are keys HSM-backed?
Keys with protection level
HSM are backed by a hardware security module
(HSM), while keys with protection level
SOFTWARE are not backed by an HSM.
How is key material generated?
Cloud KMS software-protected keys are generated using Google’s common cryptographic library using a random number generator (RNG) built by Google. HSM-protected keys are generated securely by the HSM, which was validated to meet FIPS 140-2 L3.
Which library is used to generate key material?
Are keys constrained to a geographic location?
Keys belong to a region, but are not constrained to that region. For more information, see Cloud KMS locations.
Can I auto-delete keys?
Can I auto-rotate keys?
For keys with key purpose
ENCRYPT_DECRYPT, yes. See
Automatic rotation: Setting the rotation period for a key.
For keys with key purpose
ASYMMETRIC_DECRYPT, no. To
learn why, see Asymmetric key rotation.
Does key rotation re-encrypt data? If not, why?
Key rotation does not automatically re-encrypt data. When you decrypt data, Cloud KMS knows which key version to use for the decryption. As long as a key version is not disabled or destroyed, Cloud KMS will be able to use the key version for the decryption.
Why can't I delete keys or key rings?
To prevent resource name collisions, key ring and key resources CANNOT be deleted. Key versions also cannot be deleted, but key version material can be destroyed so that the resources can no longer be used. For more information, see Lifetime of objects.
Can I export keys?
No. Keys are not exportable from Cloud KMS by design. All encryption and decryption with these keys must be done within Cloud KMS. This helps prevent leaks and misuse, and enables Cloud KMS to emit an audit trail when keys are used.
Can I import keys?
No, you cannot import keys into Cloud KMS.
However, separately from Cloud KMS, the following products support Customer-Supplied Encryption Key (CSEK) functionality.
|Compute Engine||Encrypting Disks with Customer-Supplied Encryption Keys|
|Cloud Storage||Using Customer-Supplied Encryption Keys|
How long after I destroy a key version can I get it back?
After you schedule a key version for destruction, you have 24 hours before the key version is actually destroyed. During that time, if needed you can restore the key version.
Can I change the 24 hour period before a scheduled key is destroyed?
When I make changes to a key, how quickly do the changes take effect?
Some operations to Cloud KMS resources are strongly consistent, while others are eventually consistent and may take up to 3 hours to propagate. For more details, see Cloud KMS resource consistency.
Why is my key in PENDING_GENERATION state?
Due to the CPU cost of generating key material, creation of an asymmetric key version may take a few minutes. Key versions that are protected by a hardware security module (HSM) also take some time. When a newly created key version is ready, its state will automatically change to ENABLED.
Authorization and authentication
How do I authenticate to the Cloud KMS API?
How clients authenticate may vary a bit depending on the platform on which the code is running. For details, see Accessing the API.
What Cloud IAM roles should I use?
To enforce the principle of least privilege, ensure that the user and service accounts in your organization have only the permissions essential to performing their intended functions. For more information, see Separation of duties.
When I remove a Cloud IAM permission, how quickly is it removed?
Removal of a permission should be in effect in less than one hour.
What is additional authenticated data, and when would I use it?
Additional authenticated data (AAD) is any string that you pass to Cloud KMS as part of an encrypt or decrypt request. It is used as an integrity check and can help protect your data from a confused deputy attack. For more information, see Additional authenticated data.
Are data access logs on by default? How do I enable data access logs?
Data access logs are not on by default. To enable data access logs, see Enabling data access logs.
How do Cloud KMS keys relate to service account keys?
Service account keys are used for service-to-service authentication within GCP. Service account keys are unrelated to Cloud KMS keys.
How do Cloud KMS keys relate to API keys?
API keys are a simple encrypted string that can be used when calling certain APIs that don't need to access private user data and are used to track API requests associated with your project for quota and billing. API keys are unrelated to Cloud KMS keys.