Python Client for Google Cloud KMS
Project description
This is a shared codebase for gcloud-aio-kms and gcloud-rest-kms
Installation
$ pip install --upgrade gcloud-{aio,rest}-kms
Usage
We’re still working on more complete documentation, but roughly you can do:
from gcloud.aio.kms import KMS
from gcloud.aio.kms import decode
from gcloud.aio.kms import encode
kms = KMS('my-kms-project', 'my-keyring', 'my-key-name')
# encrypt
plaintext = 'the-best-animal-is-the-aardvark'
ciphertext = await kms.encrypt(encode(plaintext))
# decrypt
assert decode(await kms.decrypt(ciphertext)) == plaintext
# close the HTTP session
# Note that other options include:
# * providing your own session: `KMS(.., session=session)`
# * using a context manager: `async with KMS(..) as kms:`
await kms.close()
Emulators
For testing purposes, you may want to use gcloud-aio-kms along with a local emulator. Setting the $KMS_EMULATOR_HOST environment variable to the address of your emulator should be enough to do the trick.
Contributing
Please see our contributing guide.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
gcloud-aio-kms-3.3.0.tar.gz
(5.3 kB
view hashes)
Built Distribution
Close
Hashes for gcloud_aio_kms-3.3.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 75a25ca6d30cc6134fda3d4ab79f199ae62465add54477fad826c10676490889 |
|
MD5 | 90e661456b266ba646edc5e4392db266 |
|
BLAKE2b-256 | f7a134dcc8102514493ef59be13eb90f7b248207507648986c3a826857e93e99 |