summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDouglas Mendizabal <dougmendizabal@gmail.com>2013-09-04 16:40:09 -0500
committerDouglas Mendizabal <dougmendizabal@gmail.com>2013-09-04 16:40:09 -0500
commit5ec37db11ed0759b813c9312ff927489b413e75b (patch)
tree85aa086b3ac925fa6256477c832d5c7d0bd30fa6
parentdfa9eba7ae9dad58d55152286cd7431f1ddb4bfe (diff)
downloadpython-barbicanclient-5ec37db11ed0759b813c9312ff927489b413e75b.tar.gz
Update README.md
-rw-r--r--README.md36
1 files changed, 17 insertions, 19 deletions
diff --git a/README.md b/README.md
index 0be31c0..1e4c8a8 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@ Key Management API. There is a Python library for accessing the API
(`barbicanclient` module), and a command-line script (`keep`).
## barbicanclient - Python API
-The full api is documented in the wiki.
+The full api is [documented in the wiki](https://github.com/cloudkeep/python-barbicanclient/wiki/Client-Usage).
### Quickstart
Store a secret in barbican using keystone for authentication:
@@ -13,43 +13,42 @@ Store a secret in barbican using keystone for authentication:
>>> from barbicanclient.common import auth
>>> from barbicanclient import client
# We'll use keystone for authentication
->>> keystone = auth.KeystoneAuth(auth_url='http://keystone-int.cloudkeep.io:5000/v2.0',
-... username=USER, password=PASSWORD, tenant_name=TENANT)
+>>> keystone = auth.KeystoneAuthV2(auth_url='http://keystone-int.cloudkeep.io:5000/v2.0',
+... username='USER', password='PASSWORD', tenant_name='TENANT')
>>> barbican = client.Client(auth_plugin=keystone)
# Let's store some sensitive data, Barbican encrypts it and stores it securely in the cloud
->>> secret_id = barbican.secrets.store(name='Self destruction sequence',
-... payload='the magic words are squeamish ossifrage',
-... payload_content_type='text/plain')
+>>> secret_uri = barbican.secrets.store(name='Self destruction sequence',
+... payload='the magic words are squeamish ossifrage',
+... payload_content_type='text/plain')
# Let's look at some properties of a barbican Secret
->>> secret = barbican.secrets.get(secret_id)
->>> print(secret.id)
-d46883b4-e072-4452-98c9-36d652dfcdd6
+>>> secret = barbican.secrets.get(secret_uri)
+>>> print(secret.secret_ref)
+u'http://api-01-int.cloudkeep.io:9311/v1/test_tenant/secrets/49496a6d-c674-4384-b208-7cf4988f84ee'
>>> print(secret.name)
Self destruction sequence
# Now let's retrieve the secret payload. Barbican decrypts it and sends it back.
->>> print(barbican.secrets.raw(secret.id, secret.content_types['default']))
+>>> print(barbican.secrets.decrypt(secret.secret_ref))
the magic words are squeamish ossifrage
```
## keep - Command Line Client
-
+Command line client configuration and usage is [documented in the wiki](https://github.com/cloudkeep/python-barbicanclient/wiki/Command-Line-Client).
```
-$ keep -h
usage: keep [-h] [--no-auth | --os-auth-url <auth-url>]
[--os-username <auth-user-name>] [--os-password <auth-password>]
[--os-tenant-name <auth-tenant-name>] [--os-tenant-id <tenant-id>]
[--endpoint <barbican-url>]
- {order,secret} {create,store,get,list,delete} ...
+ <entity> <action> ...
Command-line interface to the Barbican API.
positional arguments:
- {order,secret} Entity used for command.
+ <entity> Entity used for command, e.g., order, secret.
optional arguments:
-h, --help show this help message and exit
- --no-auth, -N Do not use authentication
+ --no-auth, -N Do not use authentication.
--os-auth-url <auth-url>, -A <auth-url>
Defaults to env[OS_AUTH_URL].
--os-username <auth-user-name>, -U <auth-user-name>
@@ -66,11 +65,10 @@ optional arguments:
subcommands:
Action to perform
- {create,store,get,list,delete}
+ <action>
create Create a new order.
store Store a secret in barbican.
- get Retrieve a secret or an order by providing its UUID.
+ get Retrieve a secret or an order by providing its URI.
list List secrets or orders
- delete Delete a secret or an order by providing its UUID.
-
+ delete Delete a secret or an order by providing its href.
```