Skip to content

Latest commit

 

History

History
 
 

snippets

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
README.md
README.md
 
 
check_state_import_job.py
check_state_import_job.py
 
 
check_state_imported_key.py
check_state_imported_key.py
 
 
create_import_job.py
create_import_job.py
 
 
create_key_asymmetric_decrypt.py
create_key_asymmetric_decrypt.py
 
 
create_key_asymmetric_sign.py
create_key_asymmetric_sign.py
 
 
create_key_for_import.py
create_key_for_import.py
 
 
create_key_hsm.py
create_key_hsm.py
 
 
create_key_labels.py
create_key_labels.py
 
 
create_key_mac.py
create_key_mac.py
 
 
create_key_ring.py
create_key_ring.py
 
 
create_key_rotation_schedule.py
create_key_rotation_schedule.py
 
 
create_key_symmetric_encrypt_decrypt.py
create_key_symmetric_encrypt_decrypt.py
 
 
create_key_version.py
create_key_version.py
 
 
decrypt_asymmetric.py
decrypt_asymmetric.py
 
 
decrypt_symmetric.py
decrypt_symmetric.py
 
 
destroy_key_version.py
destroy_key_version.py
 
 
disable_key_version.py
disable_key_version.py
 
 
enable_key_version.py
enable_key_version.py
 
 
encrypt_asymmetric.py
encrypt_asymmetric.py
 
 
encrypt_symmetric.py
encrypt_symmetric.py
 
 
generate_random_bytes.py
generate_random_bytes.py
 
 
get_key_labels.py
get_key_labels.py
 
 
get_key_version_attestation.py
get_key_version_attestation.py
 
 
get_public_key.py
get_public_key.py
 
 
get_public_key_jwk.py
get_public_key_jwk.py
 
 
iam_add_member.py
iam_add_member.py
 
 
iam_get_policy.py
iam_get_policy.py
 
 
iam_remove_member.py
iam_remove_member.py
 
 
import_manually_wrapped_key.py
import_manually_wrapped_key.py
 
 
noxfile_config.py
noxfile_config.py
 
 
quickstart.py
quickstart.py
 
 
requirements-test.txt
requirements-test.txt
 
 
requirements.txt
requirements.txt
 
 
restore_key_version.py
restore_key_version.py
 
 
sign_asymmetric.py
sign_asymmetric.py
 
 
sign_mac.py
sign_mac.py
 
 
snippets_test.py
snippets_test.py
 
 
update_key_add_rotation.py
update_key_add_rotation.py
 
 
update_key_remove_labels.py
update_key_remove_labels.py
 
 
update_key_remove_rotation.py
update_key_remove_rotation.py
 
 
update_key_set_primary.py
update_key_set_primary.py
 
 
update_key_update_labels.py
update_key_update_labels.py
 
 
verify_asymmetric_ec.py
verify_asymmetric_ec.py
 
 
verify_asymmetric_rsa.py
verify_asymmetric_rsa.py
 
 
verify_mac.py
verify_mac.py
 
 

README.md

Python Samples for Google Cloud Key Management Service

This directory contains samples for Google Cloud Key Management Service, which may be used as a reference for how to use this product. The Google Cloud KMS API is a service that allows you to keep encryption keys centrally in the cloud, for direct use by cloud services. More info about Cloud KMS can be found at https://cloud.google.com/kms/docs/ Samples, quickstarts, and other documentation are available at cloud.google.com.

Quickstart

This quickstart shows you how to create and use encryption keys with Cloud Key Management Service.

Open in Cloud Shell

To run this sample:

  1. If this is your first time working with GCP products, you will need to set up the Cloud SDK or utilize Google Cloud Shell. This sample may require authentication and you will need to enable billing.

  2. Make a fork of this repo and clone the branch locally, then navigate to the sample directory you want to use.

  3. Install the dependencies needed to run the samples.

     pip install -r requirements.txt

  4. Run the sample using

     python quickstart.py

More information about the Cloud KMS quickstart is available at https://cloud.google.com/kms/docs/quickstart

Test permissions

The service account running the tests needs to have the following roles:

  • roles/cloudkms.admin
  • roles/cloudkms.cryptoKeyEncrypterDecrypter
  • roles/cloudkms.cryptoOperator
  • roles/cloudkms.publicKeyViewer
  • roles/cloudkms.signerVerifier

Additional Information

These samples use the Google Cloud Client Library for Python. You can read the documentation for more details on API usage and use GitHub to browse the source and report issues.

Contributing

View the contributing guidelines, the Python style guide for more information.