Python Client for Google Cloud KMS
Project description
This is a shared codebase for gcloud-rest-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.rest.kms import KMS
from gcloud.rest.kms import decode
from gcloud.rest.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-rest-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-rest-kms-4.0.0.tar.gz
(4.2 kB
view hashes)
Built Distribution
Close
Hashes for gcloud_rest_kms-4.0.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e7d6ea9b82e5f88d741d705649d9c5252cd15d9eaabe3c34eb1c4e5f0fc03770 |
|
MD5 | caf0c5ea2aa4f8741e4958f174ffe41a |
|
BLAKE2b-256 | 8a6f1912e080b5f69ba1d24001715293792405c88abc75568a467d55694fde98 |