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 = b'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-4.0.0.tar.gz
(4.1 kB
view hashes)
Built Distribution
Close
Hashes for gcloud_aio_kms-4.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cee5e24eb20ac975a7db9f1f3db71f52d25d86a7dce4c51ab140f7edf552d164 |
|
MD5 | f903b65b9813d6b5c867871f168122da |
|
BLAKE2b-256 | caf90ac716a82ae27645a09204b1e8cedddf0ac699adf4f7f43859bec0a49aca |