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 = '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-3.3.1.tar.gz
(5.7 kB
view hashes)
Built Distribution
Close
Hashes for gcloud_rest_kms-3.3.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f5c33f09a6de58b9535ad83f1cedfb5c2dd403a01a691b373167f7d91a3a72d5 |
|
MD5 | 1060f31cb37c48a2f476b828b51e5f81 |
|
BLAKE2b-256 | d1c08fcea6cc3e5ba5eaa37b19f292b08027bb178b7f60d4367a2a1aa6a50471 |